Start of Content Area

Function documentation Using the Axis Framework in the SOAP Adapter  Locate the document in its SAP Library structure

Use

You can use the Axis framework in the SOAP adapter. Axis stands for Apache extensible Interaction System. The framework is provided by the Apache Software Foundation. You can use Axis version 1.4 in the SOAP adapter.

Link to external website

More information: ws.apache.org/axis/

Prerequisites

      To use the Axis framework in the SOAP adapter, you must compress the following Axis JAR files, version 1.4, in aii_af_axisprovider.sda:

       axis.jar

       commons-discovery-0.2.jar

       commons-logging-1.0.4.jar

       commons-net-1.0.0-dev.jar

       wsdl4j-1.5.1.jar

      If you want to add your own handlers to the adapter, you must compress the necessary JAR files in aii_af_axisprovider.sda.

      To check whether deployment was successful, use the following URL:

http://<host>:<port>/XIAxisAdapter/MessageServlet

Features

Handlers are important elements of the Axis framework. They are processing steps at runtime that process and forward a message. You can assemble them into processing chains like modules in the module processor.

The following modules are provided for using the Axis framework in the SOAP adapter:

      The HandlerBean module (AF_Adapters/axis/HandlerBean) calls an Axis handler.

You use the module to call the Axis handler that you want to use.

      The Adapter Framework module (AF_Adapters/axis/AFAdapterBean) converts the Axis message object to an Adapter Framework message object and the other way around.

You use the module at the boundary between message processing in the Adapter Framework and in the Axis framework.

This graphic is explained in the accompanying text

      In the receiver direction, an Adapter-Framework-compliant request message is converted to an Axis SOAP message by the Adapter Framework module and is forwarded to the handler modules.

The response message takes the opposite path.

      In the sender direction, the Axis SOAP message is forwarded to an Axis handler in the module processor by a servlet or task, which you can configure.

The Adapter Framework module converts the Axis SOAP message to an Adapter-Framework-compliant message and forwards it to the adapter module.

The response message takes the opposite path.

The Axis framework provides the following:

      Message protocols SOAP 1.1 and SOAP 1.2

      Transport protocols HTTP/S, SMTP, file

      Various user authentication procedures (Basic, Digest, NTLM, SAP Assertion Tickets)

      Various encapsulation formats (MIME, DIME, MTOM)

      You can add your own Axis handlers to the module chain by using the HandlerBean module

More information:

Configuring the Sender Axis SOAP Adapter

Configuring the Receiver Axis SOAP Adapter

Adding Modules in the Axis SOAP Adapter

 

End of Content Area