Enterprise JavaBeans, Fourth Edition

The Descriptor’s Body

The body of any XML document begins and ends with the tag for the document’s root element. For an EJB deployment descriptor, the root element is named <ejb-jar>, and looks like this (EJB 2.1 includes XML namespace and schemaLocation attributes not shown):

<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 provides a description of the 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, and so on. The Cabin EJB deployment descriptor doesn’t use a <description> element for the deployment descriptor as a whole, but it does provide a description for the Cabin EJB itself.

<display-name> (optional)

Tools (such as a deployment wizard) that are working with the deployment descriptor use the <display-name> element to provide a convenient visual label for the entire JAR file and for individual bean components.

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

These elements point to files within the JAR file that provide icons 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 ...