Sun Java System Web Server 7.0 Update 4 Developer's Guide to Java Web Applications

Deploying a Lifecycle Module

Server lifecycle listener classes are visible in the serve applications management area. You can add, delete, update, enable, and disable listener classes and set their parameters. Web Server will not support dynamic deployment of startup and shutdown classes. Any changes to these classes or their configuration requires server restart.

Table 7–1 Elements of the lifecycle


Configurable element / attribute	Data type and Units	Range of values	Remarks
`lifecycle-module.name`	String	Any non-null/non-empty unique string in lifecycle modules.	Must be specified while registering this lifecycle module.
`lifecycle-module.class`	String	Fully qualified Java class name.	Must implement the `LifecycleListener` interface.
`lifecycle-module.enabled`	Boolean	`true` or `false`.	Default is `true`.
`lifecycle-module.load-order`	Integer	0-100 Reserved. 100-MAXINT.	Order of loading the lifecycle event listeners in numerical order. Choose a load-order greater than or equal to 100 to avoid conflicts with internal lifecycle modules.
`lifecycle-module.is-failure-fatal`	Boolean	`true` or `false`	If you want the server to treat exceptions thrown from the listener classes as fatal and prevent continuation of normal startup, set this element to `true`.
`lifecycle-module.class-path`	String	Optional	Points to the user-specified classpath for the listener class.
`lifecycle-module.description`	Element	Optional	Describes the lifecycle module.
`property.name`	String	Optional	User-specified parameter `name`. Part of the `property` element.
`property.value`	String.	Optional	User-specified parameter value. Part of the `property` element.
`property.description`	String	Optional	User-specified description. Part of the `property` element.