Java Build Path

The options in this page indicate the build path settings for a Java project. You can reach this page through the project properties (Project > Properties > Java Build Path) from the context menu on a created project or the File menu of the workbench.

The build class path is a list of paths visible to the compiler when building the project.

For projects targeting Java 9 or greater, entries on the Projects and Libraries tabs can be placed either on the traditional Classpath or on the Modulepath. Entries on the Modulepath are interpreted as modules according to the Java Platform Module System. For these, further details can be edited via Modularity Details.

This property page consists of the following tabs:

• Source tab
• Projects tab
• Libraries tab
• Order and Export tab
• Module Dependencies tab

Source Tab

Source folders are top-level folders in the project hierarchy. They are the root of packages containing .java files. The compiler will translate the contained files to .class files that will be written to the output folder.

Source folders allow to structure the project, for example to separate test from the application in two source folders. Within a source folder, a more detailed structuring can be achieved by using packages.

Each source folder can define an exclusion filter to specify which resources inside the folder should not be visible to the compiler.

Resources existing in source folders are copied to the output folder unless the setting in the Java > Compiler > Building preference page specifies that the resource is filtered. The output folder is defined per project except if a source folder specifies its own output folder.

At the bottom of this page, the Default output folder field allows you to enter a path to a folder path where the compilation output for this project will reside. The default output is used for source folders that do not specify an own output folder. Use Browse to select an existing location from the current project.

Projects Tab

In the Required projects on the build path list, you can add project dependencies by selecting other workbench projects to add to the build path for this new project.

Adding a required project indirectly adds all its classpath entries marked as 'exported'. Setting a classpath entry as exported is done in the Order and Export tab.

The projects selected here are automatically added to the referenced projects list. The referenced project list is used to determine the build order. A project is always build after all its referenced projects are built.

Libraries Tab

On this page, you can add libraries to the build path.

By default, the library list contains an entry representing the Java runtime library. This entry points to the JRE selected as the default JRE. The default JRE is configured in the Java > Debug > Installed JREs preferences page.

 Libraries have the following attributes (presented as library entry children nodes):

Order and Export Tab

In the Build class path order list, you can click the Up and Down buttons to move the selected path entry up or down in the build path order for this new project.

Checked list entries are marked as exported. Exported entries are visible to projects that require the project. Use the Select All and Deselect All to change the checked state of all entries. Source folders are always exported, and can not be deselected.

Module Dependencies Tab

For projects targeting Java 9 or greater this page visualizes module-related aspects of all dependencies of the current project. At the left the All Modules list shows all modules that are considered when building the current projects. At the right Details of a selected module are shown, along with buttons to modify these details.

The All Modules list uses the following icon decorations to distinguish different kinds of modules:

Decorated Icon	Meaning
	The focus module, i.e., the module implemented by the current project. This module will always be shown at the top of the list, followed by other modules in alphabetical order.
	A system module, i.e., a module provided by the Java System Library.
	An automatic module, i.e., a module that is not declared using module-info.java, but inferred from information like the file name of a jar archive, or an attribute in MANIFEST.MF and the list of contained, non-empty packages.

Operations offered for the All Modules list:

• You may remove one or more System modules by selecting the respective modules and clicking the Remove button at the right. Note, that other modules need to be removed from the build path on the respective Projects or Libraries tab.
• If the current project lacks file module-info.java, i.e., types in the project are associated with the "unnamed module", then by default only a subset of System modules is considered. In this case you can pull in more System modules by clicking the Add System Module... button.

Modules that have just been added to the Modulepath on the corresponding tab of this page, will not be visible in this list immediately. In this case you need to click Apply to update the All Modules list.

The Details tree has two root nodes:

• under the top node Declared details of modulename you can find those details that are declared in the select module's description, namely representations of all requires, exports and opens declarations.
• under Configured details additional properties of the selected module can be configured.

The elements in this part of the page are marked with one of the following decorated icons:

Decorated Icon	Meaning
	A module which the selected module reads. This corresponds to a requires declaration.
	A package which the selected module exports to other modules, possibly qualified with a list of modules to which the package is exclusively exported. This corresponds to an exports or exports _ to declaration.
	A package which the selected module opens to other modules (for reflection), possibly qualified with a list of modules to which the package is exclusively opened. This corresponds to an opens or opens _ to declaration.
	A project (or source folder) that patches the selected module, i.e., all types in that project (or source folder) will be associated with, and compiled as part of the selected module.

Operations offered for the Details tree, provided that a module has been selected in the All Modules list:

• By clicking Read Module... you can create a new dependency from the select module to one or more other modules.
• By clicking Expose Package... you can define that the selected module exports or opens one of its packages. The dialog that opens when you click this button supports code completion for selecting a package and also has a field where a list of target modules can be specified.
• By double clicking an existing exports or opens node you can edit its details. The same can also be done by clicking the Edit... button.
• By clicking Patch with... you can select a project or source folder for patching the selected module.
• Any node under the Configured details node can be removed by clicking Remove
• Everything that has been configured in this tab can be translated into a set of command line options as specified by the Java Platform Module System (JPMS). To do so click the Show JPMS Options... button.
  These options could be used for invoking a compiler from the command line, or as runtime options when launching the program, to ensure that the JVM will see the same module graph that has been configured here.

Related Concepts

Related References