/embeddedtc

Helper class that simplifies starting an embedded Tomcat in a development environment for a Maven webapplication project.

Primary LanguageJavaApache License 2.0Apache-2.0

Build Status

Helper class to simplify starting an embedded Tomcat for a Maven web application project in a integrated development environment (e.g. Eclipse) .

Add this dependency to your project.

		<dependency>
			<groupId>ch.rasc</groupId>
			<artifactId>embeddedtc</artifactId>
			<version>1.29</version>
			<!-- Tomcat8: <version>2.16</version> -->
			<scope>provided</scope>
		</dependency>

and start the embedded Tomcat with the main class ch.rasc.embeddedtc.EmbeddedTomcat. This starts a Tomcat on port 8080 with a context path "" and a context directory that points to current_dir + /src/main/webapp

If you need more control create a class in your project (e.g. StartTomcat), create an instance of EmbeddedTomcat, call the configure methods and start the server with startAndWait()

public class StartTomcat {
  public static void main(String[] args) throwsException {
    EmbeddedTomcat etc = new EmbeddedTomcat(9999);
    etc.setContextDirectory("/home/mywebapp");
    etc.setTempDirectoryName("tmp");
    etc.addContextEnvironmentString("key", "value");
    etc.startAndWait();
  }
}

or with method chaining

public class StartTomcat {
  public static void main(String[] args) throwsException {
    EmbeddedTomcat.create()
		          .setPort(9999)
		          .setContextDirectory("/home/mywebapp")
		          .setTempDirectoryName("tmp")
		          .addContextEnvironmentString("key", "value")
		          .startAndWait();
	}
}

It's also possible to configure the embedded Tomcat with a context xml file. This examples starts a Tomcat on port 8080 with a web application deployed to the ROOT context ("") and the context directory points to ./src/main/webapp

public class StartTomcat {
  public static void main(String[] args) throwsException {
    EmbeddedTomcat.create()
		          .setContextFile("./src/main/config/tomcat.xml")
		          .startAndWait();
	}
}

CHANGELOG Tomcat 8

2.16 December 3, 2017

  • Tomcat 8.0.47

2.15 July 18, 2017

  • Tomcat 8.0.45

2.14 April 23, 2016

  • Tomcat 8.0.33

2.13 February 18, 2016

  • Tomcat 8.0.32

2.12 December 8, 2015

  • Tomcat 8.0.30

2.11 November 25, 2015

  • Tomcat 8.0.29

2.10 October 13, 2015

  • Tomcat 8.0.28

2.9 October 2, 2015

  • Tomcat 8.0.27

2.8 August 22, 2015

  • Tomcat 8.0.26

2.7 July 7, 2015

  • Tomcat 8.0.24

2.6 May 23, 2015

  • Tomcat 8.0.23

2.5 May 18, 2015

  • Tomcat 8.0.22

2.4 March 27, 2015

  • Tomcat 8.0.21

2.3 February 21, 2015

  • Tomcat 8.0.20

2.2 January 27, 2015

  • Tomcat 8.0.18

2.1 January 17, 2015

  • Tomcat 8.0.17

2.0 January 15, 2015

  • Initial release with Tomcat 8.0.15

CHANGELOG Tomcat 7

1.29 December 3, 2017

  • Tomcat 7.0.82

1.28 July 18, 2017

  • Tomcat 7.0.79

1.27 October 23, 2016

  • Tomcat 7.0.72

1.26 April 23, 2016

  • Tomcat 7.0.69

1.25 February 18, 2016

  • Tomcat 7.0.68

1.24 October 21, 2015

  • Tomcat 7.0.67

1.23 October 21, 2015

  • Tomcat 7.0.65

1.22 September 2, 2015

  • Tomcat 7.0.64

1.21 July 8, 2015

  • Tomcat 7.0.63

1.20 May 18, 2015

  • Tomcat 7.0.62

1.19 April 14, 2015

  • Tomcat 7.0.61

1.18 February 9, 2015

  • Tomcat 7.0.59

1.17 January 15, 2015

  • Tomcat 7.0.57
  • Add support for TLS
  • Add config option for maxPostSize

1.16 October 8, 2014

  • Tomcat 7.0.56

1.15 August 5, 2014

  • Tomcat 7.0.55

1.14 May 28, 2014

  • Tomcat 7.0.54

1.13 April 2, 2014

  • Tomcat 7.0.53

1.12 February 20, 2014

  • Tomcat 7.0.52

1.11 January 13, 2014

  • Tomcat 7.0.50
  • Add a call to stop() when somebody sends a shutdown command. Previous versions did not stop the server.

1.10 October 26, 2013

  • Tomcat 7.0.47
  • Fix some issues and javadocs concerning the shutdown port

1.9 July 7, 2013

  • Tomcat 7.0.42
  • Fixed bug in TargetClassesContext. Only handle /WEB-INF/classes special case and call superclass for every other name. Bug prevented ServletContext.getResourcePaths to work correctly.

1.8 June 10, 2013

  • Tomcat 7.0.41
  • Automatically add a list context servlet when application is not running on root context (""). This servlet sends a 404 and lists the configured context path when the user tries to connect to an unknown context. Similar to jetty

1.7 May 9, 2013

  • Tomcat 7.0.40

1.6 March 28, 2013

  • Tomcat 7.0.39

1.5 February 19, 2013

  • Tomcat 7.0.37

1.4 January 31, 2013

  • Tomcat 7.0.35
  • Added addContextInitializationParameter method. Adds context parameters that are accessible within the application with ServletContext#getInitParameter
  • Deprectated addContextEnvironmentAndResourceFromFile method and replaced it with setContextFile. This library no longer reads this file it passes the location of the file to Tomcat and he will then read the file during startup. As a result every configuration that is allowed in the context xml file is now supported.
  • Shutdown Tomcat if an error occurs during startup

1.3 November 22, 2012

  • Use "" for the root context. / is wrong.
  • Tomcat 7.0.33

1.2 October 17, 2012

  • Tomcat 7.0.32

1.1 September 8, 2012

  • Tomcat 7.0.30

  • Added useNio() method. Instructs the embedded Tomcat to use the Non Blocking Connector (org.apache.coyote.http11.Http11NioProtocol) instead of the Blocking Connector (org.apache.coyote.http11.Http11Protocol)

  • Added enableNaming() method. Enables JNDI naming.

  • Removed resource jar handling methods. This works now out of the box with Tomcat 7.0.29 and later

  • Added code that reads the catalina.properties at startup.

  • Added method skipJarsDefaultJarScanner(String skipJars). These jars are not scanned at startup for web fragments, tlds, etc. This decreases startup time significantly. By default catalina.properties already contains a list of jars to skip. The parameter of this method is added to the end of the list from catalina.properties.

  • Added skipJarsContextConfig(String skipJars) and skipJarsTldConfig(String skipJars) methods to support Tomcat 7.0.30 feature of scan specific lists.

    skipJarsContextConfig(String skipJars) Additional JARs (over and above the default JARs set with skipJarsDefaultJarScanner) to skip when scanning for Servlet 3.0 pluggability features. These features include web fragments, annotations, SCIs and classes that match @HandlesTypes.

    skipJarsTldConfig(String skipJars) Additional JARs (over and above the default JARs set with skipJarsDefaultJarScanner) to skip when scanning for TLDs.

1.0 July 11, 2012

  • Moved to a new package ch.ralscha -> ch.rasc
  • Tomcat 7.0.29

0.0.9 June 21, 2012

  • Tomcat 7.0.28

0.0.8 May 21, 2012

  • Upgraded ecj to 3.7.2
  • Fix bug in installSlf4jBridge. install() does not have a parameter

0.0.7 April 17, 2012

  • Removed addInitializer(..) method.
    Directory WEB-INF/classes is now mapped to ./target/classes and therefore all the Servlet 3.0 Annotations and ServletContainerInitializer are now working out of the box.

0.0.6 March 9, 2012

  • Tomcat 7.0.27

0.0.5 March 9, 2012

  • Bugfix: Make class ContextConfig public. Digester cannot access class if it has package visibility
  • All config methods now return the EmbeddedTomcat instance to enable method chaining
  • Changed parameters to final

0.0.4 March 2, 2012

  • Add a new method addContextEnvironmentAndResourceFromFile(File f) Reads ContextEnvironment and Contextresource from a file and adds it to the embedded Tomcat
  • Changed the way resource jars are loaded. In older version the ZipFile was closed after starting Tomcat and was no longer able to read content from the jar file.
  • Moved default temporary directory to the projects target directory
  • TomcatTest: Now deletes temp directory before starting Tomcat

0.0.3 February 26, 2012

  • The start() method no longer blocks after starting Tomcat
  • Added a new method startAndWait() that blocks the program after starting Tomcat
  • Added setSilent(boolean) method. If set to true it disables output messages.
  • Added new constructor EmbeddedTomcat(String contextPath). Creates Tomcat with specified context path and port 8080

0.0.2 February 25, 2012

  • Convert exceptions to RuntimeException
  • Starts by default a shutdown listener on the shutdown port (port + 1000)
  • Before starting a new Tomcat it tries to stop a previous one by sending a command to the shutdown port.

0.0.1 February 24, 2012

  • Initial version