• The Oracle SALT Web Service Definition File (WSDF) is an XML-based file used to define Oracle SALT Web service components (for example, Web Service Bindings, Web Service Operations, Web Service Policies, and so on). WSDF is a SALT specific representation of the Web Service Definition Language data model. There are two WSDF types:
• Native WSDF (Tuxedo generated)A native WSDF is composed manually. You must define a set of Tuxedo services and how they are exposed as Web services in a native WSDF. The native WSDF is similar to the SALT 1.1 configuration file.
Note:
• Non-native WSDF (Externally generated)A non-native WSDF is generated from an external WSDL file via the SALT WSDL converter (wsdlcvt). In most cases, you do not need to change the generated WSDF except for configuring advanced features.Figure A‑1 shows a graphical representation of the WSDF format.Figure A‑1 SALT Web Service Definition File FormatAn XML Schema is associated with the WSDF. The XML Schema file that describes the WSDF format is located in the following directory: $TUXDIR/udataobj/salt/wsdf.xsd.Listing A‑1 Native WSDF (Composed Manually)The WSDF file root element.
The WSDF name. This attribute value may contain a maximum of 30 characters (excluding the terminating NULL character).Native WSDF: you must manually provide a distinct application name.Non-native WSDF: this value is the same as the WSDL converter (wsdlcvt) command line input parameter “output_basename. Native WSDF: you can optionally specify a distinct URI string so that the generated WSDL can use this as the target namespace. If not specified, the default WSDL target namespace is as follows: "urn:<wsdf_name>.wsdl". For example, if the WSDF name is “simpapp”, then the default WSDL target namespace is “urn:simpapp.wsdl”. Native WSDF: you can set SOAP version, encoding style, several endpoints for Web Service Client connection through sub element <SOAP> and a set of Tuxedo services to be exposed for invocation through sub element <Servicegroup>.Non-native WSDF: each SOAP binding object (i.e., wsdl:binding object with soap:binding extension) in the external WSDL document is translated into one WSBinding object.
Native WSDF: the value is specified by customers and is used as the wsdl:binding name in the generated WSDL document.Non-native WSDF: the value is the wsdl:binding name defined in the external WSDL document.
Native WSDF: the value is specified by customers and is used as the wsdl:portType name in the generated WSDL document.Non-native WSDF: the value is the wsdl:portType name defined in the external WSDL document. Non-native WSDF: each service represents a converted Tuxedo service from a wsdl:operation object defined in the external WSDL document.
Native WSDF: the service name value is used as the wsdl:operation name in the generated WSDL document.Non-native WSDF: the service name is equal to the wsdl:operation name defined in the external WSDL document. If not specified, attribute "name" value is used as the reference value. Specifies the service soapAction attribute. This is a non-native WSDF attribute. It is used to save the soapAction setting for each wsdl:operation defined in the external WSDL document. Specifies service namespace attribute. This is a non-native WSDF attribute. It is used to save the namespace setting for each wsdl:operation defined in the external WSDL document.
Specifies the service input message name attribute. This is a non-native WSDF attribute. It is used is used to save the name for the input wsdl:message defined in the external WSDL document. Specifies the service input message wsaAction attribute. This is a non-native WSDF attribute. It is used is used to save the wsaAction attribute of the input wsdl:message defined in the external WSDL document.
Specifies the service output message name attribute. This is a non-native WSDF attribute. It is used to save the name for the output wsdl:message defined in the external WSDL document. Specifies the service output message name attribute. This is a non-native WSDF attribute. It is used to save the wsaAction attribute of the output wsdl:message defined in the external WSDL document.
Specifies the service fault message name attribute. This is a non-native WSDF attribute. It is used to save the name for the fault wsdl:message defined in the external WSDL document. Specifies the service fault message wsaAction attribute. This is a non-native WSDF attribute. It is used to save the wsaAction attribute of the fault wsdl:message defined in the external WSDL document. Specifies a customized message conversion handler. Optional for <Input>, <Output> and/or <Fault> elements of any service. The value of this element is the handler name, which may contain a maximum of 30 characters (excluding the terminating NULL character).For more information, see “Programming Message Conversion Plug-ins in the Oracle SALT Programming Web Services.
• <Servicegroup> level
• <Service> level
Specifically, Oracle SALT pre-defines WS-Policy template files for typical WS-* scenarios. These files can be found under the $TUXDIR/udataobj/salt/policy directory. You can reference these template files using the string format “salt:<template_file_name>”.For example, if you want to reference SALT WS-SecurityPolicy 1.0 template file “wssp1.0-signbody.xml”, you should define the following XML snippet in the WSDF file:
•
•
Specifies the property name. Table A‑10 lists all the GWWS server properties.
Default: 60 secs. Default: False
Specifies SOAP version for this WSBinding object. The valid values are “1.1” and “1.2”. If not specified, "1.1" is used. Specifies SOAP message style for this WSBinding object. The valid values are “rpc” and “document”. If not specified, "document" is used. Specifies SOAP message encoding style for this WSBinding object. The valid values are “encoded” and “literal”.If not specified explicitly, this value is automatically selected according to “style” value. If “style” is “rpc”, then “encoded” is used; if “style” is “document”, then “literal” is used.
Note: Specifies the endpoint list for the WSBinding object. Each sub element <Endpoint> represents one particular endpoint.
"http(s)://<host>:<port>/<context_path>" For more information, see “Configuring Transport Level Security” in the Oracle SALT Administration Guide.