Configuring Eclipse to use Tomcat and the Spring Framework

Installation

1. Download Eclipse IDE for Java EE Developers 3.4 Ganymede from the downloads section of the Eclipse web site.
2. Extract the eclipse-jee-ganymede-win32.zip into c:\Java\eclipse.
3. Create a desktop shortcut to the Eclipse executable, for easy launching.
4. Download Tomcat 6.x from the downloads section of the Tomcat web site.
   
5. Launch Eclipse.
6. On a new install of Eclipse it asks you where you want to put your workspace.
   
7. Next we are going to install Spring IDE.
8. Restart Eclipse.
   

Installing Spring IDE

1. From the menu: Help->Software Updates
2. Click Add site…
3. Enter the the Spring IDE update site url: http://springide.org/updatesite/site.xml
4. Click Ok
5. Check the box next to Sprint IDE Update Site
6. Expand Sprint IDE Update Site
7. Expand Dependencies
8. Uncheck Spring IDE Dependencies (only for Eclipse 3.2.x)
9. Expand Integrations
10. Uncheck Spring Mylyn Integration (optional)
11. Click Install
12. Screen will show no unresolved dependencies
13. Click Next >
14. Select I accept the terms of the license agreement
15. Click Finish .

Configure Tomcat inside Eclipse
Next we need to tell Eclipse about which Tomcat we are using and set up the integration.

1. From the menu bar select Window->Preferences.
2. The Preferences window will open. Expand Server.
3. Highlight Runtime Environment. This is the place where you can tell Eclipse about where you put your Tomcat installation.
4. Click Add.
5. Expand Apache and select Apache Tomcat v6.0.
6. Check the Create a new local server check box to create a new server in the Servers view.
7. Click Next.
8. Leave the Name of the server set to Apache Tomcat v6.0.
9. Eclipse gives the option to download a version of Tomcat but it usually does not have the latest version (which is why we downloaded it separately). Click Browse and navigate to c:\java\tomcat and click Ok.
10. Leave the JRE drop down set to Workbench default JRE.
11. Click Finish.
12. You are taken back to the Server Runtime Environments preference page so click Ok.
13. A new project will have been created and if you go into the Servers view (in the bottom set of tabs), you will see a new server Apache Tomcat v6.0 at localhost.

Create project
There are several different types of project in Eclipse and we need the one that will allow us to integrate all the things we need.

1. Select File->New->Dynamic Web Project
2. Enter a Project name. Although you can have spaces, in my opinion, it’s best not to put any in. The project name becomes the directory name and for the same reason as above it’s a pain if there are spaces.
3. The Target Runtime should already be set to Apache Tomcat v6.0.
4. Also keep the Configuration set to Default Configuration for Apache Tomcat v6.0.
5. Click Finish.
6. In the Project Explorer, right click on the new project and select Spring Tools->Add Spring Project Nature.

Spring Web project and Tomcat project association
We must now associate the project with Tomcat.

1. Make sure the Servers view is visible (in the bottom set of tabs). Highlight your new Spring Web project and drag it on to the Tomcat v6.0 Server at localhost entry in the Servers tab.
2. We want to use the Tomcat server when we use our new project, so we can set the Server project to be a dependency of our new project. This will mean that when we open our project the Server project will open automatically.
3. Right click on our project and select Properties.
4. Select the Project References option and check the Servers project.
5. Click Ok.