org.mdiutil.lang

Class JREVersionDetector

java.lang.Object

org.mdiutil.lang.JREVersionDetector

public class JREVersionDetector
extends Object

This class allows to get the version of a JRE at a specified location, or check that this version is at least equal to a specified version, or between two specified versions. The version is identical to the String returned if calling System.getProperty("java.version") on the JRE at the specified location. Note that the location is the location of the JRE. The class will find by itself the path of the corresponding Java executable, depending on the platform.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	JREVersionDetector.JREConfig Represents the configuration of the JRE.

Field Summary

Fields

Modifier and Type	Field and Description
static short	ARCH_32BIT The type for 32 bits architectures.
static short	ARCH_64BIT The type for 64 bits architectures.
static short	ARCH_ALL The type for all architectures.

Constructor Summary

Constructors

Constructor and Description
JREVersionDetector() Constructor, with a default timeOut of 200 ms.
JREVersionDetector(long timeOut) Constructor.

Method Summary

Modifier and Type	Method and Description
static long	getDefaultTimeOut() Return the default timeOut.
JREVersionDetector.JREConfig	getJREConfiguration(File jvmLocation) Return the version and the architecture of the JRE at a specified location.
int	getMajorVersion(File jvmLocation) Return the major version of a JRE at a specified location.
int	getMajorVersion(File jvmLocation, short arch) Return the major version of a JRE at a specified location.
long	getTimeOut() Return the timeOut.
String	getVersion(File jvmLocation) Return the version of the JRE at a specified location.
boolean	isAtLeastVersion(File jvmLocation, String version) Return true if the version of the JRE at a specified location is at least equal to the specified version.
boolean	isAtLeastVersion(File jvmLocation, String version, short arch) Return true if the version of the JRE at a specified location is at least equal to the specified version.
boolean	isBetweenVersions(File jvmLocation, String atLeastVersion, String atMostVersion) Return true if the version of the JRE at a specified location is between the atLeastVersion and atMostVersion.
boolean	isBetweenVersions(File jvmLocation, String atLeastVersion, String atMostVersion, boolean strict) Return true if the version of the JRE at a specified location is between the atLeastVersion and atMostVersion.
boolean	isBetweenVersions(File jvmLocation, String atLeastVersion, String atMostVersion, short arch) Return true if the version of the JRE at a specified location is between the atLeastVersion and atMostVersion.
boolean	isBetweenVersions(File jvmLocation, String atLeastVersion, String atMostVersion, short arch, boolean strict) Return true if the version of the JRE at a specified location is between the atLeastVersion and atMostVersion.
static void	setDefaultTimeOut(long timeOut) Set the default timeOut.
void	setTimeOut(long timeOut) Set the timeOut.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

ARCH_ALL

public static final short ARCH_ALL

The type for all architectures.

See Also:

Constant Field Values

ARCH_32BIT

public static final short ARCH_32BIT

The type for 32 bits architectures.

See Also:

Constant Field Values

ARCH_64BIT

public static final short ARCH_64BIT

The type for 64 bits architectures.

See Also:

Constant Field Values

Constructor Detail

JREVersionDetector

public JREVersionDetector()

Constructor, with a default timeOut of 200 ms.

JREVersionDetector

public JREVersionDetector(long timeOut)

Constructor.

Parameters:

timeOut - the timeOut in ms

Method Detail

setDefaultTimeOut

public static void setDefaultTimeOut(long timeOut)

Set the default timeOut.

Parameters:

timeOut - the timeOut in ms

getDefaultTimeOut

public static long getDefaultTimeOut()

Return the default timeOut.

Returns:

the default timeOut in ms

setTimeOut

public void setTimeOut(long timeOut)

Set the timeOut.

Parameters:

timeOut - the timeOut in ms

getTimeOut

public long getTimeOut()

Return the timeOut.

Returns:

the timeOut in ms

getJREConfiguration

public JREVersionDetector.JREConfig getJREConfiguration(File jvmLocation)

Return the version and the architecture of the JRE at a specified location. The version is identical to the String returned if calling System.getProperty("java.version") on the JRE at the specified location.

Parameters:

jvmLocation - the JRE location

Returns:

the JRE configuration

getVersion

public String getVersion(File jvmLocation)

Return the version of the JRE at a specified location. The version is identical to the String returned if calling System.getProperty("java.version") on the JRE at the specified location.

Parameters:

jvmLocation - the JRE location

Returns:

the version

getMajorVersion

public int getMajorVersion(File jvmLocation)

Return the major version of a JRE at a specified location.

Parameters:

jvmLocation - the JRE location

Returns:

the major version

getMajorVersion

public int getMajorVersion(File jvmLocation,
                           short arch)

Return the major version of a JRE at a specified location. If the JRE is not found, return -1.

Parameters:

jvmLocation - the JRE location

arch - the architecture

Returns:

the major version

isAtLeastVersion

public boolean isAtLeastVersion(File jvmLocation,
                                String version)

Return true if the version of the JRE at a specified location is at least equal to the specified version. See SystemUtils.isAtLeastVersion(java.lang.String, java.lang.String).

Parameters:

jvmLocation - the JRE location

version - the specified Java version

Returns:

true if the version of the JRE at a specified location is at least equal to the specified version

isAtLeastVersion

public boolean isAtLeastVersion(File jvmLocation,
                                String version,
                                short arch)

Return true if the version of the JRE at a specified location is at least equal to the specified version. See SystemUtils.isAtLeastVersion(java.lang.String, java.lang.String). Note: the architecture argument can have one of the following values:

• ARCH_32BIT: for a 32 bit architecture
• ARCH_64BIT: for a 64 bit architecture
• ARCH_ALL: for any architecture

Parameters:

jvmLocation - the JRE location

version - the specified Java version

arch - the architecture

Returns:

true if the version of the JRE at a specified location is at least equal to the specified version

isBetweenVersions

public boolean isBetweenVersions(File jvmLocation,
                                 String atLeastVersion,
                                 String atMostVersion)

Return true if the version of the JRE at a specified location is between the atLeastVersion and atMostVersion. The comparison includes the versions themselves. See SystemUtils.isBetweenVersions(java.lang.String, java.lang.String, java.lang.String).

Parameters:

jvmLocation - the JRE location

atLeastVersion - the specified at least Java version

atMostVersion - the specified at most Java version

Returns:

true if the current Java version is between the atLeastVersion and atMostVersion

isBetweenVersions

public boolean isBetweenVersions(File jvmLocation,
                                 String atLeastVersion,
                                 String atMostVersion,
                                 boolean strict)

Return true if the version of the JRE at a specified location is between the atLeastVersion and atMostVersion. The comparison includes the versions themselves is the strict parameter is false. See SystemUtils.isBetweenVersions(java.lang.String, java.lang.String, java.lang.String, boolean).

Parameters:

jvmLocation - the JRE location

atLeastVersion - the specified at least Java version

atMostVersion - the specified at most Java version

strict - true if the at most Java version is excluded

Returns:

true if the current Java version is between the atLeastVersion and atMostVersion

isBetweenVersions

public boolean isBetweenVersions(File jvmLocation,
                                 String atLeastVersion,
                                 String atMostVersion,
                                 short arch)

Return true if the version of the JRE at a specified location is between the atLeastVersion and atMostVersion. The comparison includes the versions themselves is the strict parameter is false. See SystemUtils.isBetweenVersions(java.lang.String, java.lang.String, java.lang.String, boolean). Note: the architecture argument can have one of the following values:

• ARCH_32BIT: for a 32 bit architecture
• ARCH_64BIT: for a 64 bit architecture
• ARCH_ALL: for any architecture

Parameters:

jvmLocation - the JRE location

atLeastVersion - the specified at least Java version

atMostVersion - the specified at most Java version

arch - the architecture

Returns:

true if the current Java version is between the atLeastVersion and atMostVersion

isBetweenVersions

public boolean isBetweenVersions(File jvmLocation,
                                 String atLeastVersion,
                                 String atMostVersion,
                                 short arch,
                                 boolean strict)

Return true if the version of the JRE at a specified location is between the atLeastVersion and atMostVersion. The comparison includes the versions themselves is the strict parameter is false. See SystemUtils.isBetweenVersions(java.lang.String, java.lang.String, java.lang.String, boolean). Note: the architecture argument can have one of the following values:

• ARCH_32BIT: for a 32 bit architecture
• ARCH_64BIT: for a 64 bit architecture
• ARCH_ALL: for any architecture

Parameters:

jvmLocation - the JRE location

atLeastVersion - the specified at least Java version

atMostVersion - the specified at most Java version

arch - the architecture

strict - true if the at most Java version is excluded

Returns:

true if the current Java version is between the atLeastVersion and atMostVersion