Before you start

This tutorial is Part 1 of a two-part series that explains and demonstrates the integration of enterprise Web services into J2EE running on Geronimo.

About this series

This part of the series demonstrates the integration of service-consumer and service-provider Web services into the existing J2EE-based BookShop application. The second part of the series will demonstrate several additional aspects that are likely to be required when using enterprise Web services in Geronimo: security, attachments, registry access, and logging.

Back to top

About this tutorial

This tutorial will introduce you to some of the APIs required for the integration of Web services into a classic J2EE application. BookShop is a classic J2EE-based book-selling application that is deployed on Apache Geronimo, a J2EE 1.4-compliant application server. The original BookShop application lets customers search for books based on categories and is exclusively targeted at customers using a Web browser. Search results include the book title, author names, ISBN, description, and price in U.S. dollars. The application consists of a JavaServer Pages (JSP) component, a servlet, one session Enterprise JavaBean (EJB), and three entity EJBs that access a relational database. You'll learn how to extend BookShop by incorporating two J2EE-compliant Web services into the application -- one that delivers current exchange rates to let BookShop calculate book prices in multiple currencies and one that enables business-to-business (B2B) access by nonbrowser clients. The examples you'll work through demonstrate both service-consumer and service-provider scenarios.

The tutorial is structured as follows:

• Extending BookShop with JAX-RPC presents an architectural overview of the BookShop example, clarifying the impact on the original application of extending it with Web services. It also gives a brief conceptual overview of the Java APIs for XML-Based Remote Procedure Call (JAX-RPC) and its integration into Geronimo.
• Exposing Web services from BookShop demonstrates the steps required on the server side of the BookShop application to expose two Web services.
• Web services clients in BookShop shows two ways to access the two external Web services from the J2EE-based BookShop application. It also shows a Java 2 Platform, Standard Edition (J2SE) client application that can access the Web services -- the JAX-RPC service endpoints (JSEs) and EJB endpoints -- exposed by the extended BookShop application.
• Required deployment artifacts describes the deployment artifacts necessary for successful implementation of the extended BookShop application.
• BookShop in action covers deployment and testing of the BookShop application on both the client and server sides.

Back to top

Prerequisites

Java developers with prior experience in J2EE platform development are the primary audience for this tutorial. General knowledge of distributed programming concepts and the role of Web services in this context is beneficial but not required.

Back to top

System requirements

To run the example code in this tutorial, you need to perform the following steps:

1. Download and install the following applications and libraries:
   • The J2SE 1.4.2_08 SDK
   • Apache Geronimo M4 or higher
   • Apache Ant
   • Apache Axis 1.2.1
   • MySQL and MySQL Connector/J driver
   • Sun Java Web Services Developer Pack (Java WSDP)
2. Optionally, download and install the Eclipse SDK.
3. Make sure that the environmental variables in Table 1 are set in your shell.

4. Create a database called bookshopdb in MySQL, and then run the supplied database script (etc/bookshopdb.sql) to create and populate the required relational-database tables.
5. Create a folder in %GERONIMO_HOME%/repository/mysql/jars, and copy the mysql-connector-java-your_version_number.jar driver to this directory.
6. Edit the geronimo-ra.xml database deployment plan found in %PROJECT_HOME%/etc by updating your exact MySQL Connector/J driver name, username, password, and server name as required.
7. Edit the build.xml project to set the correct paths for your Geronimo and Axis installations. Also, look into %GERONIMO_HOME%/repository/tranql/rars and adjust the TranQL file name in the build.xml file accordingly.

1 of 10 | Next

Comments

Back to top

Table of contents

• Before you start
• Extending BookShop with JAX-RPC
• Exposing Web services from BookShop
• Web service clients in BookShop
• Required deployment artifacts
• BookShop in action
• Summary
• Download
• Resources
• About the author

---

1 of 10 | Next

Next steps from IBM

With the WebSphere Application Server you can benefit from the simplified EJB 3.0 development experience, new persistence model, and interceptors.

---

• Try: Download a free trial version of WebSphere Application Server Community Edition, the lightweight Java 5 application server with robust EJB 3.0 funtionality.
• Article: Learn how call patterns and components involved in making calls to EJB components deployed in the EJB container operate in WebSphere Application Server.
• Tutorial: This tutorials shows you how to create an enterprise J2EE application that implements both Plain Old Java Object (POJO) and EJB Web services endpoints.
• Demo: Watch this demo and learn how to configure and use the WebSphere Application Server and the Eclipse IDE with the Web Tool Project Platform.
• Buy: WebSphere Application Server

Dig deeper into Open source on developerWorks

Try IBM PureSystems. No charge.

Experience today!

---

Get started with the cloud-based trial and pattern development kit.