uCosminexus Service Platform, Basic Development Guide

[Contents][Glossary][Index][Back][Next]

4.3.2 Creating a Service Component Message (for Web Services)

If the service component you want to use is a Web Service, you need not create an XML format definition file for the service component message. An XML format definition file is automatically created when the service adapter is created.

However, before creating the service adapter, you must prepare a WSDL file that fulfills the conditions described in 2.6.1 Applicability of the service components that use Web service.

Notes: When Web Service throws a user-defined exception with the SOAP Communication Infrastructure
When the communication style of the WSDL generated by the WSDL generating function of the SOAP application development support function is rpc, you must modify the WSDL and create a corresponding adapter.
When the communication style of the generated WSDL is document, there is no need to modify the WSDL. When a Cosminexus Service Platform uses fault, Hitachi recommends that you use WSDL in the document format.
To modify the WSDL:
  1. Define xsd:element.
    Define the xsd:element element in the xsd:schema element inside the wsdl:types element that has the same targetNamespace attribute as the name space indicated by the targetNamespace attribute of the wsdl:definitions element.
  2. Obtain the corresponding wsdl:message element from the value of the message attribute of the wsdl:fault element in the wsdl:operation element inside the wsdl:portType element. Check the wsdl:part element contained inside.
  3. Add the name attribute to the xsd:element element defined in step 1.
    Use the same value as the local name of the type attribute of the wsdl:part element obtained in step 2.
  4. Following the same procedure as in step 3, add the type attribute.
    Use the same value as the type attribute of the wsdl:part element obtained in step 2.
  5. From the wsdl:part element checked in step 2, delete the type attribute and add a new element attribute.
    For the name space prefix, use the prefix that indicates the xsd:schema element inside the wsdl:types element referenced in step 1. Additionally, set the local name to the same value as the name attribute added in step 3.
 
After you have modified the WSDL, you need to re-create Web Services itself.
Execute the command shown below and re-create a skeleton for Web Services from the modified WSDL.
 
WSDL2Java -s WSDL-file
 
For details about the WSDL2Java command, see the section related to skeletons in the manual Cosminexus Application Server SOAP Application Development Guide