Assignment 1 “Deploying a Simple Web Service” A 1. 1
Task • To build, deploy and test a simple web service. A 1. 2
Tools This assignment uses: – Java 2 platform standard edition – Apache Jakarta Tomcat Java servlet container – Apache Axis tools A 1. 3
Steps • Write the Java code to implement the web service. • Use Axis to generate all needed Java source files. • Compile the source files just generated. • Create client source and compile. • Execute client to access service. • Extend the functionality of the service. A 1. 4
Web service Client Apache Tomcat hosting environment A 1. 5
Step 1 – Implement Service Write the code for the class that provides the web service. This code is: public class My. Math { public int squared(int x) { return x * x; } } Save that code as a. jws (Java Web Service) file, Math. jws. A 1. 6
Step 1 (continued) Copy the. jws file to the axis directory: cp My. Math. jws $CATALINA_HOME/webapps/axis/yourusername %CATALINA is an environment variable specifying the path to the home directory of the Apache Tomcat java servlet container. A 1. 7
Axis Java Web Service Facility By placing your Java code as a. jws file in your web application directory structure, Axis will automatically find it, compile it, and deploy the methods. A 1. 8
Axis Java Web Service Facility (cont. ) The service is now deployed and can be accessed remotely through it’s URL: http: //yourserver. yourdomain. edu : 8080/axis/yourusername/… Example http: //www. coitgrid 0. uncc. edu: 8080/axis/abw/My. Math. jws A 1. 9
• However, a client cannot access the service without all the code needed handle the SOAP messages, i. e. the stubs and associated files. A 1. 10
• Can use Java service code as the basis to create the WSDL file using an Axis “Java 2 WSDL” tool. • Then use the WSDL as the basis to create the requires Java files using an Axis “WSDL 2 Java” tool A 1. 11
Step 2 Generate files Use the Axis tools to create four Java source files from My. Math. jws with the composite command: java -classpath $AXISCLASSPATH org. apache. axis. wsdl. WSDL 2 Java http: //localhost: 8080/axis/My. Math. jws? wsdl A 1. 12
Step 2 (continued) Axis finds My. Math. jws file and creates • Two source files each holding a Java interface, – My. Math. java and – My. Math. Service. java • Two source files each holding a Java class, – My. Math. Service. Locator. java – My. Math. Soap. Binding. Stub. java These files are put in a new package in localhost/axis/yourusername/My. Math_jws / which is in /home/yourusername/Web. Services/ A 1. 13
My. Math. java -- Client code My. Math. Service. java -- Service code A 1. 14
My. Math. Service. Locator. java -- Java class used by client to find location of service. My. Math. Soap. Binding. Stub. java -- Java class that converts client service call to form to be sent to service. – client stub. A 1. 15
Other files deploy. wsdd – WSDD file provided to registry when service deployed. undeploy. wsdd -- for undeploying service A 1. 16
Files used by service Service stub (skeleton): My. Math. Soap. Binding. Skeleton. java My. Math. Soap. Binding. Impl. java – used by My. Math. Soap. Binding Skeleton. java A 1. 17
Structure deploy. wsdd WSDD undeploy. wsdd My. Math. Service. Locator. java Client Stub Registry (Locator) Deploy Request WSDL Stub Service Method call/return WSDL My. Math. Client. java My. Math. Soap. Binding. Skeleton. java My. Math. Soap. Binding. Stub. java My. Math. Service. java My. Math. wsdl A 1. 18
Step 3 Compile new source files Compile source files generated by step 2 with: javac -classpath $AXISCLASSPATH localhost/axis/yourusername/My. Math_jws/*. java A 1. 19
Step 4: Write Client Source Below is client code for an earlier version of Axis (1. 1). Version 1. 2 used in the assignment requires more code. import localhost. axis. yourusername. My. Math_jws. My. Math. Service. Locator import localhost. axis. yourusername. My. Math_jws. My. Math. Service; import localhost. axis. yourusername. My. Math_jws. My. Math; public class My. Math. Client { public static void main(String args[]) throws Exception { My. Math. Service service = new My. Math. Service. Locator(); My. Math my. Math = service. get. My. Math(); int x = (new Integer(args[0])). int. Value(); System. out. println("The square of " + args[0] + " is " + my. Math. squared(x)); } } A 1. 20
Step 5 Compile Client code Compile the client source file with: javac -classpath $AXISCLASSPATH: . My. Math. Client. java A 1. 21
Step 6 Execute Web Service program java -classpath $AXISCLASSPATH My. Math. Client 4 The square of 4 is 16 A 1. 22
Step 7 Extend the Web Service Add functionality to the My. Math web service: • Add a method that identifies whether a number is even. • Add a method that identifies whether a number is prime. Modify My. Math. jws file and repeat all previous steps to test the extended web service. A 1. 23
Скачать презентацию Assignment 1 Deploying a Simple Web Service A
e20e4d9ac4ac6b477148cde8e70775bb.ppt