EmbeddedTomcat (Embedded Tomcat Helper 2.5 API)

java.lang.Object
- ch.rasc.embeddedtc.EmbeddedTomcat

```
public class EmbeddedTomcat
extends Object
```
Helper class to simplify setting up a Embedded Tomcat in a IDE and with a Maven web project.

Author:

Ralph Schaer

Field Summary

Fields
Modifier and Type Field and Description

int maxPostSize

Fields
Modifier and Type	Field and Description
`int`	`maxPostSize`

Constructor Summary

Constructors
Constructor and Description
`EmbeddedTomcat()` Creates an embedded Tomcat with context path "" and port 8080.
`EmbeddedTomcat(int port)` Creates an embedded Tomcat with context path "" and specified port.
`EmbeddedTomcat(String contextPath)` Creates an embedded Tomcat with the specified context path and port 8080 Context directory points to current directory + /src/main/webapp Change context directory with the method `setContextDirectory(String)`
`EmbeddedTomcat(String contextPath, int httpPort)` Creates an embedded Tomcat with specified context path and specified port.
`EmbeddedTomcat(String contextPath, int httpPort, int httpsPort)` Creates an embedded Tomcat with specified context path and specified ports.

Method Summary

Methods
Modifier and Type	Method and Description
`EmbeddedTomcat`	`addContextEnvironment(org.apache.tomcat.util.descriptor.web.ContextEnvironment env)` Adds a `ContextEnvironment` object to embedded Tomcat.
`EmbeddedTomcat`	`addContextEnvironment(String name, String value, String type)` Convenient method for adding a context environment to the embedded Tomcat.
`EmbeddedTomcat`	`addContextEnvironmentString(String name, String value)` Convenient method for adding a context environment with type java.lang.String to the embedded Tomcat.
`EmbeddedTomcat`	`addContextInitializationParameter(String name, String value)`
`EmbeddedTomcat`	`addContextResource(org.apache.tomcat.util.descriptor.web.ContextResource res)` Adds a `ContextResource` object to the list of resources in the embedded Tomcat.
`EmbeddedTomcat`	`addDefaultListeners()` Installs the default listeners AprLifecycleListener, JasperListener, JreMemoryLeakPreventionListener, GlobalResourcesLifecycleListener and ThreadLocalLeakPreventionListener during startup.
`static EmbeddedTomcat`	`create()` Convenient method to create a embedded Tomcat that listens on port 8080 and with a context path of ""
`EmbeddedTomcat`	`dontAddShutdownHook()` The EmbeddedTomcat listens per default for shutdown commands on port 8005 with the shutdown command `SHUTDOWN`.
`EmbeddedTomcat`	`enableCompression(int compressionMinSize, String compressableMimeType)`
`EmbeddedTomcat`	`enableNaming()` Enables JNDI naming which is disabled by default.
`static void`	`main(String[] args)` Starts a embedded Tomcat on port 8080 with context path "" and context directory current directory + /src/main/webapp
`EmbeddedTomcat`	`setContextDirectory(String contextDirectory)` Sets the context directory.
`EmbeddedTomcat`	`setContextFile(String contextFile)` Sets the location of the context file that configures this web application
`EmbeddedTomcat`	`setContextFile(URL contextFileURL)` Sets the location of the context file that configures this web application
`EmbeddedTomcat`	`setContextPath(String contextPath)` Sets the contextPath for the webapplication
`EmbeddedTomcat`	`setHttpPort(int httpPort)` Sets the port the server is listening for http requests
`EmbeddedTomcat`	`setHttpsPort(int httpsPort)` Sets the port the server is listening for https requests
`EmbeddedTomcat`	`setKeyAlias(String keyAlias)` The alias used to for the server certificate in the keystore.
`EmbeddedTomcat`	`setKeyStoreFile(String keyStoreFile)` The pathname of the keystore file where you have stored the server certificate to be loaded.
`EmbeddedTomcat`	`setKeyStorePass(String keyStorePass)` The password used to access the server certificate from the specified keystore file.
`EmbeddedTomcat`	`setMaxPostSize(int maxPostSize)` The maximum size in bytes of the POST which will be handled by the container FORM URL parameter parsing.
`EmbeddedTomcat`	`setPort(int port)` Deprecated. Use `setHttpPort(int)` instead
`EmbeddedTomcat`	`setPrivileged(boolean privileged)` Set the privileged flag for this web application.
`EmbeddedTomcat`	`setSecondsToWaitBeforePortBecomesAvailable(int seconds)` Before starting the embedded Tomcat the programm tries to stop a previous process by sendig the shutdown command to the shutdown port.
`EmbeddedTomcat`	`setShutdownPort(int shutdownPort)` Specifies the port the server is listen for the shutdown command.
`EmbeddedTomcat`	`setSilent(boolean silent)` Set the silent flag of Tomcat.
`EmbeddedTomcat`	`setTempDirectory(File tempDirectory)` Sets the location of the temporary directory.
`EmbeddedTomcat`	`setTempDirectoryName(String name)` Sets the temporary directory to a directory beneath the target directory The directory does not have to exists, Tomcat will create it automatically if necessary.
`EmbeddedTomcat`	`skipJarsContextConfig(String skipJars)` Additional JARs (over and above the default JARs set with `skipJarsDefaultJarScanner(String)`) to skip when scanning for Servlet 3.0 pluggability features.
`EmbeddedTomcat`	`skipJarsDefaultJarScanner(String skipJars)` List of JAR files that should not be scanned using the JarScanner functionality.
`EmbeddedTomcat`	`skipJarsTldConfig(String skipJars)` Additional JARs (over and above the default JARs set with `skipJarsDefaultJarScanner(String)`) to skip when scanning for TLDs.
`void`	`start()` Starts the embedded Tomcat and do not wait for incoming requests.
`void`	`startAndWait()` Starts the embedded Tomcat and waits for incoming requests.
`void`	`stop()` Stops the embedded tomcat.
`EmbeddedTomcat`	`useNio2()` Instructs the embedded tomcat to use the NIO2 Connector (org.apache.coyote.http11.Http11Nio2Protocol) instead of the NIO Connector (org.apache.coyote.http11.Http11NioProtocol)

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - maxPostSize
```
public int maxPostSize
```
- Constructor Detail
  - EmbeddedTomcat
```
public EmbeddedTomcat()
```
    Creates an embedded Tomcat with context path "" and port 8080. Context directory points to current directory + /src/main/webapp Change context directory with the method setContextDirectory(String)
    
    See Also:
    setContextDirectory(String)
  - EmbeddedTomcat
```
public EmbeddedTomcat(int port)
```
    Creates an embedded Tomcat with context path "" and specified port. Context directory points to current directory + /src/main/webapp Change context directory with the method setContextDirectory(String)
    
    Parameters:
    port - ip port the server is listening
    See Also:
    setContextDirectory(String)
  - EmbeddedTomcat
```
public EmbeddedTomcat(String contextPath)
```
    Creates an embedded Tomcat with the specified context path and port 8080 Context directory points to current directory + /src/main/webapp Change context directory with the method setContextDirectory(String)
    
    Parameters:
    contextPath - The context path has to start with /
    See Also:
    setContextDirectory(String)
  - EmbeddedTomcat
```
public EmbeddedTomcat(String contextPath,
              int httpPort)
```
    Creates an embedded Tomcat with specified context path and specified port. Context directory points to current directory + /src/main/webapp Change context directory with the method setContextDirectory(String)
    
    Parameters:
    contextPath - has to start with /
    httpPort - ip port the server is listening for http requests. Shutdown port is set to port + 1000
    See Also:
    setContextDirectory(String)
  - EmbeddedTomcat
```
public EmbeddedTomcat(String contextPath,
              int httpPort,
              int httpsPort)
```
    Creates an embedded Tomcat with specified context path and specified ports. Context directory points to current directory + /src/main/webapp Change context directory with the method setContextDirectory(String)
    
    Parameters:
    contextPath - has to start with /
    httpPort - ip port the server is listening for http requests. Shutdown port is set to port + 1000
    httpsPort - ip port the server is listening for https requests.
    See Also:
    setContextDirectory(String)
- Method Detail
  - main
```
public static void main(String[] args)
```
    Starts a embedded Tomcat on port 8080 with context path "" and context directory current directory + /src/main/webapp
    
    Parameters:
    args - program arguments
  - create
```
public static EmbeddedTomcat create()
```
    Convenient method to create a embedded Tomcat that listens on port 8080 and with a context path of ""
    
    Returns:
    EmbeddedTomcat the embedded tomcat
  - setPort
```
@Deprecated
public EmbeddedTomcat setPort(int port)
```
    Deprecated. Use setHttpPort(int) instead
  - setHttpPort
```
public EmbeddedTomcat setHttpPort(int httpPort)
```
    Sets the port the server is listening for http requests
    
    Parameters:
    httpPort - The new port
    
    Returns:
    The embedded Tomcat
  - setMaxPostSize
```
public EmbeddedTomcat setMaxPostSize(int maxPostSize)
```
    The maximum size in bytes of the POST which will be handled by the container FORM URL parameter parsing. The limit can be disabled by setting this attribute to a value less than or equal to 0. If not specified, this attribute is set to 2097152 (2 megabytes).
    
    Parameters:
    maxPostSize - maximum size in bytes for POST requests
    
    Returns:
    The embedded Tomcat
  - setHttpsPort
```
public EmbeddedTomcat setHttpsPort(int httpsPort)
```
    Sets the port the server is listening for https requests
    
    Parameters:
    httpsPort - The new port
    
    Returns:
    The embedded Tomcat
  - setKeyStoreFile
```
public EmbeddedTomcat setKeyStoreFile(String keyStoreFile)
```
    The pathname of the keystore file where you have stored the server certificate to be loaded. By default, the pathname is the file ".keystore" in the operating system home directory of the user that is running Tomcat.
    
    Parameters:
    keyStoreFile - The keystore pathname
    
    Returns:
    The embedded Tomcat
  - setKeyAlias
```
public EmbeddedTomcat setKeyAlias(String keyAlias)
```
    The alias used to for the server certificate in the keystore. If not specified the first key read in the keystore will be used.
    
    Parameters:
    keyAlias - The key alias
    
    Returns:
    The embedded Tomcat
  - setKeyStorePass
```
public EmbeddedTomcat setKeyStorePass(String keyStorePass)
```
    The password used to access the server certificate from the specified keystore file. The default value is "changeit".
    
    Parameters:
    keyStorePass - The keystore password
    
    Returns:
    The embedded Tomcat
  - setContextPath
```
public EmbeddedTomcat setContextPath(String contextPath)
```
    Sets the contextPath for the webapplication
    
    Parameters:
    contextPath - The new contextPath. Has to start with / or is the empty "" string
    
    Returns:
    The embedded Tomcat
  - setContextDirectory
```
public EmbeddedTomcat setContextDirectory(String contextDirectory)
```
    Sets the context directory. Normally this point to the directory that hosts the WEB-INF directory. Default value is: current directory + /src/main/webapp This is the normal location of the webapplication directory in a Maven web app project.
    
    Parameters:
    contextDirectory - Path name to the directory that contains the web application.
    
    Returns:
    The embedded Tomcat
  - skipJarsDefaultJarScanner
```
public EmbeddedTomcat skipJarsDefaultJarScanner(String skipJars)
```
    List of JAR files that should not be scanned using the JarScanner functionality. This is typically used to scan JARs for configuration information. JARs that do not contain such information may be excluded from the scan to speed up the scanning process. JARs on this list are excluded from all scans.
    Scan specific lists (to exclude JARs from individual scans) see skipJarsContextConfig(String) and skipJarsTldConfig(String).
    The list must be a comma separated list of JAR file names. Example: spring*.jar,cglib*.jar.
    This list is appended to the default list. The default list is located in the file CATALINA_HOME\conf\catalina.properties under the key tomcat.util.scan.DefaultJarScanner.jarsToSkip
    
    Parameters:
    skipJars - list of jars, comma separated
    
    Returns:
    The embedded Tomcat
  - skipJarsContextConfig
```
public EmbeddedTomcat skipJarsContextConfig(String skipJars)
```
    Additional JARs (over and above the default JARs set with skipJarsDefaultJarScanner(String)) to skip when scanning for Servlet 3.0 pluggability features. These features include web fragments, annotations, SCIs and classes that match @HandlesTypes. The list must be a comma separated list of JAR file names.
    
    Parameters:
    skipJars - list of jars, comma separated
    
    Returns:
    The embedded Tomcat
  - skipJarsTldConfig
```
public EmbeddedTomcat skipJarsTldConfig(String skipJars)
```
    Additional JARs (over and above the default JARs set with skipJarsDefaultJarScanner(String)) to skip when scanning for TLDs. The list must be a comma separated list of JAR file names.
    
    Parameters:
    skipJars - list of jars, comma separated
    
    Returns:
    The embedded Tomcat
  - setTempDirectory
```
public EmbeddedTomcat setTempDirectory(File tempDirectory)
```
    Sets the location of the temporary directory. Tomcat needs this for storing temporary files like compiled jsp files. Default value is
    target/tomcat. + port
    
    Parameters:
    tempDirectory - File object that represents the location of the temp directory
    
    Returns:
    The embedded Tomcat
  - setTempDirectoryName
```
public EmbeddedTomcat setTempDirectoryName(String name)
```
    Sets the temporary directory to a directory beneath the target directory
    The directory does not have to exists, Tomcat will create it automatically if necessary.
    
    Parameters:
    name - directory name
    
    Returns:
    The embedded Tomcat
    See Also:
    setTempDirectory(File)
  - dontAddShutdownHook
```
public EmbeddedTomcat dontAddShutdownHook()
```
    The EmbeddedTomcat listens per default for shutdown commands on port 8005 with the shutdown command SHUTDOWN. Calling this method disables adding the shutdown hook.
    
    Returns:
    The embedded Tomcat
  - setSecondsToWaitBeforePortBecomesAvailable
```
public EmbeddedTomcat setSecondsToWaitBeforePortBecomesAvailable(int seconds)
```
    Before starting the embedded Tomcat the programm tries to stop a previous process by sendig the shutdown command to the shutdown port. It then waits for the port to become available. It checks this every second for the specified number of seconds
    
    Parameters:
    seconds - number of seconds
    
    Returns:
    The embedded Tomcat
  - setShutdownPort
```
public EmbeddedTomcat setShutdownPort(int shutdownPort)
```
    Specifies the port the server is listen for the shutdown command. Default is port 8005
    
    Parameters:
    shutdownPort - the shutdown port
    
    Returns:
    The embedded Tomcat *
    See Also:
    dontAddShutdownHook()
  - setPrivileged
```
public EmbeddedTomcat setPrivileged(boolean privileged)
```
    Set the privileged flag for this web application.
    
    Parameters:
    privileged - The new privileged flag
    
    Returns:
    The embedded Tomcat
  - useNio2
```
public EmbeddedTomcat useNio2()
```
    Instructs the embedded tomcat to use the NIO2 Connector (org.apache.coyote.http11.Http11Nio2Protocol) instead of the NIO Connector (org.apache.coyote.http11.Http11NioProtocol)
    
    Returns:
    The embedded Tomcat
  - enableCompression
```
public EmbeddedTomcat enableCompression(int compressionMinSize,
                               String compressableMimeType)
```
  - enableNaming
```
public EmbeddedTomcat enableNaming()
```
    Enables JNDI naming which is disabled by default.
    
    Returns:
    The embedded Tomcat
  - addDefaultListeners
```
public EmbeddedTomcat addDefaultListeners()
```
    Installs the default listeners AprLifecycleListener, JasperListener, JreMemoryLeakPreventionListener, GlobalResourcesLifecycleListener and ThreadLocalLeakPreventionListener during startup.
    
    Returns:
    The embedded Tomcat
  - setSilent
```
public EmbeddedTomcat setSilent(boolean silent)
```
    Set the silent flag of Tomcat. If true Tomcat no longer prints any log messages
    
    Parameters:
    silent - The new silent flag
    
    Returns:
    The embedded Tomcat
  - addContextEnvironment
```
public EmbeddedTomcat addContextEnvironment(org.apache.tomcat.util.descriptor.web.ContextEnvironment env)
```
    Adds a ContextEnvironment object to embedded Tomcat.
    Example:
    Tomcat context xml file
```
    <Environment name="aparam"
                 value="test"
                 type="java.lang.String"
                 override="false"/>
 
```
    A programmatic way to add this environment to the embedded Tomcat is by calling this method
```
 ContextEnvironment env = new ContextEnvironment();
 env.setType("java.lang.String");
 env.setName("aparam");
 env.setValue("test");
 embeddedTomcat.addContextEnvironment(env);
 
```
    Parameters:
    env - context environment variable
    
    Returns:
    The embedded Tomcat
    See Also:
    ContextEnvironment, NamingResources.addEnvironment(ContextEnvironment), addContextEnvironment(String, String, String), addContextEnvironmentString(String, String)
  - addContextResource
```
public EmbeddedTomcat addContextResource(org.apache.tomcat.util.descriptor.web.ContextResource res)
```
    Adds a ContextResource object to the list of resources in the embedded Tomcat.
    Example:
    Tomcat context xml file
```
  <Resource name="jdbc/ds" auth="Container"
     type="javax.sql.DataSource" username="sa" password=""
     driverClassName="org.h2.Driver"
     url="jdbc:h2:~/mydb"
     maxActive="20" maxIdle="4" maxWait="10000"
     defaultAutoCommit="false"/>
 
```
    Programmatic way:
```
 ContextResource res = new ContextResource();
 res.setName("jdbc/ds");
 res.setType("javax.sql.DataSource");
 res.setAuth("Container");
 res.setProperty("username", "sa");
 res.setProperty("password", "");
 res.setProperty("driverClassName", "org.h2.Driver");
 res.setProperty("url", "jdbc:h2:˜/mydb");
 res.setProperty("maxActive", "20");
 res.setProperty("maxIdle", "4");
 res.setProperty("maxWait", "10000");
 res.setProperty("defaultAutoCommit", "false");

 embeddedTomcat.addContextResource(res);
 
```
    Parameters:
    res - resource object
    
    Returns:
    The embedded Tomcat
    See Also:
    ContextResource, NamingResources.addResource(ContextResource)
  - addContextInitializationParameter
```
public EmbeddedTomcat addContextInitializationParameter(String name,
                                               String value)
```
  - addContextEnvironment
```
public EmbeddedTomcat addContextEnvironment(String name,
                                   String value,
                                   String type)
```
    Convenient method for adding a context environment to the embedded Tomcat. Creates a ContextEnvironment object and adds it to the list of the context environments.
    Example:
    Tomcat context xml file
```
    <Environment name="aparam"
                 value="test"
                 type="java.lang.String"
                 override="false"/>
 
```
    Programmatic way:
```
 embeddedTomcat.addContextEnvironment("aparam", "test", "java.lang.String");
 
```
    Parameters:
    name - name of the context environment
    value - value of the context environment
    type - type of the context environment
    
    Returns:
    The embedded Tomcat
    See Also:
    ContextEnvironment, NamingResources.addEnvironment(ContextEnvironment), addContextEnvironment(ContextEnvironment), addContextEnvironmentString(String, String)
  - addContextEnvironmentString
```
public EmbeddedTomcat addContextEnvironmentString(String name,
                                         String value)
```
    Convenient method for adding a context environment with type java.lang.String to the embedded Tomcat.
```
 embeddedTomcat.addContextEnvironment("aparam", "test");
 
```
    Parameters:
    name - name of the context environment
    value - value of the context environment
    
    Returns:
    The embedded Tomcat
    See Also:
    ContextEnvironment, NamingResources.addEnvironment(ContextEnvironment), addContextEnvironment(ContextEnvironment), addContextEnvironment(String, String, String)
  - setContextFile
```
public EmbeddedTomcat setContextFile(URL contextFileURL)
```
    Sets the location of the context file that configures this web application
    
    Parameters:
    contextFileURL - Location of the context file
    
    Returns:
    The embedded Tomcat instance
  - setContextFile
```
public EmbeddedTomcat setContextFile(String contextFile)
```
    Sets the location of the context file that configures this web application
    
    Parameters:
    contextFile - Location of the context file
    
    Returns:
    The embedded Tomcat instance
  - start
```
public void start()
```
    Starts the embedded Tomcat and do not wait for incoming requests. Returns immediately if the configured port is in use.
    
    See Also:
    startAndWait()
  - startAndWait
```
public void startAndWait()
```
    Starts the embedded Tomcat and waits for incoming requests. Returns immediately if the configured port is in use.
    
    See Also:
    start()
  - stop
```
public void stop()
```
    Stops the embedded tomcat. Does nothing if it's not started

Class EmbeddedTomcat

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

maxPostSize

Constructor Detail

EmbeddedTomcat

EmbeddedTomcat

EmbeddedTomcat

EmbeddedTomcat

EmbeddedTomcat

Method Detail

main

create

setPort

setHttpPort

setMaxPostSize

setHttpsPort

setKeyStoreFile

setKeyAlias

setKeyStorePass

setContextPath

setContextDirectory

skipJarsDefaultJarScanner

skipJarsContextConfig

skipJarsTldConfig

setTempDirectory

setTempDirectoryName

dontAddShutdownHook

setSecondsToWaitBeforePortBecomesAvailable

setShutdownPort

setPrivileged

useNio2

enableCompression

enableNaming

addDefaultListeners

setSilent

addContextEnvironment

addContextResource

addContextInitializationParameter

addContextEnvironment

addContextEnvironmentString

setContextFile

setContextFile

start

startAndWait

stop