Returns this class file version indicating a class using preview features.

Returns:ClassFileVersion

This class file version but indicating the use of preview features.

Implements java.lang.Comparable.compareTo.

Doc from java.lang.Comparable.compareTo.

Compares this object with the specified object for order. Returns a negative integer, zero, or a positive integer as this object is less than, equal to, or greater than the specified object.

The implementor must ensure signum(x.compareTo(y)) == -signum(y.compareTo(x)) for all x and y. (This implies that x.compareTo(y) must throw an exception if and only if y.compareTo(x) throws an exception.)

The implementor must also ensure that the relation is transitive: (x.compareTo(y) > 0 && y.compareTo(z) > 0) implies x.compareTo(z) > 0.

Finally, the implementor must ensure that x.compareTo(y)==0 implies that signum(x.compareTo(z)) == signum(y.compareTo(z)), for all z.

Parameters

other:ClassFileVersion

the object to be compared.

Returns:int

a negative integer, zero, or a positive integer as this object is less than, equal to, or greater than the specified object.

Overrides java.lang.Object.equals.

Doc from java.lang.Object.equals.

Indicates whether some other object is "equal to" this one.

The equals method implements an equivalence relation on non-null object references:

• It is reflexive: for any non-null reference value x, x.equals(x) should return true.
• It is symmetric: for any non-null reference values x and y, x.equals(y) should return true if and only if y.equals(x) returns true.
• It is transitive: for any non-null reference values x, y, and z, if x.equals(y) returns true and y.equals(z) returns true, then x.equals(z) should return true.
• It is consistent: for any non-null reference values x and y, multiple invocations of x.equals(y) consistently return true or consistently return false, provided no information used in equals comparisons on the objects is modified.
• For any non-null reference value x, x.equals(null) should return false.

An equivalence relation partitions the elements it operates on into equivalence classes; all the members of an equivalence class are equal to each other. Members of an equivalence class are substitutable for each other, at least for some purposes.

Parameters

other:Object

the reference object with which to compare.

Returns:boolean

true if this object is the same as the obj argument; false otherwise.

Annotations

@Override

Returns the Java runtime version number of this class file version.

Returns:int

The Java runtime version.

Returns the major version this instance represents.

Returns:short

The major version this instance represents.

Returns the minor-major release number of this class file version.

Returns:int

The minor-major release number of this class file version.

Returns the minor version this instance represents.

Returns:short

The minor version this instance represents.

Overrides java.lang.Object.hashCode.

Doc from java.lang.Object.hashCode.

Returns a hash code value for the object. This method is supported for the benefit of hash tables such as those provided by java.util.HashMap.

The general contract of hashCode is:

• Whenever it is invoked on the same object more than once during an execution of a Java application, the hashCode method must consistently return the same integer, provided no information used in equals comparisons on the object is modified. This integer need not remain consistent from one execution of an application to another execution of the same application.
• If two objects are equal according to the equals method, then calling the hashCode method on each of the two objects must produce the same integer result.
• It is not required that if two objects are unequal according to the equals method, then calling the hashCode method on each of the two objects must produce distinct integer results. However, the programmer should be aware that producing distinct integer results for unequal objects may improve the performance of hash tables.

Returns:int

a hash code value for this object.

Annotations

@Override

Checks if this class file version is at least as new as the provided version.

Parameters

classFileVersion:ClassFileVersion

The version to check against.

Returns:boolean

true if this version is at least of the given version.

Checks if this class file version is at most as new as the provided version.

Parameters

classFileVersion:ClassFileVersion

The version to check against.

Returns:boolean

true if this version is as most as new as the provided version.

Checks if this class file version is newer than the provided version.

Parameters

classFileVersion:ClassFileVersion

The version to check against.

Returns:boolean

true if this version is newer than the provided version.

Checks if this class file version is older than the provided version.

Parameters

classFileVersion:ClassFileVersion

The version to check against.

Returns:boolean

true if this version is older than the provided version.

Returns true if this class file version indicates the use of preview features.

Returns:boolean

true if this class file version indicates the use of preview features.

Returns the latest officially supported Java version when experimental support is not enabled.

Returns:ClassFileVersion

The latest officially supported Java version.

Extracts a class' class version. The class' byte code is located by querying the ClassLoader of the class.

Parameters

type:Class<?>

The type for which to locate a class file version.

Returns:ClassFileVersion

The type's class file version.

Exceptions

IOException:

If an error occurs while reading the class file.

Extracts a class' class version.

Parameters

type:Class<?>

The type for which to locate a class file version.

classFileLocator:ClassFileLocator

The class file locator to query for a class file.

Returns:ClassFileVersion

The type's class file version.

Exceptions

IOException:

If an error occurs while reading the class file.

Extracts a class' class version.

Parameters

typeDescription:TypeDescription

The type for which to locate a class file version.

classFileLocator:ClassFileLocator

The class file locator to query for a class file.

Returns:ClassFileVersion

The type's class file version.

Exceptions

IOException:

If an error occurs while reading the class file.

Extracts a class' class version from a class file.

Parameters

binaryRepresentation:byte[]

The class file's binary representation.

Returns:ClassFileVersion

The supplied class file's class file version.

Creates a class file version for a given major release of Java. Currently, all versions reaching from Java 1 to Java 9 are supported.

Parameters

javaVersion:int

The Java version.

Returns:ClassFileVersion

A wrapper for the given Java class file version.

Returns the Java class file by its representation by a version string in accordance to the formats known to javac.

Parameters

javaVersionString:String

The Java version string.

Returns:ClassFileVersion

The appropriate class file version.

Creates a wrapper for a given minor-major release of the Java class file format.

Parameters

versionNumber:int

The minor-major release number.

Returns:ClassFileVersion

A representation of the version number.

Finds the highest class file version that is compatible to the current JVM version. Prior to Java 9, this is achieved by parsing the java.version property which is provided by java.lang.System#getProperty(String). If the system property is not available, an IllegalStateException is thrown.

Returns:ClassFileVersion

The currently running Java process's class file version.

Finds the highest class file version that is compatible to the current JVM version. Prior to Java 9, this is achieved by parsing the java.version property which is provided by java.lang.System#getProperty(String). If the system property is not available, the fallback version is returned.

Parameters

fallback:ClassFileVersion

The version to fallback to if locating a class file version is not possible.

Returns:ClassFileVersion

The currently running Java process's class file version or the fallback if locating this version is impossible.

Annotations

@SuppressFBWarnings:REC_CATCH_EXCEPTION

justification:Exception should not be rethrown but trigger a fallback.

Overrides java.lang.Object.toString.

Doc from java.lang.Object.toString.

Returns a string representation of the object.

Returns:String

a string representation of the object.

Annotations

@Override