Eclipse Java Development User Guide
Previous Page	Home	Next Page

Java development user guide Reference Wizards and Dialogs Create New Elements

New Java Project Wizard

The Opens the New Java Project wizard New Java Project wizard helps you create a new Java project in the workbench.

Project name page

Option	Description	Default
Project name	Type a name for the new project.	<blank>
Contents	Create new project in workspace: When selected, the New Project Wizard will create a new project with the specified name in the workspace. Create project from existing source: When selected, you can specify the location from which the New Java Project Wizard will retrieve an existing Java project. In this case the wizard will analyze the existing project and set up the build path automatically. Click on Browse... to browse for a location of an existing Java project.	workspace
JRE	Use default JRE: When selected, the New Java Project Wizard creates a new Java project which uses the workspace default JRE. The default JRE can be configured on the Java > Installed JREs preference page. The project will also use the default compiler compliance which can be configured on the Java > Compiler preference page. Click on Configure default... to configure the default JRE and compiler compliance. Use project specific JRE: When selected, you can explicitly specify the JRE to be used for the new Java project. The new project will use a compiler compliance which matches the version of the selected JRE. Use an execution environment JRE: When selected, you can specify an execution environment to be used for the new Java project. The new project will use a compiler compliance which fits best the selected execution environment. Execution environments can be configured on the Java > Installed JREs > Execution Environments preference page.	Use default JRE
Project layout	Use project folder as root for sources and class files: When selected, the project folder is used both as source folder and as output folder for class files. Create separate folders for sources and class files: When selected, the New Java Project Wizard creates a source folder for Java source files and an output folder which holds the class files of the project.	Create separate folders for sources and class files
Working sets	Add project to working sets: When selected, the new project will be added to the working sets shown in Working Sets drop down field. The drop down field shows a list of previous selected working sets. Click on Select... to select working sets to which to add the new project.	Depends on the context from which the wizard has been started

Java Build Path page

You can skip this page by pressing Finish on the first page. Otherwise press Next to configure the Java build path.

The Java build path consist of source, library and project entries. The user interface is the same as for the Build Path property page, except for the source 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 acived 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.

The tree shows the project as it will look like when switching to the package explorer. Several operations can be executed on this tree to change the structure of the project.

Icon	Option	Description
	Add source folder	Add a folder to the Java build path as source folder.
	Link additional source to project	Add a link to a folder in the file system as source folder to the Java build path.
	Remove from buildpath	Remove a source folder from the Java build path and change it into a normal folder.
	Exclude	Add a resource to the exclusion filter of it's parent source folder. The excluded resource and all its children are no longer visible to the compiler.
	Include	Includes a previously excluded resource.
	Configure source folder properties	The edit source folder property menu has two actions Configure Inclusion / Exclusions Filters: Customize the inclusion and exclusion filters by defining string patterns. It is possible to use wildcard in patters (i.e. to exclude all java files which start with "Test" write "Test.java"). Configure Output Folder: Change the output folder for a source folder. This action is only enabled if Allow output folders for source folders* is enabled.
	Undo all changes	All changes that have been applied to the project in this wizard will be withdrawn and the original state of the project is reconstructed.
	Allow output folders for source folders	If enabled, each source folder can have its own output folder. Otherwise all source folders will use the default output folder.

A shorter description of all operations is visible in the Details pane below the project tree.

Library tab, Project tab and Order Tab

See Build Path property page for more details.

Related concepts

Java projects

Related reference

File actions