Document literal style web services

You need to create a web service to deploy a document literal style web service. Your web service needs to include a WSDL that defines the schema of the service and a IBM® Product Master trigger script to start when a request is encountered.

When you save the web service, you need to select the web service that you want to deploy. Upon deployment, Product Master creates a URL for the web service where you can access the deployed WSDL. The URL of the web service has the following form:

http://application-webserver:application-port-number/services/stored-webservice-name

If you append the ?wsdl string to the end of the URL, you get the path to the stored WSDL for the web service.

A request for a document literal web service is enclosed in a SOAP envelope, and the body of the SOAP message includes the request document in its entirety. This request document must be in correct XML form, and is passed to the Product Master web service handler as-is. A caller then creates this request with prior knowledge of the format of the schema node of the stored WSDL for the web service that is being started.

The Product Master web service mechanism receives this request and validates its contents against the WSDL schema for document literal style requests. If the request does not adhere to the WSDL schema, an AxisFault is thrown. Otherwise, Product Master eliminates the namespace references from the request body and passes the modified request to the Product Master trigger script, which is stored at deployment time. The namespace removal is required because the Product Master script context is not able to handle namespace-enabled XML documents. The Product Master trigger script takes the contents of the request and uses them as defined by the script author. The script must output its results as a valid response to the incoming request. Therefore, the response is validated against the WSDL before returning the output.

Known limitations

Namespace must be defined on schema node of WSDL: When you deploy document literal style web services, the namespace declaration must be defined locally on the schema node of the WSDL.
Newly created web services do not automatically deploy: If you receive an error when you attempt to start the newly created web service, allow write access to the Axis configuration file server-config.wsdd under the public_html/WEB-INF directory.
The style of the web service cannot be changed: You cannot change the style of a web service that is deployed. For example, if you create a DOCUMENT-LITERAL service and deploy it, you cannot change the service to be an RPC-ENCODED service.