EJB Group Properties dialog box

This is a feature of JBuilder Enterprise.

Build page

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

Output JAR File

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

Name

The name of the JAR file. JBuilder suggests a default name based on the name of the EJB group, 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 JAR file.

Include Deployment Descriptors In Output JAR File

Determines whether the deployment descriptors are included in the JAR file. By default, this option is checked. If you don't want to use JBuilder's Deployment Descriptor editor to edit the deployment descriptors, but want to use another tool to edit the deployment descriptors, uncheck the Include Deployment Descriptors in Output Jar File option. The JAR file that is created won't include the deployment descriptors in it.

Additional Files For JAR META-INF

Lists any additional files you want added to the META-INF directory of the JAR file. To add an additional file, click the Add Button and specify the location of the file. You'll need to do this if you've added a new class, for example, to your project and you want it become part of the JAR file.

Content page

Use this option to specify the content of your archive. Include Required Classes And Known Resources

This option adds any classes that you have specifically added to your archive with the Add Class button. It also adds any classes that use one or more of the added classes.

Note: If you do not add any classes with the Add Classes button, your archive will not contain any classes.

This option also adds known resources. Known resources are those that you specifically add to the archive with the Add File button.

Include Required Classes And All Resources

This option adds any classes that you have specifically added to your archive with the Add Class button. It also adds any classes that use one or more of the added classes.

Note: If you do not add any classes with the Add Classes button, your archive will not contain any classes.

It also adds all resources in the project's source path, such as images, video clips, sound files, etc.

Always Include All Classes And Resources

This option gathers all classes on your project's outpath. The outpath is defined on the Paths page of the Project Properties dialog box. Usually, this is set to the classes directory of your project.

It also gathers all resources on the project's source path, also set on the Paths page of the Properties dialog box. Usually, this is set to the src directory of your project. Resources are files other than class files, such as images, video clips, sound files, and so on.

For all archive types, this option is on by default. This option is the safest, as it gathers:

Add Class

The Add Class button displays the Select A Class dialog box, where you select a class to your archive. The class does not have to be in your project's outpath. If you choose either the Include Required Classes And Known Resources or the Include Required Classes And All Resources options, the Archive Builder will scan these added class files for additional class dependencies and will put those classes in the archive.

Add File

The Add File button displays the File Open dialog box, where you choose the file to add to your archive. The file must be in your project's source path. Use this option to add miscellaneous files in your archive, such as resources (.gif, .jpg, and audio files), property files, database drivers, or archived documentation (.html, readme.txt).

Note: The Add File dialog cannot look inside archive files. If a file or package you need is inside an archive file, extract it first to your source folder, then add it using the Add File button.

Remove

Removes the selected class or file from the list.

Dependencies page

Use the Dependencies determine what to do with library dependencies. The libraries used in your project are listed, and you can choose an individual deployment strategy for each one.

Note: If you deploy any classes from the JDataStore package (com.borland.datastore) or the VisiBroker package (com.visigenic), you will see a warning reminding you that deploying these packages requires a separate deployment license. If you already have the appropriate license and don't want to see this warning again in this project, check "Don't warn me about this project again."

Never Include Any Classes Or Resources

This is the default option for all archive types except applets. No libraries are included in your archive file. You need to distribute the redistributable libraries with your JAR file and include them on the CLASSPATH at runtime, rather than putting the required classes from those libraries inside the JAR file. This is the easiest way to deploy and creates the smallest program JAR file.

If you choose this option, Exclude All is displayed next to the selected library.

Include Required Classes And Known Resources

If you choose this option, the JBuilder attempts to determine which classes and resources are needed. It attempts to include any classes that are dependent on classes used in your project. It also attempts to include any resources that are used by any classes in your project. Note that this process won't work for many libraries.

If you choose this option, Include Deps is displayed next to the selected library.

Include Required Classes And All Resources

If you choose this option, the JBuilder attempts to determine which classes are needed by classes your project. It attempts to include any classes that are dependent on classes used in your project.

It will also gather all resources on the project's source path, set on the Paths page of the Project Properties dialog box. Usually, this is set to the src directory of your project. Resources are files other than class files, such as images, video clips, sound files, etc. This option is useful if you are deploying third-party libraries.

If you choose this option, Deps & Resources is displayed next to the selected library.

Always Include All Classes And Resources

This option gathers all classes and resources, whether they are dependent on not. Everything, including libraries used by JBuilder's designers, is copied to your archive file. This option is the safest, but will result in a very large archive file.

If you choose this option, Include All is displayed next to the selected library.