/*
* Copyright 2015-2019 the original author or authors.
*
* All rights reserved. This program and the accompanying materials are
* made available under the terms of the Eclipse Public License v2.0 which
* accompanies this distribution and is available at
*
* http://www.eclipse.org/legal/epl-v20.html
*/
package org.junit.jupiter.api.condition;
import static org.apiguardian.api.API.Status.STABLE;
import java.lang.reflect.Method;
import org.apiguardian.api.API;
import org.junit.platform.commons.logging.Logger;
import org.junit.platform.commons.logging.LoggerFactory;
import org.junit.platform.commons.util.ReflectionUtils;
import org.junit.platform.commons.util.StringUtils;
Enumeration of Java Runtime Environment (JRE) versions.
If the current JRE version cannot be detected — for example, if the java.version
JVM system property is undefined — then none of the constants defined in this enum will be considered to be the current JRE version.
See Also: Since: 5.1
/**
* Enumeration of Java Runtime Environment (JRE) versions.
*
* <p>If the current JRE version cannot be detected — for example, if the
* {@code java.version} JVM system property is undefined — then none of
* the constants defined in this enum will be considered to be the
* {@linkplain #isCurrentVersion current JRE version}.
*
* @since 5.1
* @see #JAVA_8
* @see #JAVA_9
* @see #JAVA_10
* @see #JAVA_11
* @see #JAVA_12
* @see #JAVA_13
* @see #OTHER
* @see EnabledOnJre
* @see DisabledOnJre
*/
@API(status = STABLE, since = "5.1")
public enum JRE {
Java 8.
/**
* Java 8.
*/
JAVA_8,
Java 9.
/**
* Java 9.
*/
JAVA_9,
Java 10.
/**
* Java 10.
*/
JAVA_10,
Java 11.
/**
* Java 11.
*/
JAVA_11,
Java 12.
Since: 5.4
/**
* Java 12.
*
* @since 5.4
*/
@API(status = STABLE, since = "5.4")
JAVA_12,
Java 13.
Since: 5.4
/**
* Java 13.
*
* @since 5.4
*/
@API(status = STABLE, since = "5.4")
JAVA_13,
/**
* A JRE version other than {@link #JAVA_8}, {@link #JAVA_9},
* {@link #JAVA_10}, {@link #JAVA_11}, {@link #JAVA_12}, or
* {@link #JAVA_13}.
*/
OTHER;
private static final Logger logger = LoggerFactory.getLogger(JRE.class);
private static final JRE CURRENT_VERSION = determineCurrentVersion();
private static JRE determineCurrentVersion() {
String javaVersion = System.getProperty("java.version");
boolean javaVersionIsBlank = StringUtils.isBlank(javaVersion);
if (javaVersionIsBlank) {
logger.debug(
() -> "JVM system property 'java.version' is undefined. It is therefore not possible to detect Java 8.");
}
if (!javaVersionIsBlank && javaVersion.startsWith("1.8")) {
return JAVA_8;
}
try {
// java.lang.Runtime.version() is a static method available on Java 9+
// that returns an instance of java.lang.Runtime.Version which has the
// following method: public int major()
Method versionMethod = Runtime.class.getMethod("version");
Object version = ReflectionUtils.invokeMethod(versionMethod, null);
Method majorMethod = version.getClass().getMethod("major");
int major = (int) ReflectionUtils.invokeMethod(majorMethod, version);
switch (major) {
case 9:
return JAVA_9;
case 10:
return JAVA_10;
case 11:
return JAVA_11;
case 12:
return JAVA_12;
case 13:
return JAVA_13;
default:
return OTHER;
}
}
catch (Exception ex) {
logger.debug(ex, () -> "Failed to determine the current JRE version via java.lang.Runtime.Version.");
}
// null signals that the current JRE version is "unknown"
return null;
}
Returns: true
if this JRE
is known to be the Java Runtime Environment version for the currently executing JVM
/**
* @return {@code true} if <em>this</em> {@code JRE} is known to be the
* Java Runtime Environment version for the currently executing JVM
*/
public boolean isCurrentVersion() {
return this == CURRENT_VERSION;
}
}