Installing Apache Tomcat 6 and using it with Eclipse to create and run a java servlet  By Doug Twitchell (See license information at end of document)  1. Download Tomcat 6 from http://tomcat.apache.org/download‐60.cgi  2.

Download the Windows Service Installer 

  3. Run the Windows Service Installer   4. Remember this directory: 

    5. Input an admin  password and REMEMBER it  6. If you get this warning: 

  You likely have another Tomcat installation.  Remove it.  If you don’t want to, use this command  to remove the service so the new service can be installed:   

ServiceEnum.exe /deleteService <name>    7. Don’t start the Tomcat Service.  Eclipse will do this later for us.  8. Ensure that you have the Web Tools Platform plugin installed in eclipse.   a. Go to File   new…   b. If you have web tools already installed, you should find the web folder as shown below: 

    c. If they are not there, you need to install them.  To install do the following:  i. Go to Help   Software Updates   Find and Install…   ii. Choose “Search for new features to install” 

    iii. From the list of update sites, choose the “Europa Discovery Site” 

    iv. After clicking Finish, it will ask you to choose from some mirrors.  Georgia Tech  is a good one to choose.  From there choose  “Web and J2EE development”. 

    v. It will say that some other packages are required.  Choose “Select Required“  to  have eclipse automatically select what is needed. 

    vi. Click Next, accept the license, and continue clicking Next until only Finish is  available and click it to start the download.    vii. When the download is finished click Install All to start the installation.    viii. Confirm that you want to restart eclipse    9. Once you have the Web Tools Platform installed, in eclipse, create a new project.  The Project  type should be “Dynamic Web Project” which is one of the choices shown in the graphic in step  7b above.    10. Give the project a name.  We also need to give the project a “Target Runtime.” This is the web  server that we will be publishing our web application to, which, in our case, is Tomcat 6.0.  Click  “new..” to create a new target runtime (see screenshot below).  On subsequent projects, you’ll  be able to choose the target runtime we create in this step from the dropdown box. 

    11. Choose Apache Tomcat v6.0 and indicate that you would like to create a new local server. 

  12. Use the Browse button to choose the installation directory of Tomcat and click Finish. 

    13. Back at the New Dynamic Web Project dialog, click finish to create the project with everything  else as default.  You should see the following in your project explorer: 

    14. Right‐click on your web project, choose new, and choose to create a new Servlet: 

    15. Give it a name and hit finish 

    16. Create your servlet with the code below: 

import import import import import

java.io.IOException; java.io.PrintWriter; javax.servlet.ServletException; javax.servlet.http.HttpServletRequest; javax.servlet.http.HttpServletResponse;

/** * Servlet implementation class for Servlet: HelloWorld * */ public class HelloWorld extends javax.servlet.http.HttpServlet implements javax.servlet.Servlet { //ignore this constant, but keep it in static final long serialVersionUID = 1L; /** * Simple default constructor */ public HelloWorld() { super(); } /** * The init method is called when the servlet is first created * on the web server. You can use this method to connect to databases, * open files, or other one-time tasks that will be open during the life * of the servlet */ @Override public void init() throws ServletException { //this happens once in when the servlet is first loaded super.init(); } /* * This is where most of the action happens. GET is the command used by web browsers * to access pages on a web server. */ protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { //First we get a writer we can use to write to the stream that will be //shown in the user's browser PrintWriter out = response.getWriter(); //we need to tell the browser what kind of content we are sending //in this case html response.setContentType("text/html"); //Another way to tell the browser what we are sending, but //this is more specific on the kind of html being used \ String docType = "<!DOCTYPE HTML PUBLIC \"-//W3C//DTD HTML 4.0 Transitional//EN\">\n"; //print it to the browser! out.println(docType); //open our html document give it a title, which is in the header //also open the body, which is what the user actually sees out.println("<HTML>" + "<HEAD>" + "<TITLE>A Page</TITLE>" + "</HEAD>" + "<BODY>"); //our web page content! out.println("Hello World"); //close the body and the html page out.println("</BODY>" + "</HTML>"); } /* Use this method if you want to do something different when an * http POST is sent to the server. This is often done when using * html forms. */ protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { doGet(request, response); } }

      17. Run your servlet by choosing Run   Run as   Run on server   a. Leave the defaults and click Finish to run it 

    18. Note:  Tomcat must not be running outside of eclipse when you do this.  Eclipse will start the  server itself.  If the server is running, stop it using the icon in the system tray.  19. You’ll see your web page displayed in Eclipse’s internal web browser.  To see it in another  browser, copy the URL from the eclipse browser to the browser of your choice.  You should see  the same output there.  20. From now on, as you make changes, when you save those changes, they will be automatically  updated on the server.  Sometimes, however, the automatic update doesn’t work.  If you don’t  think it did, go to the server tab at in the bottom part of the eclipse workspace, right‐click on the  server and choose Restart. 

    21. Done    This work is licensed under the Creative Commons Attribution‐Share Alike 3.0 United States License. To  view a copy of this license, visit http://creativecommons.org/licenses/by‐sa/3.0/us/ or send a letter to  Creative Commons, 171 Second Street, Suite 300, San Francisco, California, 94105, USA.