Welcome!

Eclipse Authors: Pat Romanski, Elizabeth White, Liz McMillan, David H Deans, JP Morgenthal

Related Topics: Eclipse

Eclipse: Article

Creating Web Applications with the Eclipse Web Tools Project

Using open source to develop Web applications, EJBs, and Web services

The Web Tools Project (WTP) by the Eclipse Foundation is a set of open source tools that substantially reduce the time required for the development of Web applications, EJBs, and Web services. The WTP's current version is 0.7.1 and version 1.0 is coming later this year. The framework provides wizards and tools to create EJBs, Web components such as servlets and JSPs, and Web services using the Axis engine. It also provides source editors for HTML, JavaScript, CSS, JSP, SQL, XML, DTD, XSD, and WSDL; graphical editors for XSD, WSDL, J2EE project builders, models, and a J2EE navigator; a Web service wizard, explorer, and WS-I Test Tools; and database access, query tools, and models.

In this article I'll show you how to develop and deploy a JSP Web application with WTP in less than an hour. I'll also cover the creation and deployment of a basic servlet and editing JSP with WTP. Let's develop the WTP application together but, first, we need to install the following software:

  1. J2SE 5.0 JRE: http://java.sun.com/j2se
  2. Eclipse 3.1: www.eclipse.org
  3. WTP 0.7.1: www.eclipse.org/webtools
  4. Tomcat 5.0: http://jakarta.apache.org/tomcat/
  5. MySQL 4.0.25: www.mysql.com
  6. MySQL Connector/J Driver 3.1: www.mysql.com/products/connector/j/

Application Overview
Our application will be a basic Web application implementing the following use cases:

  • Customers need to register on the site to place orders.
  • Customers can place orders.
  • Customers can view their orders.
  • Admin can list all registered customers.

The system will be implemented using a servlet programming model and MySQL database.

Configuring MySQL Database and the Data Source
By default, when MySQL gets installed, a TEST database is available. Be sure to launch C:\Mysql\winmysqladmin.exe to specify the user name and password (the first time you launch it, it lets you do it and also starts the database server). It's necessary to copy MySQL Connector/J JDBC Driver: mysql-connector-java-3.1.10-bin.jar to the Tomcat/common/lib directory, so the Tomcat server can recognize it.

To configure MySQL database access in Tomcat, we have to add a separate file called Listing 1: DBTest.xml; the file follows a convention of "application_name.xml" under $TOMCAT\conf\catalina\localhost directory. The only problem with this file is that it may get deleted when the application is undeployed, so if you undeploy and redeploy the application, you have to place this file into the same folder again (so it's a good idea to save it somewhere else). Looking inside the DBTest.xml file, please note that in our case we are using "ODBC" for the username and don't provide any password.

Building Our Web Application Using Web Tools and a Database
Before we can start working on the Web project, we must configure Tomcat 5.0 in Eclipse to be our default server. When Web Tools are installed in Eclipse, new perspectives and options are added, such as a J2EE perspective where you can create J2EE projects, Web projects, and Web services. New options are available under the Window-Preferences menu for configuring Tomcat servers with Eclipse. Go to Window - Preferences menu, under Server select - Installed Runtimes, click Add, and then specify Tomcat 5.0 server with the installed JRE and a path to the Tomcat installation directory (see Figure 1). Now create a Dynamic Web Project using the Web Tools wizard by selecting File-New-Other, then expanding Web-Dynamic Web Project.

We'll name the project DBTest, which will also become its context root. The Web module will be targeted to our default server: Tomcat. Click Finish and the DBTest Web project gets created. This project will contain all of our Web resources, such as HTML and JSP files, and servlets, and you'll be able to export it into a standard WAR file later, if needed.

Creating Supporting Domain Classes and Tables
Before creating servlets, let's create supporting classes to represent a customer and an order. The class diagram in Figure 2 depicts the Customer and Order relationship.

Note that when creating Customer and Order classes, we define corresponding fields as their public instance variables and then can automatically generate getters and setters from those fields. This can be easily done by going to Outline view (appears after you double-click on an existing class name or create a new class), selecting a class, and selecting "Source - Generate Getters and Setters..." from the right-button menu (see Figure 3).

Along with the classes, we'd have to create corresponding database tables in a MySQL database:


CREATE TABLE CUSTOMER (
ID INT PRIMARY KEY,
FIRST_NAME VARCHAR(50),
LAST_NAME VARCHAR(50),
ADDRESS VARCHAR(150));

CREATE TABLE ORDERS (
ID INT PRIMARY KEY,
CUST_ID INT REFERENCES CUSTOMER,
DATE_PLACED DATE,
AMOUNT INT);

Creating Database Command Classes
We'll create a special package with classes that implement a Command design pattern to perform necessary database updates. The Command pattern allows the classes to implement the common interface executing some particular command. Examples of the Command pattern in Java would be classes that implement the ActionListener interface with the actionPerformed() method. Our Command pattern interface for database integration is presented in Listing 2.

Classes implementing this command will be performing the actual database operations for reading and inserting rows into customer and order tables. The following use cases will be addressed:

  • Customers want to register on the site in order to place orders (a new row is created in the customer table)
  • Customers can place the order (the order gets created in the database for a particular customer)
  • Customers can view the orders they have placed
  • Admin can list all the customers

Based on these use cases, the following classes have implemented the DatabaseCommand interface (see Listings 3-6):

public class CreateCustomer implements DatabaseCommand
public class CreateOrder implements DatabaseCommand
public class ListCustomers implements DatabaseCommand
public class ListCustomerOrders implements DatabaseCommand

Finally, in order to execute our command classes, we will need to create a class that would access the database datasource, obtain a SQL connection, and then execute a particular database command. This class will implement a Singleton design pattern, which we'll call CommandExecutor:

Object o = CommandExecutor.getInstance().executeDatabaseCommand
(<<instance of the particular database command class goes here>>).

The CommandExecutor class will perform the datasource lookup as follows:

InitialContext ctx = new InitialContext();
Context envCtx = (Context) ctx.lookup("java:comp/env");
ds = (DataSource) envCtx.lookup("jdbc/TestDB");

This finds the reference to the data-source we have defined in DBTest.xml by resolving its reference in a Web deployment descriptor (web.xml), which we'll define in a section below. Listing 7 has the complete code of the Command Executor class.

More Stories By Boris Minkin

Boris Minkin is a Senior Technical Architect of a major financial corporation. He has more than 15 years of experience working in various areas of information technology and financial services. Boris is currently pursuing his Masters degree at Stevens Institute of Technology, New Jersey. His professional interests are in the Internet technology, service-oriented architecture, enterprise application architecture, multi-platform distributed applications, and relational database design. You can contact Boris at [email protected]

Comments (15) View Comments

Share your thoughts on this story.

Add your comment
You must be signed in to add a comment. Sign-in | Register

In accordance with our Comment Policy, we encourage comments that are on topic, relevant and to-the-point. We will remove comments that include profanity, personal attacks, racial slurs, threats of violence, or other inappropriate material that violates our Terms and Conditions, and will block users who make repeated violations. We ask all readers to expect diversity of opinion and to treat one another with dignity and respect.


Most Recent Comments
Mintara 12/26/07 04:11:21 PM EST

Hello Sir,
Could you please elaborate (for e.g the classes ..I could not find the source code)what you have explained.
Thank you.

Serge Cambour 09/25/07 06:38:15 AM EDT

It would be really a very good article or a tutorial if the author had tested it himself before posting it. I don't even talk of missing details, classes, code mistakes, ets. that make you loose any wish to continue.

Keith Freeman 07/15/06 10:32:01 PM EDT

Well, this seems like a fantastic tutorial, until suddenly the "CreateCustomerServlet" description morphs into a "ListCustomersServlet". We're left to figure out how to finish the servlets ourselves (still in progress for me), since as others point out here a bunch of code is missing from the zip file download. VERY disappointing after such a strong start.

David Paules 05/24/06 04:04:22 PM EDT

Good introduction article. Unfortunately, it's not clear where the database connection file DBTest.xml should reside when running Tomcat under Eclipse. Where does this file or it's content go in the Dynamic Web project tree? Because of this, I get an error message at debug time:

javax.servlet.ServletException: Cannot create JDBC driver of class '' for connect URL 'null'

Chuck Ferrick 05/20/06 09:24:58 PM EDT

I was very interesting article, but most of the listings where not posted. I was hoping to gain some insight on how you configure Hibernate. Your article stated to look at listing 9, but listing 9 was know where to be found. I was also frustrated when I could not find the DBTest.war file on java.sys-con web site.

Good furture article and maybe next time JDJ will include all of the necesasry file listings.

Achille Komla 02/05/06 10:57:41 PM EST

Very well done. It will be good to see how the application works with hibernate.

Daniel Hillebrand 12/15/05 04:35:56 AM EST

Hi Boris,

thank you for your great tutorial! Maybe you could add a note to your article regarding running Tomcat in eclipse:

You have to put the content of DBTest.xml in the (new) file context.xml in "WebContent/META-INF". The path strings are not needed, except the "path" string.

regards, Daniel

Bill Gercken 12/09/05 09:02:38 AM EST

Soource code: For those who did not find it: the link to the source is at the top of listing 1. View link: http://res.sys-con.com/story/nov05/152270/source.html

km 12/07/05 03:41:46 PM EST

could you provide the link for the source code

Paul Mischler 12/05/05 04:39:16 PM EST

Did anyone notice that listings 3-10 aren't included in the dead-tree edition?

Corrections to the article:

For the code to work "out of the box", the Customer and Order classes need to be created in a package called "domain"

Figure 2 shows "cust_id" as a member of the Order class. However, the image of Figure 3 (and the CreateOrder class sample code) utilize "custId".

A helpful reminder that a user with permissions to access the database tables would have been helpful.

CS Cassell 12/02/05 10:01:30 AM EST

Several of the links are broken. This could be a really good article but ones needs the various links to work correctly.

José D´Andrade 12/01/05 09:11:56 AM EST

Please, think Linux. Think about Linux users when writing articles about developing whatever using:

Eclipse
Apache
Tomcat
MySQL

It is confusing to read about things that perhaps only apply to MS Windows (¨be sure to launch C:\Mysql\winmysqladmin.exe ¨) when the tools are mostly used by Linux people. And, this is not religion.

At least, write referencing both OSs.

José D´Andrade 12/01/05 09:10:40 AM EST

Please, think Linux. Think about Linux users when writing articles about developing whatever using:

Eclipse
Apache
Tomcat
MySQL

It is confusing to read about things that perhaps only apply to MS Windows (¨be sure to launch C:\Mysql\winmysqladmin.exe ¨) when the tools are mostly used by Linux people. And, this is not religion.

At least, write referencing both OSs.

Bill Dornbush 11/29/05 03:16:26 PM EST

Where is the source code for the article? I can't find any for this issue of the magazine at java.sys-con.com

IoT & Smart Cities Stories
The challenges of aggregating data from consumer-oriented devices, such as wearable technologies and smart thermostats, are fairly well-understood. However, there are a new set of challenges for IoT devices that generate megabytes or gigabytes of data per second. Certainly, the infrastructure will have to change, as those volumes of data will likely overwhelm the available bandwidth for aggregating the data into a central repository. Ochandarena discusses a whole new way to think about your next...
CloudEXPO | DevOpsSUMMIT | DXWorldEXPO are the world's most influential, independent events where Cloud Computing was coined and where technology buyers and vendors meet to experience and discuss the big picture of Digital Transformation and all of the strategies, tactics, and tools they need to realize their goals. Sponsors of DXWorldEXPO | CloudEXPO benefit from unmatched branding, profile building and lead generation opportunities.
DXWorldEXPO LLC announced today that Big Data Federation to Exhibit at the 22nd International CloudEXPO, colocated with DevOpsSUMMIT and DXWorldEXPO, November 12-13, 2018 in New York City. Big Data Federation, Inc. develops and applies artificial intelligence to predict financial and economic events that matter. The company uncovers patterns and precise drivers of performance and outcomes with the aid of machine-learning algorithms, big data, and fundamental analysis. Their products are deployed...
All in Mobile is a place where we continually maximize their impact by fostering understanding, empathy, insights, creativity and joy. They believe that a truly useful and desirable mobile app doesn't need the brightest idea or the most advanced technology. A great product begins with understanding people. It's easy to think that customers will love your app, but can you justify it? They make sure your final app is something that users truly want and need. The only way to do this is by ...
Digital Transformation and Disruption, Amazon Style - What You Can Learn. Chris Kocher is a co-founder of Grey Heron, a management and strategic marketing consulting firm. He has 25+ years in both strategic and hands-on operating experience helping executives and investors build revenues and shareholder value. He has consulted with over 130 companies on innovating with new business models, product strategies and monetization. Chris has held management positions at HP and Symantec in addition to ...
Dynatrace is an application performance management software company with products for the information technology departments and digital business owners of medium and large businesses. Building the Future of Monitoring with Artificial Intelligence. Today we can collect lots and lots of performance data. We build beautiful dashboards and even have fancy query languages to access and transform the data. Still performance data is a secret language only a couple of people understand. The more busine...
Cell networks have the advantage of long-range communications, reaching an estimated 90% of the world. But cell networks such as 2G, 3G and LTE consume lots of power and were designed for connecting people. They are not optimized for low- or battery-powered devices or for IoT applications with infrequently transmitted data. Cell IoT modules that support narrow-band IoT and 4G cell networks will enable cell connectivity, device management, and app enablement for low-power wide-area network IoT. B...
The hierarchical architecture that distributes "compute" within the network specially at the edge can enable new services by harnessing emerging technologies. But Edge-Compute comes at increased cost that needs to be managed and potentially augmented by creative architecture solutions as there will always a catching-up with the capacity demands. Processing power in smartphones has enhanced YoY and there is increasingly spare compute capacity that can be potentially pooled. Uber has successfully ...
SYS-CON Events announced today that CrowdReviews.com has been named “Media Sponsor” of SYS-CON's 22nd International Cloud Expo, which will take place on June 5–7, 2018, at the Javits Center in New York City, NY. CrowdReviews.com is a transparent online platform for determining which products and services are the best based on the opinion of the crowd. The crowd consists of Internet users that have experienced products and services first-hand and have an interest in letting other potential buye...
When talking IoT we often focus on the devices, the sensors, the hardware itself. The new smart appliances, the new smart or self-driving cars (which are amalgamations of many ‘things'). When we are looking at the world of IoT, we should take a step back, look at the big picture. What value are these devices providing. IoT is not about the devices, its about the data consumed and generated. The devices are tools, mechanisms, conduits. This paper discusses the considerations when dealing with the...