JHU Object-Oriented Software Engineering Course Homepage

J2EE Setup Tutorial

Version 1.5

Last Updated: September 24, 2011


This tutorial documents the process of setting up a relatively simple J2EE application in Eclipse using the following technologies:

The primary function for this tutorial is to serve as a starting point for small J2EE projects such as are found in academic environments. The end goal is to permit students to focus more on application logic implementation and less on the nuances of configuration for each of these valuable technologies.

Note that the screenshots accompanying these instructions were taken on a Debian Linux machine under KDE 4.4 in September 2011. Depending on your operating system or the version of your software, these screenshots may look somewhat or very different when compared to your own experience. It is also possible that pathnames may be in a different format; for instance, Windows users will need to use Windows-style pathnames. Please adjust these steps according to your environment as necessary.

Update: August 2012

This tutorial was tested again with the following technologies:

The tests were successful with only one caveat. When installing JBoss Tools, one should use the following update site: http://download.jboss.org/jbosstools/updates/development/juno The software packages to be installed are JBoss Application Development and JBoss Web and Java EE Development. Other than this adjustment, the remainder of the tutorial should work fine.

It should be emphasized that this tutorial will not work with JBoss 7.0 or JBoss 7.1. These JBoss versions have been tested; they fail to deploy the application and produce errors which are difficult to diagnose at best.

Table of Contents

  1. Requirements
  2. Install JBoss Tools
  3. Add Server Runtime to Eclipse
  4. Configure an Application Server
  5. Create an Enterprise Application Project
  6. Copy Necessary Dependencies
  7. Configure Project Dependencies
  8. Deploy the Enterprise Application
  9. Configure Spring
  10. Creating a Simple Page
  11. Using Form Beans
  12. Creating Service Beans
  13. Persistence
  14. Data Retrieval
  15. Further Reading

Written by Zachary Palmer with help from Varun Sharma. Corrections and suggestions are welcome; please e-mail zachary dot palmer xX att Xx jhu.edu