Run Your First Servlet

Step 1 Create New Dynamic Web Project

Step 1.1 Create New Project

Go to File->New->Others… Select Dynamic Web Project under Web category then click Next. Type ServletDemo or whatever name you want in the Project name field.

Step 1.2 Configure Target Runtime

  • Click New Runtime… button under Target Runtime.
  • Select Apache Tomcat v7.0. Click Next.
  • Click Browse button to specify Tomcat Server installation directory. The select the folder then click Ok.
  • Click Installed JREs… button to add/remove or edit JRE definition. Remove existing one; then click Add button to configure new one. Select Standard VM; then click Next. Click Directory button to select the root folder of JDK installation. Select the folder then click Ok. Click Finish.
  • Check the JDK then click Ok.
  • Change JRE to the JDK then click Finish.
  • Click Finish the finish the project creation.

Step 2 Create New Servlet

  • Right click to the project, select New -> Servlet from the menu.
  • In Java package, enter info.java.tips.servlet.
  • In Class Name, enter HelloServlet.
  • Click Finish.

Eclipse IDE will generate some boilerplate code. We just remove all unnecessary one and keep only doGet method and and some simple code snippet to print text message to browser:

Tips: you simply copy the above code; select the project or src folder then paste. Eclipse will automatically generate package & class file for you.  Press CTRL + S to save the file.

Step 3 Clean & Build

Clean & build the project to clean old classes file (if any) & force the IDE to recompile java code.

  • Go to Project on menu bar; select Clean…
  • Select Clean all projects (default)
  • Click Ok to proceed clean & build.

Step 4 Configure Tomcat

Select Servers window; in case it’s not there, go to Windows -> Show View-> Others… Select Server -> Servers; then click Ok.

If this is the first time you are creating a server, in the Servers area you will see a link as No servers are available click this link to create a new server. Click the link.

Define a New Server window will be opened, In Select the server type. Select Apache -> Tomcat v7.0 Server. Then click Finish.

Step 5 Deploy The Application

  • Right click to the Tomcat Server select Add and Remove.
  • Move the application (ServletDemo) from Available column to Configured. Then click on Finish to deploy it to tomcat server.

Step 6 Start Tomcat Server

Right click on the tomcat server and choose Start or simply click on the green start icon to start the server.

Step 7 Run The Servlet

We assume that you install tomcat on default port (8080) and project name is ServletDemo. Open web browser and type:

http://localhost:8080/ServletDemo/HelloServlet

Output

Note: by default Eclipse wizard will generate an annotation servlet which we will mention later in this tutorial. Take a look on the declaration right above class signature:

Servlet path is registered there (/HelloServlet).

The URL is the combination of http://{your application context path}/{servlet path}

Context path is located in server.xml under Project Explorer -> Servers.