...

...

1. From Eclipse main menu, select File->New->Other
2. In the New dialog, select Web->Dynamic Web Project and click Next
3. Type jaxws-converter as the Project Name and click Next
4. On the Project Facets page, the default selections as shown below are enough (Geronimo has an embedded Axis2 container already running) and click Next
   
5. Make sure that the check box Generate Deployment Descriptor is selected and click Next
6. On the Geronimo Deployment Page modify the Group Id to org.apache.geronimo.samples.jaxws and the Artifact Id to jaxws-converter.
7. Click Finish

...

Add the POJO Interface & Class that implement the Web Service

1. In Project Explorer view, expand jaxws-converter project, right click on Java Resources: src and select New->Package
2. Specify org.apache.geronimo.samples.jaxws as the package name and click Finish
3. Right click on the new package and select New->Interface
4. Name the interface as Converter and click Finish
5. Add the following code to the Converter interface

...

Let us try to understand each annotation:

• @WebService- This annotation can be used with a Java class as well as with interface. In our case we used it with both interface as well as the POJO. This annotation declares the POJO as a WebService. @WebService annotation is utilized in generating the WSDL file.
  • serviceName is same as the WSDL element service
  • name is same as the WSDL element <portType name>
  • endpointInterface suggests the user defined name for the Service Endpoint Interface(SEI).
  • portName is the element portName
  • targetNamespace is the XML namespace of the WSDL and some of the XML elements generated from the WebService
• @WebMethod- This annotation is applied to a method to expose it as a WebService method. In case you have multiple methods you can use this annotation to selectively expose methods as WebService method. If you donot use this annotation all the public methods will be exposed as WebService.
• @WebParam- This annotation is used along with @WebMethod annotation to define the WebService. It is used to customize parameter used in the message part of the wsdl.

Setting Up the Deployment Descriptor and Deployment Plan

For the client applications to enquire about the services provided we need to create a WSDL file which provides the mapping between services exposed by web service and functions in the Java class

Expose the Web Service as a Servlet in web.xml

1. In Project Explorer view, double click on jaxws-converter->WebContent->WEB-INF->web.xml to open it in an editor and add the following <servlet> and <servlet-mapping> elements inside it.Expand WEB-INF directory and add the following code to web.xml

...

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xmlns="http://java.sun.com/xml/ns/javaee"
	xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
	xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
	id="WebApp_ID" version="2.5">
	<display-name>jaxws-converter</display-name>
	<servlet>
		<display-name>Converter</display-name>
		<servlet-name>Converter</servlet-name>
		<servlet-class>
			org.apache.geronimo.samples.jaxws.ConverterService
		</servlet-class>
	</servlet>

	<servlet-mapping>
		<servlet-name>Converter</servlet-name>
		<url-pattern>/converter</url-pattern>
	</servlet-mapping>

</

...

web-app>

Deploy the Web Service and let Geronimo create the required .wsdl & other artifacts

This completes the setting up of Deployment descriptor and Deployment Plan.

Deploy and Test the Web Service

Now, we will look into the steps involved in deploying and testing our web service without any clients.

Deploy

1. In Servers view, right click on the Apache Geronimo Server Runtime and select Add and Remove Projects
2. In the popup dialog, select the jaxws-converter project, click Add, and then click Finish
   
3. Wait for some time till the server status is changed to synchronized.

Testing

1. The Web Service will now be deployed, and Geronimo will create the required .wsdl and other required artifacts.
2. Once the Web Service Once the application is deployed on to the server , Launch (Server Status says Synchronized), launch a browser and go to the following url.:
   http://localhost:8080/jaxws-converter/converter
3. Now you should see the screen telling that this is Converter Web Service a message from Axis2 engine as below:
   

Using Web Services Explorer in Eclipse

...

Test the Web Service using Eclipse's Web Services Explorer

1. Go to Eclipse and select Run->Launch the Web Services Explorer from the main menu.
2. Web Services Explorer opens up as shown below:
   
   
   Image Added
   
   
   
3. On the top right corner of this explorer, click on the icon for "WSDL Page". Under Navigation section, you will now see WSDL Main. Click that WSDL Main link to enter the URL of WSDL document.
   
   
   Image Added
   
   
   
4. Enter the URL of our WSDL document i.e http://localhost:8080/jaxws-converter/converter?wsdl in the form and click Go. Now you can see the methods that are exposed by our Web Service.
   
   
   Image Added
   
   
   
5. Clicking on any method takes us to a page with form asking for input parameters.If you dont see any field to enter input arguments click Add.
   
   
   Image Added
   
   
   
6. Enter any argument and examine the status frame at the bottom to see the result.
   
   
   Image Added
   
   
   

This concludes our deploy and test section

...

This concludes our deploy and test section.

...

Geronimo has a inbuilt plugin names jaxws-builder which helps in creating the WSDL and other required files to deploy the web service by using the jaxws-tools provided by Sun

...

.

Developing a client

Now, we will focus on developing a client for our application. We will develop two types of clients to demonstrate how web services can be consumed in both cases.

...

Deploying and Testing the Web Client

Deploy

1. Right now our server status might be reporting that we need to republish.
   
   
   
   
   
   
2. Right click on the Apache Geronimo Server Runtime present in the servers view and select Publish
   
   
   
   
   
   
3. Wait for some time till the server status changes to Synchronized

Testing

1. Right click the index.jsp present under WebContent directory of our project and select Run As->Run On Server
   
   
   
   
   
   
2. In the popup, check the check box Always use this servr when running the project and then click Finish
   
   
   
   
   
   
3. Now Eclipse will try to open the jsp in a web browser which shows you a form to enter amount in Dollars.
   
   
   
   
   
   
4. Enter any amount and press submit, the jsp should display the result that is returned by the web service.
   
   
   
   
   
   

...

Testing

1. Now Right click the ConverterClient.class and select Run As->Run as Java Application
   
   
   
   
   
   
2. Now enter the amount in the console window of Eclipse
3. The output will be shown which is retrieved by accessing the methods of Web service.
   
   
   
   
   
   

...