Getting the Java Version at Runtime

Last updated: April 20, 2024

[]

Written by: Hamid Reza Sharifi

[]

Reviewed by: Greg Martin

eBook – Java Streams – NPI EA (cat=Java Streams)

Partner – Moderne – NPI EA (cat=Spring Boot)

[announcement - icon]

Refactor Java code safely — and automatically — with OpenRewrite.

Refactoring big codebases by hand is slow, risky, and easy to put off. That’s where OpenRewrite comes in. The open-source framework for large-scale, automated code transformations helps teams modernize safely and consistently.

Each month, the creators and maintainers of OpenRewrite at Moderne run live, hands-on training sessions — one for newcomers and one for experienced users. You’ll see how recipes work, how to apply them across projects, and how to modernize code with confidence.

Join the next session, bring your questions, and learn how to automate the kind of work that usually eats your sprint time.

1. Overview

Sometimes when programming in Java, it may be helpful to programmatically find the version of Java that we’re using. In this tutorial, we’ll look at a few ways to get the Java version.

2. Java Version Naming Convention

Up until Java 9, the Java version did not follow the Semantic Versioning. The format was 1.X.Y_Z. X and Y indicate major and minor versions, respectively. Z is used to indicate an update release and separated by underscore “_”. For example, 1.8.0_181. For Java 9 and beyond, the Java version follows the Semantic Versioning. The Semantic Versioning uses the X.Y.Z format. It refers to major, minor, and patch. For example,11.0.7.

3. Getting Java Version

3.1. Using System.getProperty

A system property is a key-value pair that the Java runtime provides. The java.version is a system property that provides the Java version. Let’s define a method for getting the version:

public void givenJava_whenUsingSystemProp_thenGetVersion() {
    int expectedVersion = 8;
    String[] versionElements = System.getProperty("java.version").split("\\.");
    int discard = Integer.parseInt(versionElements[0]);
    int version;
    if (discard == 1) {
        version = Integer.parseInt(versionElements[1]);
    } else {
        version = discard;
    }
    Assertions.assertThat(version).isEqualTo(expectedVersion);
}

To support both Java version formats, we should check the first number until the dot.

3.2. Using Apache Commons Lang 3

A second approach for getting the Java version is via the Apache Commons Lang 3 library. We first need to add the commons-lang3 Maven dependency to our pom.xml file:

<dependency>
    <groupId>org.apache.commons</groupId>
    <artifactId>commons-lang3</artifactId>
    <version>3.12.0</version>
</dependency>

We’ll use the SystemUtils class to obtain information about the Java platform. Let’s define a method for this purpose:

public void givenJava_whenUsingCommonsLang_thenGetVersion() {
    int expectedVersion = 8;
    String[] versionElements = SystemUtils.JAVA_SPECIFICATION_VERSION.split("\\.");
    int discard = Integer.parseInt(versionElements[0]);
    int version;
    if (discard == 1) {
        version = Integer.parseInt(versionElements[1]);
    } else {
        version = discard;
    }
    Assertions.assertThat(version).isEqualTo(expectedVersion);
}

We are using the JAVA_SPECIFICATION_VERSION that is intended to mirror available values from the java.specification.version System property.

3.3. Using Runtime.version()

In Java 9 and above, we can use the Runtime.version() to get version information. Let’s define a method for this purpose:

public void givenJava_whenUsingRuntime_thenGetVersion(){
    String expectedVersion = "15";
    Runtime.Version runtimeVersion = Runtime.version();
    String version = String.valueOf(runtimeVersion.version().get(0));
    Assertions.assertThat(version).isEqualTo(expectedVersion);
}

4. Conclusion

In this article, we describe a few ways to obtain the Java version.

The code backing this article is available on GitHub. Once you're logged in as a Baeldung Pro Member, start learning and coding on the project.

eBook – Java Streams – NPI EA (cat=Java Streams)

Partner – Moderne – NPI EA (tag=Refactoring)

[announcement - icon]

Modern Java teams move fast — but codebases don’t always keep up. Frameworks change, dependencies drift, and tech debt builds until it starts to drag on delivery. OpenRewrite was built to fix that: an open-source refactoring engine that automates repetitive code changes while keeping developer intent intact.

The monthly training series, led by the creators and maintainers of OpenRewrite at Moderne, walks through real-world migrations and modernization patterns. Whether you’re new to recipes or ready to write your own, you’ll learn practical ways to refactor safely and at scale.

If you’ve ever wished refactoring felt as natural — and as fast — as writing code, this is a good place to start.

Getting the Java Version at Runtime

1. Overview

2. Java Version Naming Convention

3. Getting Java Version

3.1. Using System.getProperty

3.2. Using Apache Commons Lang 3

3.3. Using Runtime.version()

4. Conclusion

Courses

Series

About

REST with Spring Boot

Learn Spring Security

Learn Spring

Learn Spring Data JPA

View All Spring Courses

Learn JUnit

Learn Maven

Learn Hibernate JPA

Learn Mockito

View All Courses

Full Archive

Baeldung Ebooks

About Baeldung

Getting the Java Version at Runtime

1. Overview

2. Java Version Naming Convention

3. Getting Java Version

3.1. Using System.getProperty

3.2. Using Apache Commons Lang 3

3.3. Using Runtime.version()

4. Conclusion

Courses

Series

About