Creating and Editing a Deployment Descriptor

Deployment descriptors are configuration files that are associated with projects and are deployed with J2EE applications. The deployment descriptors a project requires depends on the technologies the project uses, and on the type of the target application server. Deployment descriptors are XML files that can be created and edited as source files, but for most descriptor types JDeveloper provides dialogs that can be used to inspect and set properties.

Warning: Avoid creating any deployment descriptors that apply to EAR files for more than one project in an application or workspace. These files are assigned to projects, but have workspace scope. If multiple projects in an application or workspace have the same deployment descriptor, the one belonging to the launched project will supersede the others. This restriction applies to application.xml, data-sources.xml, jazn-data.xml, and orion-application.xml .

To create a deployment descriptor:

In the Applications Navigator, select the project for which you want to create a descriptor.
Choose File | New to open the New Gallery.
In the Categories tree, expand General and select Deployment Profiles. In the Items list, select a profile type.

If the desired item is not found, make sure the correct project is selected, and choose All Technologies in the Filter By dropdown list.

If the desired item is not enabled, check to make sure the project does not already have a descriptor of that type: a project may have only one one instance of a descriptor.
Click OK.
The descriptor will be created and added to the project, and it will be opened in an XML editor window.

To inspect or change deployment descriptor properties:

In the Applications Navigator, select the deployment descriptor.
Right-click and choose Properties.

(If the context menu does not have a Propert ies item, then the descriptor must be edited as a source file. Choose Open to open the profile in an XML editor window.)
Select items in the the left pane open dialog pages in the right pane. Configure the descriptor by setting property values in the pages of the dialog.

For instructions for any page, click Help .

Click OK when you are done.

To edit a deployment descriptor as an XML file:

In the Applications Navigator, select the deployment descriptor.
Right-click and choose Open.

The file will open in an XML editor.