Vishal Rajpal

About Vishal Rajpal

Vishal enjoys designing and developing small and mid-sized Enterprise solutions in Java and it's ecosystem. He has graduated from RGTU, India in Electronics and Telecommunication Engineering. Currently, Vishal is working with an Analytics organization, enabling the in-house analytics as well as client teams to use technology as a differentiator for projects / problems related to Big Data.

Eclipse Tomcat plugin tutorial

In this tutorial, we will learn to configure and use the Tomcat Plugin for Eclipse.

Although there are a few tomcat plugins available, but we will specifically use the Sysdeo Tomcat plugin as part of this tutorial. Sysdeo Tomcat plugin offers the following advantages:
 
 
 
 
 
 

  1. Sysdeo Tomcat Launcher plugin has been one of the most widely accepted and stable tomcat plugins.
  2. Plugin availability for Eclipse 3.1 to 4.3 with Tomcat 7 support since January 2011.
  3. Recently released plugin for Eclipse 4.4 in June 2014.
  4. Provides some salient features for ease of development / debugging, such as:
    • Convenient starting and stopping Tomcat
    • Capability to debug web application as a stand-alone JVM process
    • Exporting a Tomcat project to a WAR File
    • Adding Java Projects to Tomcat classpath
    • Setting Tomcat JVM parameters, classpath and bootclasspath
    • Capability to use a custom Tomcat classloader to load classes in several java projects at the same classloader level.

Pre-requisites

The installation, configuration and usage steps described in the tutorial have been implemented on:

  1. Ubuntu 14.04 LTS Trusty
  2. Eclipse 4.3 Kepler
  3. JDK 1.7 (1.7.0_55)
  4. Tomcat 7

You will need Eclipse, Java and Tomcat downloaded and installed before using the Sysdeo Tomcat plugin.

The following tutorial is divided into three parts:

  1. Download and Installation of Sysdeo Tomcat Plugin
  2. Configuration of the Plugin
  3. Configuring the Web project and using the Plugin

Download and Installation

NOTE: We could have used the Eclipse Market Place to install the plugin, but as experienced and mentioned by a number of fellow users, the eclipse market place installation of the plugin doesn’t work that well and thus, in turn the web projects are not configured correctly to use the Tomcat plugin. Hence, we use the manual approach to install the plugin.

  1. Download the Sysdeo Plugin
  2. Go to: Sysdeo Downloads Page
    Download the zip for the version 3.3. Please use V3.3.1 in case you are using Eclipse 4.4.

    Sysdeo plugin downloads page

    Sysdeo plugin downloads page

    Do read the release-notes for an idea of the features added to the plugin.

  3. Install the Sysdeo Tomcat Plugin
  4. Once the tomcatPluginV33.zip is downloaded, manually install the plugin to eclipse.

    Unzip the zip file in :

    • $ECLIPSE_INSTALLATION/dropins for Eclipse 3.4, 3.5, 3.6, 4.3
    • $ECLIPSE_INSTALLATION/plugins for Eclipse 2.1, 3.0, 3.1, 3.2 and 3.3
    vishal@l-mc-ul14:~/eclipse/dropins$ ls
    com.sysdeo.eclipse.tomcat_3.3.0
    
  5. Provide DevLoader jar to Tomcat
  6. For version 3.3, copy the DevloaderTomcat7.jar (for Tomcat 7) OR DevLoader.zip (other Tomcat versions) to the $TOMCAT_HOME/lib folder.
    The DevLoader.jar is available in the zip for the Sysdeo Plugin downloaded in step 1.
    This jar contains the classes for helping load the classes of the web project hypothetically in the tomcat webapp

  7. Re-start Eclipse
  8. It is recommended that after copying the plugin zip to the eclipse directory, please use option -clean while restarting eclipse. This will help the plugin be evaluated by eclipse and installed correctly.

    After eclipse is started, there would be three icons available in the toolbar –
    Start, Stop and Re-start Tomcat as shown in image below. This will confirm that the plugin is installed correctly.

    Tomcat Plugin start/stop toolbar buttons

    Tomcat Plugin start/stop toolbar buttons

    Note: If Tomcat icons are not shown in toolbar as shown above, select Menu –> Window –> Customize Perspective –> Commands and Availability Groups’, and check the ‘Tomcat’ checkbox.

Configure the Tomcat Plugin

The next step is to configure Tomcat server to be used by the plugin.

If you have not downloaded Tomcat Server, use the Tomcat Downloads Page and unzip it for installation.

Go to Menu –> Windows –> Preferences –> Tomcat

  1. Attach Tomcat Server
  2. Select the Tomcat version of your choice and provide the directory where the tomcat installation (unzip version) is available.

    Provide the Context Declaration Mode as Context Files. We have used a context files directory here so that we can use the same tomcat server for multiple web projects to be deployed and enable their debugging. If you have a single web project and do not intend to deploy multiple web projects on the same tomcat, then you can use the context entry in server.xml directly.

    Sysdeo Tomcat plugin configuration

    Sysdeo Tomcat plugin configuration

  3. Advanced – Configure Tomcat Base
  4. This would help in customizing any tomcat server configuration properties for specifically the plugin. It would not impact the original tomcat installation that you still might want to use as a container outside of eclipse OR without the plugin.

    As a user, you can copy and create your own Tomcat base for the plugin to use while launching tomcat server.

  5. JVM settings
  6. Configure the Advanced Tomcat Settings while starting the Tomcat, for example JRE, JVM Parameters and the like based on your requirement.

    Tomcat Plugin Advanced Configuration

    Tomcat Plugin Advanced Configuration

Creating, configuring a web project and using the plugin

Here, we have created a simple web project using the maven webapp archetype. A new servlet TestPluginServlet has been created, which would have some lines of code in the doGet method. We intend to deploy the web project using the Sysdeo Tomcat plugin and then place a breakpoint in the doGet method of the servlet. On receiving a servlet request, the breakpoint should be reached in eclipse, thus enabling debugging of the container code.

Servlet code (breakpoint attached)

Servlet code (breakpoint attached)

The next step is to configure the project with the plugin, so that the project can be deployed on Tomcat.
Go to: Right click Project –> Properties –> Tomcat and configure the following:

  • the Context path for the web project
  • allow update to context.xml
  • set context as reloadable to “true”
  • subdirectory to set as Web application root as appropriate, we have set it to /src/main/webapp per maven hierarchy
Web Project configuration to deploy using Sysdeo Tomcat Plugin

Web Project configuration to deploy using Sysdeo Tomcat Plugin

The next step is to configure the DevLoader to load Web project classes with the Tomcat container. Select options as applicable.

Sysdeo Tomcat Plugin DevLoader configuration

Sysdeo Tomcat Plugin DevLoader configuration

Once the project is set up for the plugin usage, a new context file for the project is generated in the directory as mentioned in step 2 while configuring the context directory for the plugin.

  1. Start the tomcat server using the toolbar button.
  2. Invoke the servlet by sending a request over url.
  3. http://localhost:8080/testPluginContext/TestPluginServlet

  4. Verify that the breakpoint is hit in eclipse as shown below.
  5. Debugging using Sysdeo Tomcat Plugin

    Debugging using Sysdeo Tomcat Plugin

  6. Resume debug execution and the servlet response is received on the browser.
  7. Response on the web browser

    Response on the web browser

    The servlet example project used is available for download here.

Do you want to know how to develop your skillset to become a Java Rockstar?

Subscribe to our newsletter to start Rocking right now!

To get you started we give you two of our best selling eBooks for FREE!

JPA Mini Book

Learn how to leverage the power of JPA in order to create robust and flexible Java applications. With this Mini Book, you will get introduced to JPA and smoothly transition to more advanced concepts.

JVM Troubleshooting Guide

The Java virtual machine is really the foundation of any Java EE platform. Learn how to master it with this advanced guide!

Given email address is already subscribed, thank you!
Oops. Something went wrong. Please try again later.
Please provide a valid email address.
Thank you, your sign-up request was successful! Please check your e-mail inbox.
Please complete the CAPTCHA.
Please fill in the required fields.
Examples Java Code Geeks and all content copyright © 2010-2014, Exelixis Media Ltd | Terms of Use | Privacy Policy | Contact
All trademarks and registered trademarks appearing on Examples Java Code Geeks are the property of their respective owners.
Java is a trademark or registered trademark of Oracle Corporation in the United States and other countries.
Examples Java Code Geeks is not connected to Oracle Corporation and is not sponsored by Oracle Corporation.
Do you want to know how to develop your skillset and become a ...
Java Rockstar?

Subscribe to our newsletter to start Rocking right now!

To get you started we give you two of our best selling eBooks for FREE!

Get ready to Rock!
You can download the complementary eBooks using the links below:
Close