Overview of JDK 8 Support in NetBeans IDE

NetBeans IDE supports JDK 8 features, such as lambda expressions, repeatable annotations, compact profiles, etc. When these constructs are used in your code, the IDE recognizes them, correctly highlights errors, and lets you automatically fix syntax. Thus, NetBeans IDE helps you write code that is compatible with Java SE 8 Release Contents Early Draft Review Specification.

In this tutorial, you will learn how to get started with JDK 8 in NetBeans IDE and how to use the IDE support for such Java SE 8 features as compact profiles, lambda expressions, and repeating annotations.

Contents

• Enabling JDK 8 Support in NetBeans IDE
• Configuring a Project to use JDK 8
• Using Compact Profiles Support
• Using Lambda Expressions Support
• Using Repeating Annotations Support
• See Also

To complete this tutorial, you need the software and resources listed in the following table.

Software or Resource	Version Required
NetBeans IDE	version 7.4
Java Development Kit (JDK)	version 8

Enabling JDK 8 Support in NetBeans IDE

After JDK 8 is downloaded and installed on your system, it needs to be registered in the IDE as follows:

1. In the IDE, choose Tools > Java Platforms from the main menu.
2. Click Add Platform in the Java Platform Manager dialog.
3. In the Add Java Platform dialog, select Java Standard Edition and click Next.
4. Specify the directory that contains the JDK and click Next.

   

5. Verify that the default locations of the Platform Sources zip file and API documentation are valid. Click Finish to close the Add Java Platform dialog box.
   JDK 8 is registered as a platform in the IDE.

   

6. Ensure JDK 1.8 is chosen in the Platforms list and click Close.

Configuring a Project to use JDK 8

After you registered JDK 8 in the IDE, your project needs to be configured to use JDK 8 for compilation, running, and debugging.

We will start by creating a new Java SE project with the Anagram game example which is shipped with NetBeans IDE.

1. In the IDE, choose File > New Project.
2. In the New Project wizard, expand the Samples category and select Java.
3. Choose Anagram Game in the Projects list. Then click Next.
4. In the Name and Location panel, leave the default values for the Project Name and Project Location fields.
5. Click Finish.
   The IDE creates and opens the Java SE project in the Projects window.

To configure your project to use JDK 8:

1. Right-click the AnagramGame project in the Projects window and select Properties from the context menu.
2. In the Project Properties dialog box, choose the Libraries category and set JDK 1.8 as the Java Platform.

   

3. Select the Sources category and set Source/Binary Format to JDK 8.

   

4. Click OK to save the changes.
   Your project is set to recognize new JDK 8 language features.

Using Compact Profiles Support

Java SE 8 introduces subset profiles of the Java SE platform specification that can be used to deploy and run applications that do not require the entire platform.

Three profiles that have been defined so far are named compact1, compact2, and compact3. Each profile specifies a particular set of Java API packages and contains all of the APIs in profiles smaller than itself: compact1 is a subset of compact2, which is a subset of compact3, which in its turn is a subset of the full JRE. The table below lists packages that are comprised in each profile.

Compact1	Compact2	Compact3	Full JRE
java.lang java.io java.nio java.text java.math java.net javax.net java.util java.util.logging java.security javax.crypto javax.security	compact1 plus the following: java.sql javax.sql javax.xml org.w3c.dom org.xml.sax java.rmi javax.rmi javax.transaction	compact2 plus the following: java.lang.management javax.management javax.naming javax.sql.rowset javax.security.auth.kerberos org.ietf.jgss javax.script javax.xml.crypto java.util.prefs javax.security.sasl javax.security.acl java.lang.instrument javax.annotation.processing javax.lang.model javax.lang.model.element javax.lang.model.type javax.lang.model.util javax.tools	compact3 plus the following: corba awt swing

The IDE allows you to switch between the profiles and the full JRE when needed.

To set a project profile for a Java SE Project:

1. Right-cick a project and choose Properties from the context menu.
2. In the Project Properties dialog box, select the Sources category.
3. Use the Profile drop-down list to specify the JDK 8 profile that your application will support.

   

4. Click OK.

To see how the IDE checks whether classes used in your project belong to the specified profile, select Compact1 as a profile for the AnagramGame project and click OK.
The IDE displays errors to notify that the AnagramGame project is not compliant with the compact1 profile.

You can go back and set the AnagramGame project's profile to Full JRE which is supported by the Anagrams application.

Using Lambda Expressions Support

Lambda expressions address the bulkiness of anonymous inner classes by expressing the machinery of anonymous inner classes more compactly.

The general syntax of a lambda expression consists of a set of parameters, an arrow token, and a function body (either a single expression or a statement block):

(int a, int b) -> a * a + b * b;

NetBeans IDE detects pre-lambda expressions and displays the hints in the Editor proposing to turn such constructs into lambda expressions.

For example, the AnagramGame project features a pre-lambda construct in the Anagrams.java file as shown in the screenshot below.

After you click the light bulb in the margin or press Alt-Enter, the IDE shows the Use Lambda hint with a set of options available:

If the Use Lambda hint is selected, the IDE converts the anonymous inner class into a lambda expression.

If you choose the Run Inspect on option, the IDE displays the Inspect dialog box that allows to run a single Convert to Lambda inspection on the specified file.

Note: For more information on initiating the Inspect operation in the IDE, see Using Hints in Source Code Analysis and Refactoring in Developing Applications with NetBeans IDE.

After you press the Inspect button to launch the inspection, the IDE identifies all the pre-lambda constructs in the file and displays them in the Inspector window.

If you choose the Run Inspect&Transform on option, the IDE displays the Inspect and Transform dialog box that allows to run a single Convert to Lambda inspection (or a selected configuration) on the specified code and refactor it if needed.

Note: For more information on initiating the Inspect and Transform operation, see Using Hints in Source Code Analysis and Refactoring in Developing Applications with NetBeans IDE.

Using Repeating Annotations Support

Java SE 8 features include repeating annotations that enable you to apply annotations with the same type to a single program element, as shown in the following code example:

@ProjectServiceProvider(service=Foo.class,"org-nebeans-modules-j2seproject")
@ProjectServiceProvider(service=Foo.class,"org-nebeans-modules-j2eeproject")
public class MyService extends Foo {}
 

NetBeans IDE support for repeating annotations allows you to write code with the same annotations provided the repeatable and containing annotation types are declared:

• a repeatable annotation type must be marked with @Repeatable (), otherwise you get an error at compilation
• a containing annotation type must have a value element with an array type; the component type of the array type must be the repeatable annotation type

See Also

For more information about JDK 8, see:

• JDK 8 Project
• Java Platform Standard Edition 8 Early Access Documentation
• Java SE 8: Lambda Quick Start
• The Java Tutorials: Lambda Expressions
• The Java Tutorials: Repeating Annotations

For more information about developing Java applications in the NetBeans IDE, see:

• Creating Java Projects in Developing Applications with NetBeans IDE
• Developing General Java Applications
• Code Assistance in the NetBeans IDE Java Editor
• General Java Development Learning Trail