Download presentation
Presentation is loading. Please wait.
1
Intro to Apache Axis Siva Jagadeesan sivajag@hotmail.com
2
About Me I am a Java Consultant working in a project for Deloitte Consulting My fields of Expertise –J2EE Technologies –Java tools for Extreme Programming (Ant, JUnit etc) My fields of Interest –Web Services –J2ME –Aspect Oriented Programming
3
Agenda Web Services Basics Intro to Apache Axis
4
Outline Web Services Basics –What is Web Service? –Web Services Architecture –XML Messaging XML-RPC SOAP –What is WSDL? –Development plan for Service Requestor –Development plan for Service Provider
5
Outline Intro to Apache Axis –What is Apache Axis? –Architecture of Apache Axis –Features of Apache Axis –Installing Apache Axis –Publishing Web Service through Apache Axis –Walkthrough of deploying and accessing a simple web service using Apache Axis
6
What is Web Service? A Web Service is any service that – is available over the web – uses standardized XML messaging – is OS and Programming language independent
7
Web Services Architecture There are two ways we can view Web Services architecture 1.Web Service Roles 2.Web Service Protocol Stack
8
Web Service Roles There are three major roles Service Registry Service Requestor Service Provider 2) Discover services 3) Invoke service Provider of the Web Service Consumer of the Web Service Logically Centralized directory of services 1) Register service
9
Web Service Protocol Stack Discovery UDDI Description WSDL XML Messaging XML-RPC,SOAP,XML Transport HTTP,SMTP,FTP,BEEP Responsible for centralizing services Responsible for transporting messages Responsible for describing the public interface to a specific web service Responsible for encoding messages in common XML format
10
XML Messaging There are two ways of XML Messaging XML-RPC SOAP
11
What is XML-RPC ? is a simple protocol that uses XML messages to perform RPC Request are encoded in XML and send via HTTP Response are encoded in XML and received via HTTP is a easiest way to get started with web services
12
Sample XML-RPC Request com.agram.sayHello Java
13
Sample XML-RPC Response Hello Java
14
What is SOAP? Simple Object Access Protocol SOAP is slightly more complicated than the XML-RPC SOAP extended XML-RPC It uses XML namespaces and XML Schemas.
15
SOAP Message Envelope is like a wrapper for content Header is a optional element that could contain control information Body element includes requests and responses Body element will include a Fault element in the event of an error SOAP Message Envelope Header Body
16
Sample SOAP Request <SOAP-ENV:Envelope xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:SOAP-ENV=http://schemas.xmlsoap.org/soap/envelope/ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <ns1:sayHello xmlns:ns1="http://agram.com/"> Java
17
Sample SOAP Response <SOAP-ENV:Envelope xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:SOAP-ENV=http://schemas.xmlsoap.org/soap/envelope/ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <ns1:sayHelloReponse xmlns:ns1="http://agram.com/"> Hello Java
18
What is WSDL? Web Services Description Language Has 6 major elements 1.definitions – defines the name of the web service 2.types – describes all the data types that will be transmitted 3.message – defines the name of the message that will be transmitted 4.portType – defines the operations 5.binding – defines how the message will be transmitted 6.service – defines where the service is located
19
Development plan for Service Requestor 1) Find web service via UDDI 2) Retrieve service description file 3) Create XML-RPC or SOAP client 4) Invoke remote service
20
Development plan for Service Provider 1) Create the core functionality 2) Create XML-RPC or SOAP service wrapper 3) Create service description file 4) Deploy service 5) Register new service via UDDI
21
What is Apache Axis? “Axis is essentially a SOAP engine – a framework for constructing SOAP processors such as clients, servers, gateways etc” - Axis Website
22
Architecture of Apache Axis
23
1. Admin Sub-system handles administration and configuration of the server 2. Service Sub-system implements the RPC exchange protocol 3. Provider Sub-system is the interface between Axis server and the external component methods that are to be exposed as webservice 4. Transport Sub-system receives and delivers the message from the service sub system 5. Encoding Sub-system manages encoding/decoding and serilization/deserilization between XML data types and Java Classes 6. Message Sub-system defines the structure of the different elements of a SOAP message and provides functionality for binding and parsing the different elements of these messages
24
Features of Apache Axis Successor to Apache SOAP It can run as a standalone server or as an a server that plugs into Servlet engine like Tomcat Automatic WSDL generation for deployed services Java2WSDL – to generate WSDL from Java interface WSDL2Java – to generate Java classes from WSDL Easy deployment Uses JAX-RPC API
25
Installing Apache Axis 1) Download Axis Distribution archive from http://xml.apache.org/axis/ - Axis distribution archive contains a web application ( webapps/axis/ directory) for hosting an Axis Server in a web container like Tomcat
26
Installing Apache Axis (Cont) 2) Deploy Axis Server in the Tomcat 4.X server a) Copy Axis Web application (webapps/axis directory) to $TOMCAT_HOME/webapps b) Copy jaxrpc.jar (that is provided with Axis distribution) and xerces.jar ( or any other XML parser) to $TOMCAT_HOME/common/lib jaxrpc.jar and xerces.jar includes classes with “java” and “javax” packages and Tomcat does not authorize to load any classes in that package from WEB-INF/ lib directory of the web application.
27
Installing Apache Axis (Cont) 3) Configure the environment by including these libraries in the CLASSPATH - log4j-core.jar - commons-logging.jar - wsdl4j.jar - jaxrpc.jar - tt.bytecode.jar - xerces.jar ( or any other XML Parser)
28
Validating the Installation 1) Start the Tomcat Web Server 2) Goto http://localhost:8080/axis/http://localhost:8080/axis/ - you should be able to see Apache-Axis start page - if you did not, then the axis is not correctly installed or the web server is not running 3) Goto http://localhost:8080/axis/happyaxis.jsphttp://localhost:8080/axis/happyaxis.jsp - this test page verifies whether all the needed and optional libraries are present. - Axis will not perform properly until all the needed libraries are present.
29
Publishing Web Service through Apache Axis The two ways we can publish a web service with Axis are, 1.Instant Deployment – Java Web Service (JWS) 2.Custom Deployment – Using Web Service Deployment Descriptor ( WSDD)
30
Walkthrough of deploying and accessing a simple web service using Apache Axis
31
The steps we will walkthrough 1. Code – code a simple HelloWorld java class that we want to expose as web service 2. Java2WSDL – Generate the WSDL file for the given HelloWorld Interface 3. WSDL2Java – Generate the Server side wrapper class and stubs for easy client access 4. Deploy – deploy the service to apache axis 5. Client – code a simple client that access our HelloWorld Web Service
32
Step 1: Code HelloWorld.java package helloworld; public interface HelloWorld { public String sayHello( String name); }
33
Step 1: Code (Cont) HelloWorldImpl.java package helloworld; public class HelloWorldImpl implements HelloWorld { public String sayHello( String name){ if(name == null) return “Hello Everyone”; else return “Hello “ + name; }
34
Step 2: Java2WSDL This command will generate the WSDL that Conforms to our interface % java org.apache.axis.wsdl.Java2WSDL -o hello.wsdl -l http://localhost:8080/axis/services/helloworld -n urn:helloworld -p“helloworld" urn:helloworld helloworld.HelloWorld Parameters description -o = Name of the output -l = URL of the web Service -n = Target Namespace for the WSDL -p = Map Java package to namespace Fully Qualified Class Name
35
Step 3: WSDL2Java This command will generate the wrapper code for deploying the service, as well as client stubs for accessing it. % java org.apache.axis.wsdl.WSDL2Java -o. -d Session -s -p helloworld.gen hello.wsdl Parameters description -o = Base output Directory -d = Scope of deployment -s = To generate Server-side code too -p = Package to place the code Name of the WSDL
36
Step 3: WSDL2Java These are the codes that will get generated 1. HelloWorldSoapBindingImpl.java – This is the implementation code for the Web Service 2. HelloWorld.java – This is the remote interface 3. HelloWorldService.java – This is the service interface 4. HelloWorldServiceLocator.java – Helper class to retrieve handler to service 5. HelloWorldSoapBindingSkeleton.java – Server-side skeleton code 6. HelloWorldSoapBindingStub.java – Client side stub 7. deploy.wsdd – axis deployment descriptor 8. undeploy.wsdd – deployment descriptor to undeploy the web services from the Axis System
37
Step 3: WSDL2Java HelloWorldSoapBindingImpl package helloworld.gen; public class HelloWorldSoapBindingImpl implements helloworld.gen.HelloWorld { public String sayHello(String str0) throws java.rmi.RemoteException { } import helloworld.HelloWorldImpl; HelloWorldImpl helloWorld = new HelloWorldImpl(); return helloWorld.sayHello(str0);
38
Step 4: Deploy 1. Compile the Service Code % javac helloworld\gen\*.java 2. Package the code for Axis % jar cvf hello.jar helloworld/*.class helloworld/gen/*.class % mv hello.jar $TOMCAT_HOME/webapps/axis/WEB-INF/lib 3. Deploy the Service using WSDD % java org.apache.axis.client.AdminClient deploy.wsdd Done processing
39
Step 5: Client package helloworld; Import helloworld.gen.*; public class HelloWorldTester { public static void main(String [] args) throws Exception { // Make a service HelloWorldService service = new HelloWorldServiceLocator(); // Now use the service to get a stub to the service helloworld.gen.HelloWorld hello = service.getHelloWorld(); // Make the actual call System.out.println( hello.sayHello(“Java Gurus”) ); }
40
Summary Web Service –Roles in Web Services –Web Services Protocol Stack –Different ways of XML Messaging –Development plan for Service Requestor and Provider Axis –Architecture of Axis –Features of Apache Axis –Installing Apache Axis –Different ways of deploying Web Service with Axis –Deploying and accessing a simple web service using Apache Axis
41
Resources JAX-RPC home - http://java.sun.com/xml/jaxrpc/index.html http://java.sun.com/xml/jaxrpc/index.html Web Services & Java home - http://java.sun.com/j2ee/webservices/index.html http://java.sun.com/j2ee/webservices/index.html Java Web Services tutorial - http://java.sun.com/xml/docs.html#tutorials http://java.sun.com/xml/docs.html#tutorials Apache Axis - http://xml.apache.org/axis/index.html http://xml.apache.org/axis/index.html SOAP 1.1 - http://www.w3.org/TR/SOAPhttp://www.w3.org/TR/SOAP WSDL 1.1 - http://www.w3.org/TR/wsdlhttp://www.w3.org/TR/wsdl
42
Questions/Feedbacks? Contact me at sivajag@hotmail.com
Similar presentations
© 2025 SlidePlayer.com. Inc.
All rights reserved.