|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectcom.android.sdklib.repository.FullRevision
public class FullRevision
Package multi-part revision number composed of a tuple (major.minor.micro) and an optional preview revision (the lack of a preview number indicates it's not a preview but a final package.)
MajorRevision
Nested Class Summary | |
---|---|
static class |
FullRevision.PreviewComparison
Indicates how to compare the preview field in compareTo(FullRevision, PreviewComparison) |
Field Summary | |
---|---|
protected static java.lang.String |
DEFAULT_SEPARATOR
|
static int |
IMPLICIT_MICRO_REV
|
static int |
IMPLICIT_MINOR_REV
|
static int |
MISSING_MAJOR_REV
|
static int |
NOT_A_PREVIEW
|
static FullRevision |
NOT_SPECIFIED
|
protected static int |
PRECISION_MAJOR
Only major revision specified: 1 term |
protected static int |
PRECISION_MICRO
Major, minor and micro revisions specified: 3 terms (x.y.z) |
protected static int |
PRECISION_MINOR
Only major and minor revisions specified: 2 terms (x.y) |
protected static int |
PRECISION_PREVIEW
Major, minor, micro and preview revisions specified: 4 terms (x.y.z-rcN) |
Constructor Summary | |
---|---|
FullRevision(int major)
|
|
FullRevision(int major,
int minor,
int micro)
|
|
FullRevision(int major,
int minor,
int micro,
int preview)
|
|
FullRevision(int major,
int minor,
int micro,
int preview,
java.lang.String previewSeparator)
|
Method Summary | |
---|---|
int |
compareTo(FullRevision rhs)
Trivial comparison of a version, e.g 17.1.2 < 18.0.0. |
int |
compareTo(FullRevision rhs,
FullRevision.PreviewComparison comparePreview)
Trivial comparison of a version, e.g 17.1.2 < 18.0.0. |
boolean |
equals(java.lang.Object rhs)
|
int |
getMajor()
|
int |
getMicro()
|
int |
getMinor()
|
int |
getPreview()
|
protected java.lang.String |
getSeparator()
|
int |
hashCode()
|
boolean |
isPreview()
|
static FullRevision |
parseRevision(java.lang.String revision)
Parses a string of format "major.minor.micro rcPreview" and returns a new FullRevision for it. |
protected static FullRevision |
parseRevisionImpl(java.lang.String revision,
boolean supportMinorMicro,
boolean supportPreview,
boolean keepPrecision)
|
int[] |
toIntArray(boolean includePreview)
Returns the version number as an integer array, in the form [major, minor, micro] or [major, minor, micro, preview]. |
java.lang.String |
toShortString()
Returns the version in a dynamic format "major.minor.micro rc#". |
java.lang.String |
toString()
Returns the version in a fixed format major.minor.micro with an optional "rc preview#". |
Methods inherited from class java.lang.Object |
---|
clone, finalize, getClass, notify, notifyAll, wait, wait, wait |
Field Detail |
---|
public static final int MISSING_MAJOR_REV
public static final int IMPLICIT_MINOR_REV
public static final int IMPLICIT_MICRO_REV
public static final int NOT_A_PREVIEW
protected static final int PRECISION_MAJOR
protected static final int PRECISION_MINOR
protected static final int PRECISION_MICRO
protected static final int PRECISION_PREVIEW
public static final FullRevision NOT_SPECIFIED
protected static final java.lang.String DEFAULT_SEPARATOR
Constructor Detail |
---|
public FullRevision(int major)
public FullRevision(int major, int minor, int micro)
public FullRevision(int major, int minor, int micro, int preview)
public FullRevision(int major, int minor, int micro, int preview, @NonNull java.lang.String previewSeparator)
Method Detail |
---|
public int getMajor()
public int getMinor()
public int getMicro()
@NonNull protected java.lang.String getSeparator()
public boolean isPreview()
public int getPreview()
@NonNull public static FullRevision parseRevision(@NonNull java.lang.String revision) throws java.lang.NumberFormatException
FullRevision
for it. All the fields except major are
optional.
The parsing is equivalent to the pseudo-BNF/regexp:
Major/Minor/Micro/Preview := [0-9]+ Revision := Major ('.' Minor ('.' Micro)? )? \s* ('rc'Preview)?
revision
- A non-null revision to parse.
FullRevision
.
java.lang.NumberFormatException
- if the parsing failed.@NonNull protected static FullRevision parseRevisionImpl(@NonNull java.lang.String revision, boolean supportMinorMicro, boolean supportPreview, boolean keepPrecision) throws java.lang.NumberFormatException
java.lang.NumberFormatException
public java.lang.String toString()
toString
in class java.lang.Object
public java.lang.String toShortString()
toString()
except it omits minor, micro
or preview versions when they are zero.
For example it would return "18 rc1" instead of "18.0.0 rc1",
or "18.1 rc2" instead of "18.1.0 rc2".
public int[] toIntArray(boolean includePreview)
org.apache.tools.ant.util.DeweyDecimal
using a
FullRevision
.
includePreview
- If true the output will contain 4 fields
to include the preview number (even if 0.) If false the output
will contain only 3 fields (major, minor and micro.)
public int hashCode()
hashCode
in class java.lang.Object
public boolean equals(java.lang.Object rhs)
equals
in class java.lang.Object
public int compareTo(FullRevision rhs)
compareTo
in interface java.lang.Comparable<FullRevision>
rhs
- The right-hand side FullRevision
to compare with.
public int compareTo(FullRevision rhs, FullRevision.PreviewComparison comparePreview)
rhs
- The right-hand side FullRevision
to compare with.comparePreview
- How to compare the preview value.
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |