File	Doc	Category	Size	Date	Package
Deployer.java	API Doc	Glassfish v2 API	9798	Fri May 04 22:31:52 BST 2007	org.apache.catalina

Deployer

Fields Summary
public static final String	PRE_INSTALL_EVENT The ContainerEvent event type sent when a new application is being installed by install(), before it has been started.
public static final String	INSTALL_EVENT The ContainerEvent event type sent when a new application is installed by install(), after it has been started.
public static final String	REMOVE_EVENT The ContainerEvent event type sent when an existing application is removed by remove().

Constructors Summary

Methods Summary
public Context	findDeployedApp(java.lang.String contextPath) Return the Context for the deployed application that is associated with the specified context path (if any); otherwise return null. param contextPath The context path of the requested web application
public java.lang.String[]	findDeployedApps() Return the context paths of all deployed web applications in this Container. If there are no deployed applications, a zero-length array is returned.
public java.lang.String	getName() Return the name of the Container with which this Deployer is associated.
public void	install(java.lang.String contextPath, java.net.URL war) Install a new web application, whose web application archive is at the specified URL, into this container with the specified context path. A context path of "" (the empty string) should be used for the root application for this container. Otherwise, the context path must start with a slash. If this application is successfully installed, a ContainerEvent of type INSTALL_EVENT will be sent to all registered listeners, with the newly created Context as an argument. param contextPath The context path to which this application should be installed (must be unique) param war A URL of type "jar:" that points to a WAR file, or type "file:" that points to an unpacked directory structure containing the web application to be installed exception IllegalArgumentException if the specified context path is malformed (it must be "" or start with a slash) exception IllegalStateException if the specified context path is already attached to an existing web application exception IOException if an input/output error was encountered during installation
public void	install(java.net.URL config, java.net.URL war) Install a new web application, whose context configuration file (consisting of a <Context> element) and web application archive are at the specified URLs. If this application is successfully installed, a ContainerEvent of type INSTALL_EVENT will be sent to all registered listeners, with the newly created Context as an argument. param config A URL that points to the context configuration file to be used for configuring the new Context param war A URL of type "jar:" that points to a WAR file, or type "file:" that points to an unpacked directory structure containing the web application to be installed exception IllegalArgumentException if one of the specified URLs is null exception IllegalStateException if the context path specified in the context configuration file is already attached to an existing web application exception IOException if an input/output error was encountered during installation
public void	remove(java.lang.String contextPath) Remove an existing web application, attached to the specified context path. If this application is successfully removed, a ContainerEvent of type REMOVE_EVENT will be sent to all registered listeners, with the removed Context as an argument. param contextPath The context path of the application to be removed exception IllegalArgumentException if the specified context path is malformed (it must be "" or start with a slash) exception IllegalArgumentException if the specified context path does not identify a currently installed web application exception IOException if an input/output error occurs during removal
public void	remove(java.lang.String contextPath, boolean undeploy) Remove an existing web application, attached to the specified context path. If this application is successfully removed, a ContainerEvent of type REMOVE_EVENT will be sent to all registered listeners, with the removed Context as an argument. Deletes the web application war file and/or directory if they exist in the Host's appBase. param contextPath The context path of the application to be removed param undeploy boolean flag to remove web application from server exception IllegalArgumentException if the specified context path is malformed (it must be "" or start with a slash) exception IllegalArgumentException if the specified context path does not identify a currently installed web application exception IOException if an input/output error occurs during removal
public void	start(java.lang.String contextPath) Start an existing web application, attached to the specified context path. Only starts a web application if it is not running. param contextPath The context path of the application to be started exception IllegalArgumentException if the specified context path is malformed (it must be "" or start with a slash) exception IllegalArgumentException if the specified context path does not identify a currently installed web application exception IOException if an input/output error occurs during startup
public void	stop(java.lang.String contextPath) Stop an existing web application, attached to the specified context path. Only stops a web application if it is running. param contextPath The context path of the application to be stopped exception IllegalArgumentException if the specified context path is malformed (it must be "" or start with a slash) exception IllegalArgumentException if the specified context path does not identify a currently installed web application exception IOException if an input/output error occurs while stopping the web application