Enum Class JRE

java.lang.Object

java.lang.Enum<JRE>

org.junit.jupiter.api.condition.JRE

All Implemented Interfaces:

Serializable, Comparable<JRE>, Constable

@API(status=STABLE,
     since="5.1")
public enum JRE
extends Enum<JRE>

Enumeration of Java Runtime Environment (JRE) versions.

If the current JRE version can be detected but is not one of the predefined constants in this enum, OTHER will be considered to be the current JRE version.

Since:

5.1

See Also:

• JAVA_8
• JAVA_9
• JAVA_10
• JAVA_11
• JAVA_12
• JAVA_13
• JAVA_14
• JAVA_15
• JAVA_16
• JAVA_17
• JAVA_18
• JAVA_19
• JAVA_20
• JAVA_21
• JAVA_22
• JAVA_23
• JAVA_24
• JAVA_25
• JAVA_26
• JAVA_27
• OTHER
• EnabledOnJre
• DisabledOnJre
• EnabledForJreRange
• DisabledForJreRange

Nested Class Summary

Nested classes/interfaces inherited from class Enum

Enum.EnumDesc<E>

Enum Constant Summary

Enum Constants

Enum Constant	Description
JAVA_10	Deprecated, for removal: This API element is subject to removal in a future version. No longer supported at runtime; please use JAVA_17 or later
JAVA_11	Deprecated, for removal: This API element is subject to removal in a future version. No longer supported at runtime; please use JAVA_17 or later
JAVA_12	Deprecated, for removal: This API element is subject to removal in a future version. No longer supported at runtime; please use JAVA_17 or later
JAVA_13	Deprecated, for removal: This API element is subject to removal in a future version. No longer supported at runtime; please use JAVA_17 or later
JAVA_14	Deprecated, for removal: This API element is subject to removal in a future version. No longer supported at runtime; please use JAVA_17 or later
JAVA_15	Deprecated, for removal: This API element is subject to removal in a future version. No longer supported at runtime; please use JAVA_17 or later
JAVA_16	Deprecated, for removal: This API element is subject to removal in a future version. No longer supported at runtime; please use JAVA_17 or later
JAVA_17	Java 17.
JAVA_18	Java 18.
JAVA_19	Java 19.
JAVA_20	Java 20.
JAVA_21	Java 21.
JAVA_22	Java 22.
JAVA_23	Java 23.
JAVA_24	Java 24.
JAVA_25	Java 25.
JAVA_26	Java 26.
JAVA_27	Java 27.
JAVA_8	Deprecated, for removal: This API element is subject to removal in a future version. No longer supported at runtime; please use JAVA_17 or later
JAVA_9	Deprecated, for removal: This API element is subject to removal in a future version. No longer supported at runtime; please use JAVA_17 or later
OTHER	A JRE version other than JAVA_8, JAVA_9, JAVA_10, JAVA_11, JAVA_12, JAVA_13, JAVA_14, JAVA_15, JAVA_16, JAVA_17, JAVA_18, JAVA_19, JAVA_20, JAVA_21, JAVA_22, JAVA_23, JAVA_24, JAVA_25, JAVA_26, or JAVA_27.
UNDEFINED	An undefined JRE version.

Method Summary

Modifier and Type	Method	Description
static JRE	currentJre()	Returns the JRE for the currently executing JVM, potentially OTHER.
static JRE	currentVersion()	Deprecated. in favor of currentJre()
static int	currentVersionNumber()	Returns the version number for the currently executing JVM, or -1 if the current JVM version could not be determined.
boolean	isCurrentVersion()	Returns true if this JRE is known to be the Java Runtime Environment version for the currently executing JVM or if the version is OTHER.
static boolean	isCurrentVersion(int version)	Determine if the supplied version number is considered to be the current JRE version.
static JRE	valueOf(String name)	Returns the enum constant of this class with the specified name.
static JRE[]	values()	Returns an array containing the constants of this enum class, in the order they are declared.
int	version()	Get the version of this JRE.

Methods inherited from class Enum

clone, compareTo, describeConstable, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Details

UNDEFINED

@API(status=MAINTAINED,
     since="5.13.3")
public static final JRE UNDEFINED

An undefined JRE version.

This constant is used by JUnit as a default configuration value but is not intended to be used by users.

This constant returns -1 for its version.

Since:

5.12

JAVA_8

@API(status=DEPRECATED,
     since="6.0")
@Deprecated(since="6.0",
            forRemoval=true)
public static final JRE JAVA_8

Deprecated, for removal: This API element is subject to removal in a future version.

No longer supported at runtime; please use JAVA_17 or later

Java 8.

JAVA_9

@API(status=DEPRECATED,
     since="6.0")
@Deprecated(since="6.0",
            forRemoval=true)
public static final JRE JAVA_9

Deprecated, for removal: This API element is subject to removal in a future version.

No longer supported at runtime; please use JAVA_17 or later

Java 9.

JAVA_10

@API(status=DEPRECATED,
     since="6.0")
@Deprecated(since="6.0",
            forRemoval=true)
public static final JRE JAVA_10

Deprecated, for removal: This API element is subject to removal in a future version.

No longer supported at runtime; please use JAVA_17 or later

Java 10.

JAVA_11

@API(status=DEPRECATED,
     since="6.0")
@Deprecated(since="6.0",
            forRemoval=true)
public static final JRE JAVA_11

Deprecated, for removal: This API element is subject to removal in a future version.

No longer supported at runtime; please use JAVA_17 or later

Java 11.

JAVA_12

@API(status=DEPRECATED,
     since="6.0")
@Deprecated(since="6.0",
            forRemoval=true)
public static final JRE JAVA_12

Deprecated, for removal: This API element is subject to removal in a future version.

No longer supported at runtime; please use JAVA_17 or later

Java 12.

Since:

5.4

JAVA_13

@API(status=DEPRECATED,
     since="6.0")
@Deprecated(since="6.0",
            forRemoval=true)
public static final JRE JAVA_13

Deprecated, for removal: This API element is subject to removal in a future version.

No longer supported at runtime; please use JAVA_17 or later

Java 13.

Since:

5.4

JAVA_14

@API(status=DEPRECATED,
     since="6.0")
@Deprecated(since="6.0",
            forRemoval=true)
public static final JRE JAVA_14

Deprecated, for removal: This API element is subject to removal in a future version.

No longer supported at runtime; please use JAVA_17 or later

Java 14.

Since:

5.5

JAVA_15

@API(status=DEPRECATED,
     since="6.0")
@Deprecated(since="6.0",
            forRemoval=true)
public static final JRE JAVA_15

Deprecated, for removal: This API element is subject to removal in a future version.

No longer supported at runtime; please use JAVA_17 or later

Java 15.

Since:

5.6

JAVA_16

@API(status=DEPRECATED,
     since="6.0")
@Deprecated(since="6.0",
            forRemoval=true)
public static final JRE JAVA_16

Deprecated, for removal: This API element is subject to removal in a future version.

No longer supported at runtime; please use JAVA_17 or later

Java 16.

Since:

5.7

JAVA_17

@API(status=STABLE,
     since="5.7.1")
public static final JRE JAVA_17

Java 17.

Since:

5.7.1

JAVA_18

@API(status=STABLE,
     since="5.8.1")
public static final JRE JAVA_18

Java 18.

Since:

5.8.1

JAVA_19

@API(status=STABLE,
     since="5.9")
public static final JRE JAVA_19

Java 19.

Since:

5.9

JAVA_20

@API(status=STABLE,
     since="5.9")
public static final JRE JAVA_20

Java 20.

Since:

5.9

JAVA_21

@API(status=STABLE,
     since="5.9.2")
public static final JRE JAVA_21

Java 21.

Since:

5.9.2

JAVA_22

@API(status=STABLE,
     since="5.10")
public static final JRE JAVA_22

Java 22.

Since:

5.10

JAVA_23

@API(status=STABLE,
     since="5.11")
public static final JRE JAVA_23

Java 23.

Since:

5.11

JAVA_24

@API(status=STABLE,
     since="5.11")
public static final JRE JAVA_24

Java 24.

Since:

5.11

JAVA_25

@API(status=STABLE,
     since="5.11.4")
public static final JRE JAVA_25

Java 25.

Since:

5.11.4

JAVA_26

@API(status=STABLE,
     since="5.13.2")
public static final JRE JAVA_26

Java 26.

Since:

5.13.2

JAVA_27

@API(status=STABLE,
     since="6.1")
public static final JRE JAVA_27

Java 27.

Since:

6.1

OTHER

public static final JRE OTHER

A JRE version other than JAVA_8, JAVA_9, JAVA_10, JAVA_11, JAVA_12, JAVA_13, JAVA_14, JAVA_15, JAVA_16, JAVA_17, JAVA_18, JAVA_19, JAVA_20, JAVA_21, JAVA_22, JAVA_23, JAVA_24, JAVA_25, JAVA_26, or JAVA_27.

This constant returns Integer.MAX_VALUE for its version. To retrieve the actual version number, use currentVersionNumber().

Method Details

values

public static JRE[] values()

Returns an array containing the constants of this enum class, in the order they are declared.

Returns:

an array containing the constants of this enum class, in the order they are declared

valueOf

public static JRE valueOf(String name)

Returns the enum constant of this class with the specified name. The string must match exactly an identifier used to declare an enum constant in this class. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum class has no constant with the specified name

NullPointerException - if the argument is null

version

@API(status=MAINTAINED,
     since="5.13.3")
public int version()

Get the version of this JRE.

If this JRE is UNDEFINED, this method returns -1. If this JRE is OTHER, this method returns Integer.MAX_VALUE.

Returns:

the version of this JRE

Since:

5.12

See Also:

• Runtime.Version.feature()
• currentVersionNumber()

isCurrentVersion

public boolean isCurrentVersion()

Returns true if this JRE is known to be the Java Runtime Environment version for the currently executing JVM or if the version is OTHER.

Returns:

true if this JRE is known to be the Java Runtime Environment version for the currently executing JVM or if the version is OTHER

See Also:

• currentJre()
• currentVersionNumber()

currentVersion

@API(status=DEPRECATED,
     since="5.12")
@Deprecated(since="5.12")
public static JRE currentVersion()

Deprecated.

in favor of currentJre()

Returns the JRE for the currently executing JVM, potentially OTHER.

Returns:

the JRE for the currently executing JVM, potentially OTHER

Since:

5.7

See Also:

• currentVersionNumber()

currentJre

@API(status=STABLE,
     since="5.12")
public static JRE currentJre()

Returns the JRE for the currently executing JVM, potentially OTHER.

Returns:

the JRE for the currently executing JVM, potentially OTHER

Since:

5.12

See Also:

• currentVersionNumber()

currentVersionNumber

@API(status=MAINTAINED,
     since="5.13.3")
public static int currentVersionNumber()

Returns the version number for the currently executing JVM, or -1 if the current JVM version could not be determined.

Returns:

the version number for the currently executing JVM, or -1 if the current JVM version could not be determined

Since:

5.12

See Also:

• Runtime.Version.feature()
• currentJre()

isCurrentVersion

@API(status=MAINTAINED,
     since="5.13.3")
public static boolean isCurrentVersion(int version)

Determine if the supplied version number is considered to be the current JRE version.

Returns true if either of the following is true.

• The supplied version number is known to be the Java Runtime Environment version for the currently executing JVM.
• The supplied version number is Integer.MAX_VALUE and the current JRE is OTHER.

Returns:

true if the supplied version number is considered to be the current JRE version

Since:

5.12

See Also:

• Runtime.Version.feature()
• isCurrentVersion()
• currentJre()