org.codehaus.mojo.tomcat
Class TomcatManager

java.lang.Object
  extended by org.codehaus.mojo.tomcat.TomcatManager

public class TomcatManager
extends java.lang.Object

A Tomcat manager webapp invocation wrapper.

Version:
$Id: TomcatManager.java 6588 2008-03-28 12:22:57Z bentmann $
Author:
Mark Hobson

Constructor Summary
TomcatManager(java.net.URL url)
          Creates a Tomcat manager wrapper for the specified URL that uses a username of admin, an empty password and ISO-8859-1 URL encoding.
TomcatManager(java.net.URL url, java.lang.String username)
          Creates a Tomcat manager wrapper for the specified URL and username that uses an empty password and ISO-8859-1 URL encoding.
TomcatManager(java.net.URL url, java.lang.String username, java.lang.String password)
          Creates a Tomcat manager wrapper for the specified URL, username and password that uses ISO-8859-1 URL encoding.
TomcatManager(java.net.URL url, java.lang.String username, java.lang.String password, java.lang.String charset)
          Creates a Tomcat manager wrapper for the specified URL, username, password and URL encoding.
 
Method Summary
 java.lang.String deploy(java.lang.String path, java.io.InputStream war)
          Deploys the specified WAR as a HTTP PUT to the specified context path.
 java.lang.String deploy(java.lang.String path, java.io.InputStream war, boolean update)
          Deploys the specified WAR as a HTTP PUT to the specified context path, optionally undeploying the webapp if it already exists.
 java.lang.String deploy(java.lang.String path, java.io.InputStream war, boolean update, java.lang.String tag)
          Deploys the specified WAR as a HTTP PUT to the specified context path, optionally undeploying the webapp if it already exists and using the specified tag name.
 java.lang.String deploy(java.lang.String path, java.net.URL war)
          Deploys the specified WAR as a URL to the specified context path.
 java.lang.String deploy(java.lang.String path, java.net.URL war, boolean update)
          Deploys the specified WAR as a URL to the specified context path, optionally undeploying the webapp if it already exists.
 java.lang.String deploy(java.lang.String path, java.net.URL war, boolean update, java.lang.String tag)
          Deploys the specified WAR as a URL to the specified context path, optionally undeploying the webapp if it already exists and using the specified tag name.
 java.lang.String deployContext(java.lang.String path, java.net.URL config)
          Deploys the specified context XML configuration to the specified context path.
 java.lang.String deployContext(java.lang.String path, java.net.URL config, boolean update)
          Deploys the specified context XML configuration to the specified context path, optionally undeploying the webapp if it already exists.
 java.lang.String deployContext(java.lang.String path, java.net.URL config, boolean update, java.lang.String tag)
          Deploys the specified context XML configuration to the specified context path, optionally undeploying the webapp if it already exists and using the specified tag name.
 java.lang.String deployContext(java.lang.String path, java.net.URL config, java.net.URL war)
          Deploys the specified context XML configuration and WAR as a URL to the specified context path.
 java.lang.String deployContext(java.lang.String path, java.net.URL config, java.net.URL war, boolean update)
          Deploys the specified context XML configuration and WAR as a URL to the specified context path, optionally undeploying the webapp if it already exists.
 java.lang.String deployContext(java.lang.String path, java.net.URL config, java.net.URL war, boolean update, java.lang.String tag)
          Deploys the specified context XML configuration and WAR as a URL to the specified context path, optionally undeploying the webapp if it already exists and using the specified tag name.
 java.lang.String getCharset()
          Gets the URL encoding charset to use when communicating with Tomcat manager.
 java.lang.String getPassword()
          Gets the password to use when authenticating with Tomcat manager.
 java.lang.String getResources()
          Lists all of the global JNDI resources.
 java.lang.String getResources(java.lang.String type)
          Lists the global JNDI resources of the given type.
 java.lang.String getRoles()
          Lists the security role names and corresponding descriptions that are available.
 java.lang.String getServerInfo()
          Lists information about the Tomcat version, OS, and JVM properties.
 java.lang.String getSessions(java.lang.String path)
          Lists the default session timeout and the number of currently active sessions for the given context path.
 java.net.URL getURL()
          Gets the full URL of the Tomcat manager instance.
 java.lang.String getUserAgent()
          Gets the user agent name to use when communicating with Tomcat manager.
 java.lang.String getUserName()
          Gets the username to use when authenticating with Tomcat manager.
protected  java.lang.String invoke(java.lang.String path)
          Invokes Tomcat manager with the specified command.
protected  java.lang.String invoke(java.lang.String path, java.io.InputStream data)
          Invokes Tomcat manager with the specified command and content data.
 java.lang.String list()
          Lists all the currently deployed web applications.
 java.lang.String reload(java.lang.String path)
          Reloads the webapp at the specified context path.
 void setUserAgent(java.lang.String userAgent)
          Sets the user agent name to use when communicating with Tomcat manager.
 java.lang.String start(java.lang.String path)
          Starts the webapp at the specified context path.
 java.lang.String stop(java.lang.String path)
          Stops the webapp at the specified context path.
 java.lang.String undeploy(java.lang.String path)
          Undeploys the webapp at the specified context path.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

TomcatManager

public TomcatManager(java.net.URL url)
Creates a Tomcat manager wrapper for the specified URL that uses a username of admin, an empty password and ISO-8859-1 URL encoding.

Parameters:
url - the full URL of the Tomcat manager instance to use

TomcatManager

public TomcatManager(java.net.URL url,
                     java.lang.String username)
Creates a Tomcat manager wrapper for the specified URL and username that uses an empty password and ISO-8859-1 URL encoding.

Parameters:
url - the full URL of the Tomcat manager instance to use
username - the username to use when authenticating with Tomcat manager

TomcatManager

public TomcatManager(java.net.URL url,
                     java.lang.String username,
                     java.lang.String password)
Creates a Tomcat manager wrapper for the specified URL, username and password that uses ISO-8859-1 URL encoding.

Parameters:
url - the full URL of the Tomcat manager instance to use
username - the username to use when authenticating with Tomcat manager
password - the password to use when authenticating with Tomcat manager

TomcatManager

public TomcatManager(java.net.URL url,
                     java.lang.String username,
                     java.lang.String password,
                     java.lang.String charset)
Creates a Tomcat manager wrapper for the specified URL, username, password and URL encoding.

Parameters:
url - the full URL of the Tomcat manager instance to use
username - the username to use when authenticating with Tomcat manager
password - the password to use when authenticating with Tomcat manager
charset - the URL encoding charset to use when communicating with Tomcat manager
Method Detail

getURL

public java.net.URL getURL()
Gets the full URL of the Tomcat manager instance.

Returns:
the full URL of the Tomcat manager instance

getUserName

public java.lang.String getUserName()
Gets the username to use when authenticating with Tomcat manager.

Returns:
the username to use when authenticating with Tomcat manager

getPassword

public java.lang.String getPassword()
Gets the password to use when authenticating with Tomcat manager.

Returns:
the password to use when authenticating with Tomcat manager

getCharset

public java.lang.String getCharset()
Gets the URL encoding charset to use when communicating with Tomcat manager.

Returns:
the URL encoding charset to use when communicating with Tomcat manager

getUserAgent

public java.lang.String getUserAgent()
Gets the user agent name to use when communicating with Tomcat manager.

Returns:
the user agent name to use when communicating with Tomcat manager

setUserAgent

public void setUserAgent(java.lang.String userAgent)
Sets the user agent name to use when communicating with Tomcat manager.

Parameters:
userAgent - the user agent name to use when communicating with Tomcat manager

deploy

public java.lang.String deploy(java.lang.String path,
                               java.net.URL war)
                        throws TomcatManagerException,
                               java.io.IOException
Deploys the specified WAR as a URL to the specified context path.

Parameters:
path - the webapp context path to deploy to
war - the URL of the WAR to deploy
Returns:
the Tomcat manager response
Throws:
TomcatManagerException - if the Tomcat manager request fails
java.io.IOException - if an i/o error occurs

deploy

public java.lang.String deploy(java.lang.String path,
                               java.net.URL war,
                               boolean update)
                        throws TomcatManagerException,
                               java.io.IOException
Deploys the specified WAR as a URL to the specified context path, optionally undeploying the webapp if it already exists.

Parameters:
path - the webapp context path to deploy to
war - the URL of the WAR to deploy
update - whether to first undeploy the webapp if it already exists
Returns:
the Tomcat manager response
Throws:
TomcatManagerException - if the Tomcat manager request fails
java.io.IOException - if an i/o error occurs

deploy

public java.lang.String deploy(java.lang.String path,
                               java.net.URL war,
                               boolean update,
                               java.lang.String tag)
                        throws TomcatManagerException,
                               java.io.IOException
Deploys the specified WAR as a URL to the specified context path, optionally undeploying the webapp if it already exists and using the specified tag name.

Parameters:
path - the webapp context path to deploy to
war - the URL of the WAR to deploy
update - whether to first undeploy the webapp if it already exists
tag - the tag name to use
Returns:
the Tomcat manager response
Throws:
TomcatManagerException - if the Tomcat manager request fails
java.io.IOException - if an i/o error occurs

deploy

public java.lang.String deploy(java.lang.String path,
                               java.io.InputStream war)
                        throws TomcatManagerException,
                               java.io.IOException
Deploys the specified WAR as a HTTP PUT to the specified context path.

Parameters:
path - the webapp context path to deploy to
war - an input stream to the WAR to deploy
Returns:
the Tomcat manager response
Throws:
TomcatManagerException - if the Tomcat manager request fails
java.io.IOException - if an i/o error occurs

deploy

public java.lang.String deploy(java.lang.String path,
                               java.io.InputStream war,
                               boolean update)
                        throws TomcatManagerException,
                               java.io.IOException
Deploys the specified WAR as a HTTP PUT to the specified context path, optionally undeploying the webapp if it already exists.

Parameters:
path - the webapp context path to deploy to
war - an input stream to the WAR to deploy
update - whether to first undeploy the webapp if it already exists
Returns:
the Tomcat manager response
Throws:
TomcatManagerException - if the Tomcat manager request fails
java.io.IOException - if an i/o error occurs

deploy

public java.lang.String deploy(java.lang.String path,
                               java.io.InputStream war,
                               boolean update,
                               java.lang.String tag)
                        throws TomcatManagerException,
                               java.io.IOException
Deploys the specified WAR as a HTTP PUT to the specified context path, optionally undeploying the webapp if it already exists and using the specified tag name.

Parameters:
path - the webapp context path to deploy to
war - an input stream to the WAR to deploy
update - whether to first undeploy the webapp if it already exists
tag - the tag name to use
Returns:
the Tomcat manager response
Throws:
TomcatManagerException - if the Tomcat manager request fails
java.io.IOException - if an i/o error occurs

deployContext

public java.lang.String deployContext(java.lang.String path,
                                      java.net.URL config)
                               throws TomcatManagerException,
                                      java.io.IOException
Deploys the specified context XML configuration to the specified context path.

Parameters:
path - the webapp context path to deploy to
config - the URL of the context XML configuration to deploy
Returns:
the Tomcat manager response
Throws:
TomcatManagerException - if the Tomcat manager request fails
java.io.IOException - if an i/o error occurs

deployContext

public java.lang.String deployContext(java.lang.String path,
                                      java.net.URL config,
                                      boolean update)
                               throws TomcatManagerException,
                                      java.io.IOException
Deploys the specified context XML configuration to the specified context path, optionally undeploying the webapp if it already exists.

Parameters:
path - the webapp context path to deploy to
config - the URL of the context XML configuration to deploy
update - whether to first undeploy the webapp if it already exists
Returns:
the Tomcat manager response
Throws:
TomcatManagerException - if the Tomcat manager request fails
java.io.IOException - if an i/o error occurs

deployContext

public java.lang.String deployContext(java.lang.String path,
                                      java.net.URL config,
                                      boolean update,
                                      java.lang.String tag)
                               throws TomcatManagerException,
                                      java.io.IOException
Deploys the specified context XML configuration to the specified context path, optionally undeploying the webapp if it already exists and using the specified tag name.

Parameters:
path - the webapp context path to deploy to
config - the URL of the context XML configuration to deploy
update - whether to first undeploy the webapp if it already exists
tag - the tag name to use
Returns:
the Tomcat manager response
Throws:
TomcatManagerException - if the Tomcat manager request fails
java.io.IOException - if an i/o error occurs

deployContext

public java.lang.String deployContext(java.lang.String path,
                                      java.net.URL config,
                                      java.net.URL war)
                               throws TomcatManagerException,
                                      java.io.IOException
Deploys the specified context XML configuration and WAR as a URL to the specified context path.

Parameters:
path - the webapp context path to deploy to
config - the URL of the context XML configuration to deploy
war - the URL of the WAR to deploy
Returns:
the Tomcat manager response
Throws:
TomcatManagerException - if the Tomcat manager request fails
java.io.IOException - if an i/o error occurs

deployContext

public java.lang.String deployContext(java.lang.String path,
                                      java.net.URL config,
                                      java.net.URL war,
                                      boolean update)
                               throws TomcatManagerException,
                                      java.io.IOException
Deploys the specified context XML configuration and WAR as a URL to the specified context path, optionally undeploying the webapp if it already exists.

Parameters:
path - the webapp context path to deploy to
config - the URL of the context XML configuration to deploy
war - the URL of the WAR to deploy
update - whether to first undeploy the webapp if it already exists
Returns:
the Tomcat manager response
Throws:
TomcatManagerException - if the Tomcat manager request fails
java.io.IOException - if an i/o error occurs

deployContext

public java.lang.String deployContext(java.lang.String path,
                                      java.net.URL config,
                                      java.net.URL war,
                                      boolean update,
                                      java.lang.String tag)
                               throws TomcatManagerException,
                                      java.io.IOException
Deploys the specified context XML configuration and WAR as a URL to the specified context path, optionally undeploying the webapp if it already exists and using the specified tag name.

Parameters:
path - the webapp context path to deploy to
config - the URL of the context XML configuration to deploy
war - the URL of the WAR to deploy
update - whether to first undeploy the webapp if it already exists
tag - the tag name to use
Returns:
the Tomcat manager response
Throws:
TomcatManagerException - if the Tomcat manager request fails
java.io.IOException - if an i/o error occurs

undeploy

public java.lang.String undeploy(java.lang.String path)
                          throws TomcatManagerException,
                                 java.io.IOException
Undeploys the webapp at the specified context path.

Parameters:
path - the webapp context path to undeploy
Returns:
the Tomcat manager response
Throws:
TomcatManagerException - if the Tomcat manager request fails
java.io.IOException - if an i/o error occurs

reload

public java.lang.String reload(java.lang.String path)
                        throws TomcatManagerException,
                               java.io.IOException
Reloads the webapp at the specified context path.

Parameters:
path - the webapp context path to reload
Returns:
the Tomcat manager response
Throws:
TomcatManagerException - if the Tomcat manager request fails
java.io.IOException - if an i/o error occurs

start

public java.lang.String start(java.lang.String path)
                       throws TomcatManagerException,
                              java.io.IOException
Starts the webapp at the specified context path.

Parameters:
path - the webapp context path to start
Returns:
the Tomcat manager response
Throws:
TomcatManagerException - if the Tomcat manager request fails
java.io.IOException - if an i/o error occurs

stop

public java.lang.String stop(java.lang.String path)
                      throws TomcatManagerException,
                             java.io.IOException
Stops the webapp at the specified context path.

Parameters:
path - the webapp context path to stop
Returns:
the Tomcat manager response
Throws:
TomcatManagerException - if the Tomcat manager request fails
java.io.IOException - if an i/o error occurs

list

public java.lang.String list()
                      throws TomcatManagerException,
                             java.io.IOException
Lists all the currently deployed web applications.

Returns:
the list of currently deployed applications
Throws:
TomcatManagerException - if the Tomcat manager request fails
java.io.IOException - if an i/o error occurs

getServerInfo

public java.lang.String getServerInfo()
                               throws TomcatManagerException,
                                      java.io.IOException
Lists information about the Tomcat version, OS, and JVM properties.

Returns:
the server information
Throws:
TomcatManagerException - if the Tomcat manager request fails
java.io.IOException - if an i/o error occurs

getResources

public java.lang.String getResources()
                              throws TomcatManagerException,
                                     java.io.IOException
Lists all of the global JNDI resources.

Returns:
the list of all global JNDI resources
Throws:
TomcatManagerException - if the Tomcat manager request fails
java.io.IOException - if an i/o error occurs

getResources

public java.lang.String getResources(java.lang.String type)
                              throws TomcatManagerException,
                                     java.io.IOException
Lists the global JNDI resources of the given type.

Parameters:
type - the class name of the resources to list, or null for all
Returns:
the list of global JNDI resources of the given type
Throws:
TomcatManagerException - if the Tomcat manager request fails
java.io.IOException - if an i/o error occurs

getRoles

public java.lang.String getRoles()
                          throws TomcatManagerException,
                                 java.io.IOException
Lists the security role names and corresponding descriptions that are available.

Returns:
the list of security role names and corresponding descriptions
Throws:
TomcatManagerException - if the Tomcat manager request fails
java.io.IOException - if an i/o error occurs

getSessions

public java.lang.String getSessions(java.lang.String path)
                             throws TomcatManagerException,
                                    java.io.IOException
Lists the default session timeout and the number of currently active sessions for the given context path.

Parameters:
path - the context path to list session information for
Returns:
the default session timeout and the number of currently active sessions
Throws:
TomcatManagerException - if the Tomcat manager request fails
java.io.IOException - if an i/o error occurs

invoke

protected java.lang.String invoke(java.lang.String path)
                           throws TomcatManagerException,
                                  java.io.IOException
Invokes Tomcat manager with the specified command.

Parameters:
path - the Tomcat manager command to invoke
Returns:
the Tomcat manager response
Throws:
TomcatManagerException - if the Tomcat manager request fails
java.io.IOException - if an i/o error occurs

invoke

protected java.lang.String invoke(java.lang.String path,
                                  java.io.InputStream data)
                           throws TomcatManagerException,
                                  java.io.IOException
Invokes Tomcat manager with the specified command and content data.

Parameters:
path - the Tomcat manager command to invoke
data - an input stream to the content data
Returns:
the Tomcat manager response
Throws:
TomcatManagerException - if the Tomcat manager request fails
java.io.IOException - if an i/o error occurs


Copyright © 2005-2010. All Rights Reserved.