Apache Axis2 User's Guide - The Samples

The Axis2 Standard Distribution provides a number of samples you can use as a guide for implementing specific features and capabilities. These services are listed in this section.

Content

• Introducing Axis2
  
  • What is Axis2
  • What's under the hood?
  • How Axis2 handles SOAP messages
  • Axis2 distributions
  • The Axis2 Standard Binary Distribution
  • Axis2.war Directory Hierarchy
  • Axis2 Documents Distribution
  • Axis2 and clients
• Installing and testing client code
• Introduction to Services
  
  • Message Exchange Patterns
• Creating Clients
  
  • Choosing a Client Generation Method
  • Generating Clients
  • Axis Data Binding (ADB)
• Building Services
  
  • Getting Comfortable with Available Options
  • Creating a service from scratch
  • Deploying Plain Old Java Objects
  • Deploying and running an Axis2 service created from WSDL
• Samples
  • Clients
  • Services
  • Sample WSDL files
  • Other Samples
• For Further Study

Clients (in samples/userguide/src/clients):

EchoBlockingClient.java: A basic example of the send/receive MEP.

EchoBlockingDualClient.java: Specifies that the return message should be sent over a different channel than the request message.

EchoBlockingWsaBasedClient.java: Provides an example of using the capabilities of WS-Addressing action mapping.

EchoNonBlockingClient.java: Demonstrates an asynchronous request and using Callbacks.

EchoNonBlockingDualClient.java: Similar to above, but uses a separate listener for the response.

ClientForWebServiceWithModule.java: Simply makes a call to a service with engaged modules.

ClientSideModuleEngagement.java: Demonstrates the use of modules on the client side, in addition to the server side.

MailClient.java: Demonstrates the use of the Robust In-Only MEP.

PingClient.java: A simple "fire and forget" client.

RESTClient.java: Demonstrates the ability to request a REST response rather than a SOAP response. Also demonstrates setting arbitrary properties on the Options object.

TCPClient.java: Provides an example of using the TCP transport rather than HTTP.

Services (in samples/userguide):

groovyService.aar: Demonstrates how to use Groovy classes in the processing of SOAP messages.

MyService.aar: Provides simple "echo" and "ping" operations.

MyServiceWithModule.aar: Same as above, but demonstrates how to engage a module.

WsaMappingService.aar: Demonstrates the mapping of WS-Addressing actions.

Sample WSDL files (in samples):

Axis2SampleDocLit.wsdl: Demonstrates the use of the Document/Literal WSDL pattern, rather than RPC.

perf.wsdl: Demonstrates the use of array values as input values.

Other samples (in samples):

faulthandling: Demonstrates the use of SOAP faults and their definition in WSDL, enabling exception processing in the client.

googleSpellcheck: Demonstrates both synchronous and non-synchronous use of the Google Web Service in a GUI.

mtom: Demonstrates the use of MTOM and SOAP with Attachments to send binary files to a service.

saopwithattachments: Demonstrates the capabilities and power of SOAP with Attachment support and the Attachment API of Axis2.

pojo: Example POJO (Plain Old Java Object) Web service. It shows how to expose the methods of a Java class as a Web service using Aixs2

servicelifecycle: Demonstrate usage of service life cycle and bit of session management. The main idea is to show where and how to use service life cycle interface and session related methods.

databinding: Demonstrates how to use WSDL2Java generated code with Castor.

version: A very simple service that simply outputs the Axis2 version.

yahoorestearch: Complete example of the use of a REST service rather than a SOAP service.

See Next Section - For Further Study