NonStop SOAP for Java User's Manual

NonStop SOAP for Java User’s Manual—523860-001
4-1
4 SOAP Deployment Descriptor
This section describes how to expose a Web service by using deployment descriptors.
Deployment descriptors are an integral part of the Java 2 Platform Enterprise Edition
(J2EE) Web applications. Deployment descriptors help manage the configuration of
Web applications once the Web applications are deployed.
Deployment Descriptors
NonStop SOAP for Java uses deployment descriptors (XML documents) to provide
information to the SOAP runtime about the services that should be made available to
clients. The deployment descriptors provide a wide array of information such as, the
URN for the service (which is used to route the request when it comes in), and the
method and class details if a Java class is providing the service. The exact content of
the deployment descriptor depends upon the type of artifact that is being exposed
using SOAP.
SOAP to Java Class Deployment Descriptor
Example 4-1 shows a deployment descriptor file that exposes a service implemented
using a standard Java class (including a normal Java bean).
isd:service
This tag defines the isd namespace and gives the name of the service as
“urn:service-urn” in the id attribute. This attribute is required.
type attribute
If the service is message-oriented instead of being RPC, use type=”message.”
This attribute is optional.
Example 4-1. Deployment Descriptor File (SOAP to Java Class)
<isd:service xmlns:isd="http://xml.apache.org/xml-soap/deployment"
id="urn:service-urn" [type="message"] [checkMustUnderstand="true|false"]>
<isd:provider type="java"
scope="Request | Session | Application"
methods="exposed-methods">
<isd:java class="implementing-class" [static="true|false"]/>
</isd:provider>
<isd:faultListener>org.apache.soap.server.DOMFaultListener
</isd:faultListener>
</isd:service>