application (Sun GlassFish Enterprise Server v3 Prelude Administration Reference)

Sun GlassFish Enterprise Server v3 Prelude Administration Reference

application

Specifies a system application or a Java EE module.

An engine runs a sniffer during deployment, which is responsible for identifying a type of deployment artifact (such as a WAR file) and setting up the associated container (such as the web container). Multiple engines, each with its own sniffer, can be associated with a given application.

The application element replaces the web-module and ejb-module elements of previous releases.

Note –

For GlassFish v3 Prelude, EJB modules are not supported unless the optional EJB container add-on component is downloaded from the Update Tool. Only stateless session beans with local interfaces and entity beans that use the Java Persistence API are supported. Stateful, message-driven, and EJB 2.0 and 2.1 entity beans are not supported. Remote interfaces and remote business interfaces for any of the bean types are not supported.

Web services are not supported unless the optional Metro (JSR 109) add-on component is downloaded from the Update Tool. Without the Metro component, a servlet or EJB module cannot be a web service endpoint.

JRuby applications are not supported unless the optional JRuby add-on component is downloaded from the Update Tool.

For information about the Update Tool, see the Sun GlassFish Enterprise Server v3 Prelude Installation Guide.

Superelements

system-applications, applications

Subelements

The following table describes subelements for the application element.

Table 1–4 application Subelements


Element	Required	Description
engine	one or more	Configures an engine.
property	zero or more	Specifies a property or a variable.

Attributes

The following table describes attributes for the application element.

Table 1–5 application Attributes


Attribute	Default	Description
`name`	none	The name of the application.
`description`	none	(optional) Specifies a text description of this element.
`location`	none	The location of the application in the Enterprise Server file system. If a relative path is specified, it is relative to the `domain-dir/applications/` directory. Note – Deployment directories may change between Enterprise Server releases.
`object-type`	`system-admin`	(optional) Defines the type of the resource. Allowed values are: `system-all` - A system resource for all server instances and the domain application server. `system-admin` - A system resource only for the domain application server. `system-instance` - A system resource for all server instances only. `user` - A user resource.
`enabled`	`true`	(optional) Determines whether the application is enabled.
`context-root`	none	The context root at which the application is deployed. The context root can be the empty string or just `/`. The context root can start with the `/` character, but doesn’t have to.
`directory-deployed`	`false`	(optional) Specifies whether the application has been deployed as a directory.