J2EE deployment files (application.xml)

<application>
The application element is the root element of a J2EE application deployment descriptor.


<icon>
The icon element contains a small-icon and a large-icon element which specify the location within the application for a small and large image used to represent the application in a GUI tool.


<small-icon>path/to/icon.gif</small-icon>
The small-icon element contains the location within the application of a file containing a small (16x16 pixel) icon image. The image must be either GIF or JPEG format and the filename must end with the extension of ".gif" or ".jpg".


<large-icon>path/to/icon.gif</large-icon>
The large-icon element contains the location within the application of a file containing a large (32x32 pixel) icon image. The image must be either GIF or JPEG format and the filename must end with the extension of ".gif" or ".jpg".



<display-name>The name.</display-name>
The display-name element specifies an application name. The application name is assigned to the application by the application assembler and is used to identify the application to the deployer at deployment time.


<description>A description.</description>
The description element provides a human readable description of the application. The description element should include any information that the application assembler wants to provide the deployer.


<module>
The module element represents a single J2EE module and contains an ejb, java, or web element, which indicates the module type and contains a path to the module file, and an optional alt-dd element, which specifies an optional URI to the post-assembly version of the deployment descriptor. The application deployment descriptor must have one module element for each J2EE module in the application package.


<ejb>pathToEJB.jar</ejb>
The ejb element specifies the URI of a ejb-jar, relative to the top level of the application package.


<java>pathToClient.jar</java>
The java element specifies the URI of a java application client module, relative to the top level of the application package.


<web>
The web element contains the web-uri and context-root of a web application module.


<web-uri>pathTo.war</web-uri>
The web-uri element specifies the URI of a web application file, relative to the top level of the application package.


<context-root>thedir/</context-root>
The context-root element specifies the context root of a web application.



<alt-dd>path/to/dd</alt-dd>
The alt-dd element specifies an optional URI to the post-assembly version of the deployment descriptor file for a particular J2EE module. The URI must specify the full pathname of the deployment descriptor file relative to the application's root directory. If alt-dd is not specified, the deployer must read the deployment descriptor from the default location and file name required by the respective component specification.



<security-role>
The security-role element contains the definition of a security role which is global to the application. The definition consists of a description of the security role, and the security role name. The descriptions at this level override those in the component level security-role definitions and must be the descriptions tool display to the deployer.


<description>A description.</description>
The description element provides a human readable description of the application. The description element should include any information that the application assembler wants to provide the deployer.


<role-name>nameOfRole</role-name>
The name of the role.