...
This tutorial will take you through the following steps:
Table of Contents | ||||||
---|---|---|---|---|---|---|
|
Web based Client
The following steps will help you in creating a Web based Client for a JAX-WS Web Service which is already deployed on the server.
...
Info | ||
---|---|---|
| ||
Note that we accessed the webservice in the jsp by creating a service, and then retrieving the Converter port from the WSDL document. |
POJO Client
Here we will have a look on how to create a plain old java client for consuming the web service.
Developing the Client
- Create a Java Project
- Select File->New->Project
- In the popup window select Java->Java Project and then click Next
- Name the project as jaxws-converterpojoclient and click Finish in the New Java Project dialog.
- Select File->New->Project
- Copy the files Converter.java and ConverterPortType.java into the appropriate package.
- Add another class with the name ConverterClient.java in the same package.
- Add the following code to the ConverterClient.java
Code Block | ||||
---|---|---|---|---|
| ||||
package org.apache.geronimo.samples.jaxws;
import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.math.BigDecimal;
public class ConverterClient {
public static void main(String args[]) {
try {
BufferedReader dataIn = new BufferedReader(new InputStreamReader(
System.in));
System.out.println("enter a amount to convert:");
String number = new String();
number = dataIn.readLine();
BigDecimal amount = new BigDecimal(number);
Converter conv = new Converter();
ConverterPortType port = conv.getConverterPort();
BigDecimal result = port.dollarToRupees(amount);
System.out.println(amount + " dollars equals to " + result
+ " rupees");
BigDecimal result1 = port.rupeesToEuro(result);
System.out.println(result + " rupees equals to " + result1
+ " euros");
} catch (Exception e) {
e.printStackTrace();
}
}
}
|
This completes the development section of our POJO client
Adding necessary jar files to the class path
Note | ||
---|---|---|
| ||
Now our Java project might show many errors and even if we resolve the errors the application may not run properly. This is due to the missing jar files required to access and understand SOAP messages sent by web service. |
- Right click the jaxws-converterpojoclient project and then select Properties
- Select Java Build Path and then go to Libraries tab
- Click on Add External JARS and then add the axis2-adb-1.3.jar from the location <GERONIMO_INSTALL_DIR>/repository/org/apache/axis2/axis2-adb/1.3/ and then click Open
Info title Version Numbers The version numbers may differ slightly. It wont matter much.
- Repeat the above step for the following external JARS
Panel | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
axis2-adb-1.3.jar - <GERONIMO_INSTALL_DIR>/repository/org/apache/axis2/axis2-adb/1.3/axis2-adb-1.3.jar Also add Server Runtime Library to class path which reduces the effort for adding some more jars. |
This completes the adding external JARs to the project
Tip | ||
---|---|---|
| ||
If you are running Java 6 you don't need to worry about the external JARs as they are all inbuilt into JRE 6. But you should copy all the files generated by wsimport command into appropriate packages as Runtime Modeller in Java 6 is slightly different. |
Testing
- Now Right click the ConverterClient.class and select Run As->Run as Java Application
- Now enter the amount in the console window of Eclipse
- The output will be shown which is retrieved by accessing the methods of Web service.
This completes the development and deployment of clients for consuming a Web Service. Even though this tutorial demonstrated for one particular Web Service, the method can be extended for any deployed web service.