EAR Group Properties dialog box

This is a feature of JBuilder Enterprise.

The EAR Group Properties dialog box allows you to modify the attributes of an EAR group.

To display this dialog box, right-click an EAR group node in the project pane.

Build page

The Build page allows you to specify attributes about the JAR file that Making or Building the EJB module produces.

The Build page always contains an EAR page and a Resource page.

EJB page

Output EAR File

The name of the EAR file that is produced when you choose to Make or Build the EAR group.

Name

The name of the JAR file. JBuilder suggests a default name based on the name of the EJB module, but you can change it.

Path

The path where the JAR file is created.

Deployment Descriptors In Group

Lists the .xml deployment descriptor files that are in the EAR group.

Add button

Use Add to add an existing deployment descriptor into the list of files in the EAR group.

Copy button

Use Copy to copy the selected deployment descriptor to a new location.

Delete button

Use Delete to remove the selected deployment descriptor from the list of files in the EAR group.

Always Create EAR When Building The Project

By default, an EAR is always created during the build process. Uncheck this option if you want to defer creating an EAR.

Resource page

JBuilder copies all known resource types from the source path to the output path during the compile process. By default, JBuilder recognizes all images, sound, and properties files as resources and copies them to the output path. You can override these default resource definitions on individual files or by file extension project wide. See "Setting the output path" for more information on the output path.

Properties Resource

The top three radio buttons are file-specific options that control the currently selected file(s). These are the options:

The Copy and Do Not Copy options select an absolute behavior: always copy to the output path or never copy to the output path when the project is built, regardless of whether or not the file type is considered a resource.

The third option, Use File Extension Defaults, allows JBuilder to decide whether to deploy the file based on its file extension in the file list below. This is the default behavior for all newly created files and files in existing projects. The correct extensions for the selected files are automatically selected in the list to highlight the default behavior.

Important: If the selected files or extensions do not all share the same setting, none of the radio buttons in the corresponding group are selected. Selecting one of the radio buttons changes everything to the same value, while leaving none selected allows the differing values to be left alone.

If you have changed the defaults for individual files and you want to return them to JBuilder's defaults, select the files again and choose Use File Extension Defaults.

Project-wide defaults by extension

Below the three file-specific options is a list of all known file extensions and their default deployment behavior. These defaults can now be changed on a project-by-project basis. Select one or more extensions and use the radio buttons on the right to change the default behavior for these extensions in the current project. These options include:

Use the Reset button to return all files in the file extension list to the state they were in when the dialog box was displayed. Remember, this does not change your individual file settings to the default.



EJBs

This is a feature of JBuilder Enterprise.

Use this page to specify the EJB modules containing the enterprise beans and any other JAR files you want to include in this EAR file. For information about EJB modules, see "Creating enterprise beans with JBuilder."

EJB Modules

Click the EJB Modules tab and from the list of available EJB modules in your current project, check the check box next to those you want to include in the EAR file.

External JAR Files

To add JAR files for enterprise beans that aren't in an EJB module in the current project, click the External JAR Files tab, click the Add button, and navigate to the location of the EJB JAR files you want included. As you add JAR files, the list of External JAR Files grows.



Connectors

This is a feature of JBuilder Enterprise.

Use this page to specify the Resource Adapater Archive (RAR) files you want to include in this EAR file. For information about RAR files, see "About Resource Adapters" in Sun's J2EE Tutorial at http://java.sun.com/j2ee/tutorial/doc/Connector2.htm.

RAR Archive Nodes

Click the RAR Archive Nodes tab and from the list of available RAR archive nodes in your current project, check the check box next to those you want to include in the EAR file.

External RAR Files

To add external RAR files to the current project, click the External RAR Files, click the Add button and navigate to the location of the resource adapter archives you want included. As you add RAR files, the list of External RAR Files grows.



AppClients

This is a feature of JBuilder Enterprise.

Use this page to specify the J2EE application client JAR files you want to include in this EAR file.

JAR Archive Nodes

Click the JAR Archive Nodes tab and from the list of available JAR nodes for J2EE client applications in your current project, check the check box next to those you want to include in the EAR file.

External JAR Files

To add external J2EE client application JAR files to the current project, click the External JAR Files tab, click the Add button and navigate to the location of the JAR files you want included. As you add JAR files, the list of External JAR Files grows.



Web

This is a feature of JBuilder Enterprise.

Use this page to specify the WebApp nodes and any external Web Archive (WAR) files you want to include in this EAR file. For information about WebApps and WAR files, see "Working with WebApps and WAR files."

You must specify a different context name for each web module, whether the module is from a WebApp node or from an external WAR file. One blank context name is allowed. The blank web module becomes the default web context for the enterprise application.

WebApp Nodes

Click the WebApps Nodes tab and, from the list of available WebApp nodes in your current project, check the check box next to those you want to include in the EAR file. When you check the check box, a default context name appears. You can edit this context name if you choose.

External WAR Files

To add external WAR files to the current project, click the External WAR Files tab, click the Add button, and navigate to the location of the WAR files you want included. As you add WAR files, the list of External WAR Files grows.



Other

This is a feature of JBuilder Enterprise.

Use this page to add any other files you want to add to the resulting EAR group. The file can be of any type, including non-J2EE types.

Click the Add button to display the Select One Or More Files dialog box and use the dialog box to specify the file you want to add. Continue adding files until you've specified all the files you want to add.

To remove a file from the EAR group, select the row in the grid containing the file name and click Remove.