Enterprise JavaBeans, Second Edition

The Descriptor’s Body

The body of any XML document begins and ends with the tag for the document’s "root element,” which is defined by the DTD. For a deployment descriptor, the root element is named ejb-jar, and looks like this:

<ejb-jar>
... other elements ...
</ejb-jar>

All other elements must be nested within the ejb-jar element. You can place the following kinds of elements within ejb-jar:

<description> (optional)

The description element can be used to provide a description of this deployment descriptor. This element can be used in many contexts within a deployment descriptor: to describe the descriptor as a whole, to describe particular beans, to describe particular security roles, etc. The Cabin bean deployment descriptor doesn’t use a description element for the deployment descriptor as a whole, but it does provide a description for the Cabin bean itself.

<display-name> (optional)

The display-name element is used by tools (like a deployment wizard) that are working with the deployment descriptor. It provides a convenient visual label for the entire JAR file and individual bean components.

<small-icon> and <large-icon> (optional)

These elements point to files within the JAR file that provide icons that a deployment wizard or some other tool can use to represent the JAR file. Icons must be image files in either the JPEG or GIF format. Small icons must be 16 × 16 pixels; large icons must be 32 × 32 pixels. These icon elements are also used in the entity and session elements ...