This tutorial will walk you through building and developing the jax-ws calculator that ships with the samples package for Geronimo. After completing this tutorial, you should be able to understand how to build simple web services with Apache Geronimo 2.1 using the Eclipse development environment

To run this tutorial, as a minimum you will be required to have installed the following prerequisite software.

Sun JDK 5.0+ (J2SE 1.5)
Eclipse 3.3.1.1 (Eclipse Classic package of Europa distribution), which is platform specific
Web Tools Platform (WTP) 2.0.1
Data Tools Platform (DTP) 1.5.1
Eclipse Modeling Framework (EMF) 2.3.1
Graphical Editing Framework (GEF) 3.3.1

Details on installing eclipse are provided in the Development environment section. This tutorial is organized in the following sections:

The application development will take you through the following

Setting Eclipse for Application Development

Create a Dynamic Web Project
- Select File -> New, select Other...
- In the popup window select Web->Dynamic Web Project category and click NEXT.
- Type in jaxws-calculator as the Project name: and select Next
- On the next screen check the box for Axis2 Web Services
- Make sure Generate Deployment Descriptor is selected and click Next.
- Modify the Group Id to: org.apache.geronimo.samples.jws and Artifact Id: to Calculator.
  
  Useful Information
  
  Group ID: A name that identifies the group of a module. The default value is default.
  Artifact ID: A name of the module in a group. The default value is <blank>.
  Version: The version of module. The default value is 1.0
  Type: The type of module, such as system module (car), jar module (jar), web
  archive (war), enterprise archive (ear), and so on. The default value is car
  A module is stored inside a repository as repository/groupId/artifactId/version/artifactIdversion.
  type. This repository structure gives a more standardized and easily maintainable
  structure to Geronimo applications.
- Select Finish.
  Warning
  
  Depending upon your environment, you may see the error message "Failed while installing Axis2 Web Services Core 1.1". Do not worry. We will just have to manually point Axis2 to the installation directory of Apache Geronimo to fix this error.
AXIS2 Configuration
- Select Window->Preferences.
- Select Web Services->Axis2 Preferences.
- Under Axis2 Runtime tab, browse to the installation root of Apache Geronimo. Select Ok.
  
  This completes the configuration of Eclipse for application development.

Define the wsdl for the web service

Right Click on the WebContent/WEB-INF subfolder and Select New->Other.
Select Web Services->wsdl and click Next.
Give the File name as CalculatorService.wsdl and click Next.
On the next window give the Target namespace as "http://jws.samples.geronimo.apache.org". Select Finish.

Modify the CalculatorService.wsdl as follows

CalculatorService.wsdl

<wsdl:definitions name="Calculator"
xmlns="http://schemas.xmlsoap.org/wsdl/"
xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
targetNamespace="http://jws.samples.geronimo.apache.org"
xmlns:tns="http://jws.samples.geronimo.apache.org">
<wsdl:types>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns="http://jws.samples.geronimo.apache.org"
targetNamespace="http://jws.samples.geronimo.apache.org"
attributeFormDefault="unqualified"
elementFormDefault="qualified">
<xsd:element name="add">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="value1" type="xsd:int"/>
<xsd:element name="value2" type="xsd:int"/>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
<xsd:element name="addResponse">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="return" type="xsd:int"/>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
</xsd:schema>
</wsdl:types>
<wsdl:message name="add">
<wsdl:part name="add" element="tns:add"/>
</wsdl:message>
<wsdl:message name="addResponse">
<wsdl:part name="addResponse" element="tns:addResponse"/>
</wsdl:message>
<wsdl:portType name="CalculatorPortType">
<wsdl:operation name="add">
<wsdl:input name="add" message="tns:add"/>
<wsdl:output name="addResponse" message="tns:addResponse"/>
</wsdl:operation>
</wsdl:portType>
<wsdl:binding name="CalculatorSoapBinding"
type="tns:CalculatorPortType">
<soap:binding style="document"
transport="http://schemas.xmlsoap.org/soap/http"/>
<wsdl:operation name="add">
<soap:operation soapAction="add" style="document"/>
<wsdl:input name="add">
<soap:body use="literal"/>
</wsdl:input>
<wsdl:output name="addResponse">
<soap:body use="literal"/>
</wsdl:output>
</wsdl:operation>
</wsdl:binding>
<wsdl:service name="Calculator">
<wsdl:port name="CalculatorPort"
binding="tns:CalculatorSoapBinding">
<soap:address location="http://localhost:8080/jaxwscalculator-
1.0/calculator"/>
<wswa:UsingAddressing
xmlns:wswa="http://www.w3.org/2005/08/addressing/wsdl"/>
</wsdl:port>
</wsdl:service>
</wsdl:definitions>

Warning

add explanation for the code

This completes the creation of wsdl for web service.

Creating the Web Services Implementation code

To implement the Calculator we are going to create a package org.apache.geronimo.samples.jws. This package will contain 2 classes. A Calculator Interface, and CalculatorService which implements the Calculator interface. Lets go step by step with creating the package, interface class and implementation class.

Right click on Java Resources: src and select New->Package.
Name the package as org.apache.geronimo.samples.jws. Select Finish.
Right click on the new package and Select New->Interface.
Name the interface as Calculator. Select Finish.

Add the following code to the Calculator interface class

Calculator.class

package org.apache.geronimo.samples.jws;

import javax.jws.WebService;
import javax.jws.WebMethod;
import javax.jws.WebParam;

@WebService(name="CalculatorPortType",
            targetNamespace = "http://jws.samples.geronimo.apache.org")
public interface Calculator {

    @WebMethod
    public int add(@WebParam(name = "value1") int value1,
                   @WebParam(name = "value2") int value2);

}

Warning

add explanation for the code

Right click on the package org.apache.geronimo.samples.jws and select
New->Class.
Name the class CalculatorService
Accept all the defaults and Select Finish.

Add the following code to CalculatorService.class

CalculatorService.class

package org.apache.geronimo.samples.jws;

import javax.annotation.Resource;
import javax.jws.WebService;
import javax.xml.ws.WebServiceContext;

@WebService(serviceName = "Calculator",
            portName="CalculatorPort",
            endpointInterface = "org.apache.geronimo.samples.jws.Calculator",
            targetNamespace = "http://jws.samples.geronimo.apache.org",
            wsdlLocation = "WEB-INF/CalculatorService.wsdl")
public class CalculatorService implements Calculator {

    @Resource
    private WebServiceContext context;

    public int add(int value1, int value2) {
        System.out.println("User Principal: " + context.getUserPrincipal());
        return value1 + value2;
    }
}

This completes the development of Web Services implementation code.

Developing a web client for Calculator

This section will take you through the creation of two jsp's index.jsp and result.jsp.index.jsp will prompt the
user to enter two whole number values to add together. After submitting the form, the action will be forwarded to result.jsp. Result.jsp will call the Calculator add Web Service.

Right Click on the Web Content folder and Select New->JSP.
Name the jsp as index.jsp and Select Finish.

Add the following code to index.jsp

index.jsp

<%@ page
import="java.net.URL,javax.xml.namespace.QName,javax.xml.ws.Service,org
.apache.geronimo.samples.jws.Calculator"%>
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
<title>Calculator</title>
</head>
<body>
<form action="result.jsp">
Please enter 2 whole numbers to add: <input type="text"
name="value1"> + <input type="text" name="value2"> <input type="submit"
value="=">
</form>
</body>
</html>

Right Click on the Web Content folder and Select New->JSP.
Name the jsp as result.jsp and Select Finish.

Add the following code to jsp.

result.jsp

<%@ page
import="java.net.URL,javax.xml.namespace.QName,javax.xml.ws.Service,org
.apache.geronimo.samples.jws.Calculator"%>
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
<title>Calculator Result</title>
</head>
<%
int value1 = 0;
int value2 = 0;
int sum = 0;
try {
System.out.println( request.getParameter( "value1" ) + " " +
request.getParameter( "value2" ) );
value1 = Integer.parseInt( request.getParameter( "value1" ) );
value2 = Integer.parseInt( request.getParameter( "value2" ) );
URL url = new URL("http://localhost:8080/jaxws-calculator-
1.0/calculator?wsdl");
QName qname = new
QName("http://jws.samples.geronimo.apache.org", "Calculator");
Service service = Service.create(url, qname);
Calculator calc =
(Calculator)service.getPort(Calculator.class);
sum = calc.add(value1, value2);
} catch ( Exception e ) {
e.printStackTrace();
}
%>
<body>
The result is: <%=value1%>+<%=value2%>=<%=sum%>
<br>
<a href="index.jsp">Back</a>
</body>
</html>

This finishes the development of Web client.

Setting up the Deployment Descriptor and Deployment Plan

Expand WEB-INF/web.xml and add the following code

web.xml

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:calc="urn:geronimo-samples-jws"
xmlns="http://java.sun.com/xml/ns/javaee"
version="2.5">
<servlet>
<display-name>CalculatorService</display-name>
<servlet-name>CalculatorService</servlet-name>
<servlet-class>
org.apache.geronimo.samples.jws.CalculatorService
</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>CalculatorService</servlet-name>
<url-pattern>/calculator</url-pattern>
</servlet-mapping>
<service-ref>
            <service-ref-name>services/Calculator</service-ref-name>
            <service-interface>javax.xml.ws.Service</service-interface>
            <wsdl-file>WEB-INF/CalculatorService.wsdl</wsdl-file>
        </service-ref>
</web-app>

Similarly double click geronimo-web.xml and add the following code.

geronimo-web.xml

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://geronimo.apache.org/xml/ns/j2ee/web-1.1">
<dep:environment xmlns:dep="http://geronimo.apache.org/xml/ns/deployment-1.1">
<dep:moduleId>
<dep:groupId>org.apache.geronimo.samples.jws</dep:groupId>
<dep:artifactId>Calculator</dep:artifactId>
<dep:version>1.0</dep:version>
<dep:type>car</dep:type>
</dep:moduleId>
<dep:dependencies>
</dep:dependencies>
</dep:environment>
<context-root>/jaxws-calculator-1.0</context-root>
<service-ref>
   <service-ref-name>services/Calculator</service-ref-name>
   <port>
      <port-name>CalculatorPort</port-name>
      <protocol>http</protocol>
      <host>localhost</host>
      <port>8080</port>
      <uri>/jaxws-calculator/calculator</uri>
   </port>
 </service-ref>
</web-app>

Deploy and Run

Right click on jaxws-calculator project. Select Run As->Run On Server.
On the next window select Apache Geronimo V2.1 and Select Finish.
Once the application is deployed on the server. Launch a browser and run the following URL http://localhost:8080/jaxws-calculator-1.0/index.jsp.
Give the values as 5,7. Select =.
The result is 12 as shown in the figure

Child pages

Developing a simple Calculator Web Service