A guide to Java versions and features
Tags: java, openjdk, jdk, adoptopenjdk
Published: 2019-11-15 10:06:26

You can use this guide to get practical information on how to find and install the latest Java, understand the differences between Java distributions (AdoptOpenJdk, OpenJDK, OracleJDK etc.), as well as get an overview of Java language features, including version Java versions 8-13.

## Practical Information

First, let’s have a look at some common, practical questions that people have when trying to choose the right Java version for their project.

### TL;DR I only want a download link and know about everything else. Where should I go?

Go to the [AdoptOpenJDK](https://adoptopenjdk.net) site, chose the latest Java version, download and install it. Then come back to this guide to maybe still learn a thing or two about Java versions.

### What Java version should I use?

As of September 2019, [Java 13](https://openjdk.java.net/projects/jdk/13/) is the latest released Java version, with newer versions following every 6 months. Hence Java 14 is scheduled for March 2020, Java 15 for September 2020 and so on. In the past, Java release cycles were *much longer*, up to 3-5 years!.


![Java Version Timeline](https://www.marcobehler.com/images/javaversions.png "Java Version Timeline")

With that many new versions coming out, there’s basically these real-world(™) usage scenarios:

-   Legacy projects in companies are often stuck with using Java 8 (see [Why are companies still stuck with Java 8?](#_why_are_companies_still_stuck_with_java_8)) . Hence you will be forced to use Java 8 as well.

-   Some legacy projects are even stuck on Java 1.5 (released 2004) or 1.6 (released 2006) - sorry, pals!

-   If you are making sure to use the very latest IDEs, frameworks and build tools and starting a greenfield project, you can, without hesitation, use Java 11 (LTS) or even the latest Java 13.

-   There’s the special field of Android development, where the Java version is basically stuck at Java 7, with a [specific set of Java 8 features](https://developer.android.com/studio/write/java8-support) available. Or you switch to using the Kotlin programming language.

### Why are companies still stuck with Java 8?

There’s a mix of different reasons companies are still stuck with Java 8. To name a few:

-   Build tools (Maven, Gradle etc.) and some libraries *initially* had bugs with versions Java versions &gt; 8 and needed updates. Even today, with e.g. Java &gt;=9, certain build tools print out ["reflective access"-warnings](https://issues.apache.org/jira/browse/GROOVY-8339) when building Java projects, which simply "feels not ready", even though the builds are fine.

-   Up until Java 8 you were pretty much using Oracle’s JDK builds and you did not have to care about licensing. Oracle changed the [licensing scheme In 2019](https://www.oracle.com/technetwork/java/javase/overview/oracle-jdk-faqs.html), though, which led the internet go crazy with a ton of articles saying "Java is not free anymore" - and a fair amount of confusion followed. This is however not really an issue, which you’ll learn about in the [Java Distributions](#_java_distributions) section of this guide.

-   Some companies have policies to only use LTS versions and rely on their OS vendors to provide them these builds, which takes time.

To sum up: you have a mix of practical issues (upgrading your tools, libraries, frameworks) and political issues.

### Why are some Java versions, like 8 also called 1.8?

Java versions before 9 simply had a different naming scheme. So, Java 8 can also be called *1.8*, Java 5 can be called *1.5* etc. When you issued the 'java -version' command, with these versions you got output like this:

```console
    c:\Program Files\Java\jdk1.8.0_191\bin>java -version
    java version "1.8.0_191" 
    Java(TM) SE Runtime Environment (build 1.8.0_191-b12)
    Java HotSpot(TM) 64-Bit Server VM (build 25.191-b12, mixed mode)
```

Which simply means Java 8. With the switch to time-based releases with Java 9 the naming scheme also changed, and Java versions aren’t prefixed with 1.x anymore. Now the version number looks like this:

```console
    c:\Program Files\Java\jdk11\bin>java -version
    openjdk version "11" 2018-09-25 
    OpenJDK Runtime Environment 18.9 (build 11+28)
    OpenJDK 64-Bit Server VM 18.9 (build 11+28, mixed mode)
```

### What is the difference between the Java versions? Should I learn a specific one?

Coming from other programming languages with major breakages between releases, like say Python 2 to 3, you might be wondering if the same applies to Java.

Java is special in this regard, as it is *extremely* backwards compatible. This means that your Java 5 or 8 program is guaranteed to run with a Java 8-13 virtual machine - with a few exceptions you don’t need to worry about for now.

It obviously does not work the other way around, say your program relies on Java 13 features, that are simply not available under a Java 8 JVM.

This means a couple of things:

-   You do not just "learn" a specific Java version, like 12.

-   Rather, you’ll get a good foundation in all language features up until Java 8. This serves as a good base.

-   And then learn, from a guide like this, what *additional features* came in Java 9-13 and use them whenever you can.

### What are examples of these new features between Java versions?

Have a look at the [Java Features 8-13](#_java_features_8_13) section.

But as a rule of thumb: The older, longer release-cycles (3-5 years, up until Java 8) meant a lot of new features per release.

The 6-month release cycle means a lot less features, per release, so you can catch up quickly on Java 9-13 language features.

### What is the difference between a JRE and a JDK?

Up until now, we have only been talking about "Java". But what is Java exactly?

First, you need to differentiate between a *JRE* (Java Runtime Environment) and a *JDK* (Java Development Kit).

Historically, you downloaded just a *JRE* if you were only interested in running Java programs. A JRE includes, among other things, the Java Virtual Machine (JVM) and the "java" command line tool.

To develop new Java programs, you needed to download a *JDK*. A JDK includes *everything* the JRE has, as well as the compiler *javac* and a couple of other tools like *javadoc* (Java documentation generator) and *jdb* (Java Debugger).

Now why am I talking in past tense?

Up until Java 8, the Oracle website offered JREs and JDKs as separate downloads - even though the JDK also always included a JRE in a separate folder. With Java 9 that distinction was basically gone, and you are *always* downloading a JDK. The directory structure of JDKs also changed, with not having an explicit JRE folder anymore.

So, even though some distributions (see [Java Distributions](#_java_distributions) section) still offer a separate JRE download, there seems to be the trend of offering just a JDK. Hence, we are going to use *Java* and *JDK* interchangeably from now on.

### How do I install Java or a JDK then?

Ignore the Java-Docker images, .msi wrappers or platform-specific packages for the moment. In the end, Java is just a .zip file, nothing more, nothing less.

Therefore, all you need to do to install Java onto your machine, is to unzip your jdk-{5-13}.zip file. You don’t even need administrator rights for that.

Your unzipped Java file will look like this:

```console
    Directory C:\dev\jdk-11

    12.11.2019  19:24    <DIR>          .
    12.11.2019  19:24    <DIR>          ..
    12.11.2019  19:23    <DIR>          bin
    12.11.2019  19:23    <DIR>          conf
    12.11.2019  19:24    <DIR>          include
    12.11.2019  19:24    <DIR>          jmods
    22.08.2018  19:18    <DIR>          legal
    12.11.2019  19:24    <DIR>          lib
    12.11.2019  19:23             1.238 release
```

The magic happens in the /bin directory, which under Windows looks like this:

```console
    Directory C:\dev\jdk-11\bin
    ...
    12.11.2019  19:23           272.736 java.exe
    ...
    12.11.2019  19:23            20.832 javac.exe
    ...
```

So all you need to do is unzip that file and put the /bin directory in your PATH variable, so you can call the 'java' command from anywhere.

(In case you are wondering, GUI installers like the one from Oracle or AdoptOpenJDK will do the unzipping and modifying the PATH variable for you, that’s about it.)

To verify you installed Java correctly, you can then simply run 'java -version'. If the output looks like the one below, you are good to go.

```console
    openjdk version "11" 2018-09-25
    OpenJDK Runtime Environment 18.9 (build 11+28)
    OpenJDK 64-Bit Server VM 18.9 (build 11+28, mixed mode)
```

Now there’s one question left: Where do you get that Java .zip file from? Which brings us to the topic of distributions.

## Java Distributions

There’s a variety of sites offering Java (read: JDK) downloads and it is unclear "who offers what and with which licensing". This section will shed some light on this.

### The OpenJDK project

In terms of Java source code (read: the source code for your JRE/JDK), there is *only one*, living at the [OpenJDK project](http://openjdk.java.net/projects/jdk/) site.

This is just source code however, not a distributable build (think: your .zip file with the compiled java command for your specific operating system). In theory, you and I could produce a build from that source code, call it, say, *MarcoJDK* and start distributing it. But our distribution would lack certification, to be able to legally call ourselves *Java SE compatible*.

That’s why in practice, there’s a handful of vendors that actually create these builds, get them certified (see [TCK](https://en.wikipedia.org/wiki/Technology_Compatibility_Kit)) and then distribute them.

And while vendors cannot, say, remove a method from the String class before producing a new Java build, they can add branding (yay!) or add some other (e.g. CLI) utilities they deem useful. But other than that, the original source code is *the same* for *all* Java distributions.

### OpenJDK builds (by Oracle) and OracleJDK builds

One of the vendors who builds Java from source is Oracle. This leads to *two different Java distributions*, which can be very confusing at first.

1.  [OpenJDK builds](http://jdk.java.net) by Oracle(!). These builds are free and unbranded, but Oracle won’t release updates for older versions, say Java 13, as soon as Java 14 comes out.

2.  [OracleJDK](https://www.oracle.com/technetwork/java/javase/downloads/index.html), which is a branded, commercial build starting with the license change in 2019. Which means it can be used for free during development, but you need to pay Oracle if using it in production. For this, you get longer support, i.e. updates to versions and a telephone number you can call if your JVM goes crazy.

Now, historically (pre-Java 8) there were actual source differences between OpenJDK builds and OracleJDK builds, where you could say that OracleJDK was 'better'. But as of today, both versions are essentially the same, with [minor differences](https://blogs.oracle.com/java-platform-group/oracle-jdk-releases-for-java-11-and-later).

It then boils down to you wanting paid, commercial support (a telephone number) for your installed Java version.

### AdoptOpenJDK

In 2017, a group of Java User Group members, developers and vendors (Amazon, Microsoft, Pivotal, Redhat and others) started a community, called [AdoptOpenJDK](https://adoptopenjdk.net/).

They provide free, rock-solid OpenJDK builds with [longer availibility/updates](https://adoptopenjdk.net/support.html) and even offer you the choice of two different Java virtual machines: [HotSpot](https://en.wikipedia.org/wiki/HotSpot) and [OpenJ9](https://en.wikipedia.org/wiki/OpenJ9).

**Highly recommended** if you are looking to install Java.

### Azul Zulu, Amazon Corretto, SAPMachine

You will find a complete list of OpenJDK builds at the [OpenJDK Wikipedia](https://en.wikipedia.org/wiki/OpenJDK) site. Among them are [Azul Zulu](https://www.azul.com/products/zulu-community/), [Amazon Corretto](https://aws.amazon.com/de/corretto/) as well as [SapMachine](https://sap.github.io/SapMachine/), to name a few. To oversimplify it boils down to you having different support options/maintenance guarantees.

But make sure to check out the individual websites to learn about the advantages of each single distribution.

### Recommendation

To re-iterate from the beginning, in 2019, unless you have very specific requirements, go get your jdk.zip (.tar.gz/.msi/.pkg) file from <https://adoptopenjdk.net> or choose a package provided by your OS-vendor.

## Java Features 8-13

As mentioned at the very beginning of this guide: Essentially *all* (don’t be picky now) Java 8 language features also work in Java 13. The same goes for all other Java versions in between.

Which in turns means that all language features from Java 8 serve as very good Java base knowledge and everything else (Java 9-13) is pretty much additional features *on top* of that baseline.

Here’s a quick overview of what the specific versions have to offer:

### - Java 8 -

Java 8 was a massive release and you can find a list of all features at [the Oracle website](https://www.oracle.com/technetwork/java/javase/8-whats-new-2157071.html). There’s two main feature sets I’d like to mention here, though:

#### Language Features: Lambdas etc.

Before Java 8, whenever you wanted to instantiate, for example, a new Runnable, you had to write an anonymous inner class like so:

```java
     Runnable runnable = new Runnable(){
           @Override
           public void run(){
             System.out.println("Hello world !");
           }
         };
```

With lambdas, the same code looks like this:

```java
    Runnable runnable = () -> System.out.println("Hello world two!");
```

You also got method references, repeating annotations, default methods for interfaces and a few other language features.

#### Collections & Streams

In Java 8 you also got functional-style operations for collections, also known as the Stream API. A quick example:

```java
    List<String> list = Arrays.asList("franz", "ferdinand", "fiel", "vom", "pferd");
```

Now pre-Java 8 you basically had to write for-loops to do something with that list.

With the Streams API, you can do the following:

```java
    list.stream()
        .filter(name -> name.startsWith("f"))
        .map(String::toUpperCase)
        .sorted()
        .forEach(System.out::println);
```

#### If you want more Java 8 practice

Obviously, I can only give a quick overview of each newly added Stream, Lambda or Optional method in Java 8 in the scope of this guide.

If you want a more detailed, thorough overview - including exercises - you can have a look at my [Java 8 core features](https://www.marcobehler.com/courses/32-core-java-features-version-8-12?utm_campaign=java_features_guide&utm_medium=java_features_guide&utm_source=java_features_guide) course.

### - Java 9 -

Java 9 also was a fairly big release, with a couple of additions:

#### Collections

Collections got a couple of new helper methods, to easily construct Lists, Sets and Maps.

```java
    List<String> list = List.of("one", "two", "three");
    Set<String> set = Set.of("one", "two", "three");
    Map<String, String> map = Map.of("foo", "one", "bar", "two");
```

#### Streams

Streams got a couple of additions, in the form of takeWhile,dropWhile,iterate methods.

```java
    Stream<String> stream = Stream.iterate("", s -> s + "s")
      .takeWhile(s -> s.length() < 10);
```

#### Optionals

Optionals got the sorely missed ifPresentOrElse method.

```java
    user.ifPresentOrElse(this::displayAccount, this::displayLogin);
```

#### Interfaces

Interfaces got private methods:

```java
    public interface MyInterface {

        private static void myPrivateMethod(){
            System.out.println("Yay, I am private!");
        }
    }
```

#### Other Language Features

And a couple of other improvements, like an improved try-with-resources statement or diamond operator extensions.

#### JShell

Finally, Java got a shell where you can try out simple commands and get immediate results.

```console
    % jshell
    |  Welcome to JShell -- Version 9
    |  For an introduction type: /help intro

    jshell> int x = 10
    x ==> 10
```

#### HTTPClient

Java 9 brought the initial preview version of a new HttpClient. Up until then, Java’s built-in Http support was rather low-level, and you had to fall back on using third-party libraries like Apache HttpClient or OkHttp (which are great libraries, btw!).

With Java 9, Java got its own, modern client - although in preview mode, which means subject to change in later Java versions.

#### Project Jigsaw: Java Modules and Multi-Release Jar Files

Java 9 got the [Jigsaw Module System](https://www.oracle.com/corporate/features/understanding-java-9-modules.html), which somewhat resembles the good old [OSGI specification](https://en.wikipedia.org/wiki/OSGi). It is not in the scope of this guide to go into full detail on Jigsaw, but have a look at the previous links to learn more.

Multi-Release .jar files made it possible to have one .jar file which contains different classes for different JVM versions. So your program can behave differently/have different classes used when run on Java 8 vs. Java 10, for example.

#### If you want more Java 9 practice

Again, this is just a quick overview of Java 9 features and if you want more thorough explanations and exercises, have a look at the [Java 9 core features](https://www.marcobehler.com/courses/32-core-java-features-version-8-12?utm_campaign=java_features_guide&utm_medium=java_features_guide&utm_source=java_features_guide) course.

### - Java 10 -

There have been a few changes to Java 10, like Garbage Collection etc. But the only real change you as a developer will likely see is the introduction of the "var"-keyword, also called local-variable type inference.

#### Local-Variable Type Inference: var-keyword

```java
    // Pre-Java 10

    String myName = "Marco";

    // With Java 10

    var myName = "Marco"
```

Feels Javascript-y, doesn’t it? It is still strongly typed, though, and only applies to variables *inside methods* (thanks, [dpash](https://www.reddit.com/user/dpash), for pointing that out again).

### - Java 11 -

Java 11 was also a somewhat smaller release, from a developer perspective.

#### Strings & Files

Strings and Files got a couple new methods (not all listed here):

```java
    "Marco".isBlank();
    "Mar\nco".lines();
    "Marco  ".strip();

    Path path = Files.writeString(Files.createTempFile("helloworld", ".txt"), "Hi, my name is!");
    String s = Files.readString(path);
```

#### Run Source Files

Starting with Java 10, you can run Java source files *without* having to compile them first. A step towards scripting.

```console
    ubuntu@DESKTOP-168M0IF:~$ java MyScript.java
```

#### Local-Variable Type Inference (var) for lambda parameters

The header says it all:

```java
    (var firstName, var lastName) -> firstName + lastName
```

#### HttpClient

The HttpClient from Java 9 in its final, non-preview version.

#### Other stuff

Flight Recorder, No-Op Garbage Collector, Nashorn-Javascript-Engine deprecated etc.

### - Java 12 -

Java 12 got a couple [new features and clean-ups](https://www.oracle.com/technetwork/java/javase/12-relnote-issues-5211422.html), but the only ones worth mentioning here are Unicode 11 support and a preview of the new switch expression, which you will see covered in the next section.

### - Java 13 -

You can find a complete feature list [here](https://www.oracle.com/technetwork/java/13-relnote-issues-5460548.html), but essentially you are getting Unicode 12.1 support, as well as two new or improved preview features (subject to change in the future):

#### Switch Expression (Preview)

Switch expressions can now return a value. And you can use a lambda-style syntax for your expressions, without the fall-through/break issues:

Old switch statements looked like this:

```java
    switch(status) {
      case SUBSCRIBER:
        // code block
        break;
      case FREE_TRIAL:
        // code block
        break;
      default:
        // code block
    }
```

Whereas with Java 13, switch statements can look like this:

```java
    boolean result = switch (status) {
        case SUBSCRIBER -> true;
        case FREE_TRIAL -> false;
        default -> throw new IllegalArgumentException("something is murky!");
    };
```

#### Multiline Strings (Preview)

You can *finally* do this in Java:

```java
    String htmlBeforeJava13 = "<html>\n" +
                  "    <body>\n" +
                  "        <p>Hello, world</p>\n" +
                  "    </body>\n" +
                  "</html>\n";

    String htmlWithJava13 = """
                  <html>
                      <body>
                          <p>Hello, world</p>
                      </body>
                  </html>
                  """;
```

### Java 14 and later

Will be covered here, as soon as they are getting released. Check back soon.

## Fin

By now you should have a pretty good overview of a couple things:

-   How to install Java, which version to get and where to get it from (hint: [AdoptOpenJDK](https://adoptopenjdk.net/)).

-   What a Java distribution is, which ones exist and what the differences are.

-   What the differences between the specific Java versions are.

Feedback, corrections and random input is always welcome! Simply leave a comment down below.

Thanks for reading.

## Acknowledgements

Stephen Colebourne, who wrote a [fantastic article](https://blog.joda.org/2018/09/time-to-look-beyond-oracles-jdk.html?showComment=1536303755275#c5934330550793525320) on the different, available Java distributions.

## There's more where that came from

I'll send you an update when I publish new guides. Absolutely no spam, ever. Unsubscribe anytime. Register for the newsletter here: https://bit.ly/2K0Ao4F .