Apache Axis. Dr. Kanda Runapongsa Department of Computer Engineering Khon Kaen University. Overview

Size: px

Start display at page:

Download "Apache Axis. Dr. Kanda Runapongsa Department of Computer Engineering Khon Kaen University. Overview"

Alexandrina Hodges
6 years ago
Views:

1 Apache Axis Dr. Kanda Runapongsa Department of Computer Engineering Khon Kaen University 1 What is Apache Axis Overview What Apache Axis Provides Axis Installation.jws Extension Web Service Deployment Descriptors (WSDD) Create Web Services by Axis Exercise 2 Dr. Kanda Runapongsa, Khon Kaen University 1

2 What is Apache Axis? Apache Axis is an open-source implementation that provides a Java-based SOAP implementation for developing Web service It facilitates a SOAP runtime environment and Java-based API framework for implementing the core components of Web services adopting compliant standards and protocols 3 What Apache Axis Provides An API library and runtime environment for developing SOAP RPC and SOAP messaging-based applications and services A transport-independent means for adopting a variey of transport protocols (such as HTTP, SMTP, and FTP) Automatic serialization and deserialization for Java objects to and from XML in SOAP messages 4 Dr. Kanda Runapongsa, Khon Kaen University 2

3 What Apache Axis Provides (cont.) Support for exposing EJBs as Web services, especially the methods of stateless session EJBs Tools for creating WSDL from Java classes and vice-versa versa Tools for deploying, monitoring, and testing the Web services 5 Axis Installation for Windows Java 2 SDK v / java.sun.com/ j2se/ 1.4.2/ download.html Apache Tomcat v / mirrors.qualsec.net/ apache/ jakarta/ tomc at-5/ v5.0.28/ bin/ jakarta-tomcat exe Axis v1.1, / ws.apache.org/ axis/ dist/ 1_1/ axis- 1_1.zip 6 Dr. Kanda Runapongsa, Khon Kaen University 3

4 Axis Installation (cont.) Unzip axis-1_1.zip archive to C: (this will create a directory C:\ axis-1_1) Copy directory axis in C:\ axis-1_1 1_1\ webapps to [tomcat directory]\ webapps (so you have [tomcat directory]\ webapps\ axis) Start tomcat server and browse to / localhost:8080/ axis.. Click on the Validate link to test that all libraries are accessible to Axis (both core and optional). 7 Axis Installation (cont.) The optional libraries can put its into [tomcat directory]\ webapps\ axis\ WEB-INF INF\ lib 8 Dr. Kanda Runapongsa, Khon Kaen University 4

5 Axis Environment Set AXIS_HOME=C:\ axis-1_1 Set AXIS_LIB=%AXIS_HOME%\ lib Set AXISCLASSPATH=%AXIS_LIB AXIS_LIB%\ axis.jar; jar;%axis_ LIB%\ commons- discovery.jar; jar;%axis_lib AXIS_LIB%\ commons- logging.jar; jar;%axis_lib AXIS_LIB%\ jaxrpc.jar; jar;%axis_lib AXIS_LIB%\ sa aj.jar; jar;%axis_lib AXIS_LIB%\ log4j jar; jar;%axis_lib AXIS_LIB%\ xml- apis.jar; jar;%axis_lib AXIS_LIB%\ xercesimpl.jar 9.jws Extension Stored in [tomcat directory]\ webapps\ axis For example : EchoHeaders.jws. Compile and executed by browse its URL For example browse to : / localhost:8080/ axis/ EchoHeaders.jws?wsdl You will see in XML The jwsclasses stored in [tomcat directory]\ webapps\ axis\ WEB-INF INF\ jwsclasses 10 Dr. Kanda Runapongsa, Khon Kaen University 5

6 Web Service Deployment Descriptors (WSDD) Written by using XML. can control which provider handlers are used to expose components as Web services Java-RPC Provider Java-MsgProvider EJBProvider 11 Axis deployment descriptors WSDD deployment descriptors Extensive customization of server options Service style specification RPC document wrapped Allowed methods and required roles Transport specification Handler chains for special processing Logging or tracking usage Authorization authentication Custom serializers deserializers Transport specification 12 Dr. Kanda Runapongsa, Khon Kaen University 6

7 Create Web Services by Axis Create java file with.jws. extension Store it in [tomcat directory]\ webapps\ axis Use Java2WSDL to generate.jws. to WSDL Use WSDL2Java to generate 4 Java files from WSDL Deploy Web Service on Apache Axis Create client to call Web Service 13 Example We will create the Web Service which has three operation that deal with taxes The first operation will figure out the tax percent if given the subtotal and the total money spent on a shopping purchase. calctaxrate(double subtotal, double total) The second operation will figure out the amount of tax paid when given the total and the tax percentage. calcsubtotal(double total, double taxpercent) The third operation will figure out the total amount when given the subtotal and the tax percent. calctotal(double subtotal, double taxpercent) 14 Dr. Kanda Runapongsa, Khon Kaen University 7

8 Create filename TaxService.jws TaxService.jws which has this content public class TaxService { public double calctaxrate(double subtotal, double total) { double rate = (total - subtotal)/ subtotal; return rate; public double calcsubtotal(double total, double taxpercent) { double subtotal = total / (1 + taxpercent); return subtotal; public double calctotal(double subtotal, double taxpercent) { double total = subtotal * (1 + taxpercent); return total; 15 Store file TaxService.jws in [tomcat directory]\ webapps\ axis\ TaxService.jws Start tomcat server Compile and execute it. Browse to / localhost:8080/ axis/ TaxService.jws then Click to see WSDL. You should see a listing of XML elements in your browser. If you see the WSDL file, then congratulations! You have successfully created and deployed your first web service using Axis! 16 Dr. Kanda Runapongsa, Khon Kaen University 8

$17 Writing the Client Create a stub from the WSDL Use a tool called WSDL2Java Follow these following command > cd [tomcat directory]\ webapps\ axis\ WEB-INF INF\ lib > >java -cp axis.$

9 17 Writing the Client Create a stub from the WSDL Use a tool called WSDL2Java Follow these following command > cd [tomcat directory]\ webapps\ axis\ WEB-INF INF\ lib > >java -cp axis.jar;commons-logging.jar;commons logging.jar;commons- discovery.jar;saaj.jar;wsdl4j.jar;jaxrpc.jar org.apache.axis.wsdl.wsdl2java / localhost:8080/ axis/ TaxService.jws?WSDL 18 Dr. Kanda Runapongsa, Khon Kaen University 9

10 Create directory texservice in C:\ axis-1_1 1_1\ samples Folder called localhost is created in the lib directory of Axis Copy this directory and paste it in taxservice directory Compile the client which following command C:\ cd axis-1_1 1_1\ samples\ taxservice taxservice> cd localhost\ axis\ TaxService_jws TaxService_jws> javac classpath.;%axisclasspath% *.java 19 In the C:\ axis-1_1 1_1\ samples\ taxservice directory create the TaxClient.java which following content import localhost.axis.taxservice_jws.taxserviceservicelocator; import localhost.axis.taxservice_jws.taxservice; import org.apache.axis.axisfault; public class TaxClient { public static void main(string[] args) { try { Make the connection to our web service / / Make a service TaxServiceServiceLocator service = new TaxServiceServiceLocator(); TaxService port = service.gettaxservice(); / / Make the actual calls to the three methods double taxpercent = port.calctaxrate(21.00, 23.10); double total = port.calctotal(21.00, 0.10); double subtotal = port.calcsubtotal(23.10, 0.10); 20 Dr. Kanda Runapongsa, Khon Kaen University 10

11 taxpercent); / / Output the results System.out.println("Subtotal: 21.00, Total: 23.10, Tax: " + System.out.println("Subtotal: 21.00, Tax: 0.10, Total: " + total); System.out.println("Total: 23.10, Tax: 0.10, Subtotal: " + subtotal); catch (AxisFault af) { System.err.println("An Axis Fault occurred: " + af); catch (Exception e) { System.err.println("Exception caught: " + e); 21 Compile the client which the following command taxservice> javac classpath.;%axisclasspath% TaxClient.java Execute the client which the following command taxservice>java cp.;%axisclasspath% TaxClient Subtotal: 21.00, Total: 23.10, Tax: Subtotal: 21.00, Tax: 0.10, Total: 23.1 Total: 23.10, Tax: 0.10, Subtotal: 21.0 You should see the above output! 22 Dr. Kanda Runapongsa, Khon Kaen University 11

12 Deploy the Web Service using WSDD. Create the deploy.wsdd which the following content and save it in C:\ axis-1_1 1_1\ samples\ taxservice\ deploy.wsdd <deployment xmlns=" / xml.apache.org/ axis/ wsdd/ " xmlns:java=" / xml.apache.org/ axis/ wsdd/ providers/ java"> < service name="taxservice" provider="java:rpc"> < parameter name="classname" value="taxservice"/ > < parameter name="allowedmethods" value="*"/ > </ service> </ deployment> 23 Lunch deploy.wsdd which the following command java cp.;%axisclasspath% org.apache.axis.client.adminclient deploy.wsdd If successful, it will output this information. Processing file deploy.wsdd < Admin> Done processing</ Admin> You will see the deployed in / localhost:8080/ axis/ servlet/ AxisServlet or Click View 24 Dr. Kanda Runapongsa, Khon Kaen University 12

$25 Undeploy Create file undeploy.wsdd undeploy.wsdd which the following content and save it in C:\ axis- 1_1\ samples\ taxservice\ undeploy.$

13 25 Undeploy Create file undeploy.wsdd undeploy.wsdd which the following content and save it in C:\ axis- 1_1\ samples\ taxservice\ undeploy.wsdd < undeployment xmlns=" / xml.apache.org/ axis/ wsdd/ "> < service name="taxservice"/ > </ undeployment> 26 Dr. Kanda Runapongsa, Khon Kaen University 13

14 Lunch undeploy.wsdd which the following command java cp.;%axisclasspath% org.apache.axis.client.adminclient undeploy.wsdd If successful, it will output this information. Processing file deploy.wsdd < Admin> Done processing</ Admin> Exercise For EchoStringService file bellow public class EchoStringService { public String echostring(string str) ) { return str; Use the Java2WSDL for generate WSDL file Use the WSDL2Java for generate 4 Java files 28 Dr. Kanda Runapongsa, Khon Kaen University 14

15 1. Answer Java2WSDL Browse URL : / localhost:8080/ axis/ EchoStringService.jws?w sdl WSDL2Java Use the following command > cd [tomcat directory]\ webapps\ axis\ WEB-INF INF\ lib > >java -cp axis.jar;commons-logging.jar;commons logging.jar;commons- discovery.jar;saaj.jar;wsdl4j.jar;jaxrpc.jar org.apache.axis.wsdl.wsdl2java / localhost:8080/ axis/ TaxService.jws?WSDL Exercise Create a CalculatorService has 2 operation addservice subservice The services has return double type Deploy in on Apache Axis Create the client which call the operation above 30 Dr. Kanda Runapongsa, Khon Kaen University 15

16 2. Answer CalculatorService.jws public class CalculatorService { public double addservice(double a1, double a2) { double sum = a1 + a2; return sum; public double subservice(double s1, double s2) { double sub = s1 s2; return sub; Answer (cont.) Deploy CalculatorService.jws <deployment xmlns=" / xml.apache.org/ axis/ wsdd/ " xmlns:java=" / xml.apache.org/ axis/ wsdd/ providers/ java"> < service name= CalculatorService" provider="java:rpc"> < parameter name="classname" value=" CalculatorService "/ > < parameter name="allowedmethods" value="*"/ > </ service> </ deployment> 32 Dr. Kanda Runapongsa, Khon Kaen University 16

Resources Axis homepage: http:/ / ws.apache.

17 Resources Axis homepage: / ws.apache.org/ axis/ WebServices Axis / ws.apache.org/ axis/ docs/ ms-interop.html Apache Axis SOAP for Java / presents/ java- xml/ axis/ axis-java java-soap.pdf 33 Dr. Kanda Runapongsa, Khon Kaen University 17

Developing Web Services. with Axis. Web Languages Course 2009 University of Trento

Developing Web Services. with Axis. Web Languages Course 2009 University of Trento Developing Web Services with Axis Web Languages Course 2009 University of Trento Lab Objective Develop and Deploy Web Services (serverside) Lab Outline WS Sum Up: WS-protocols Axis Functionalities WSDL2Java