uCosminexus Application Server, Web Service Development Guide

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

15.1.2 Mapping a port type to a SEI name

This subsection describes the mapping of a WSDL port type name (name attribute of the wsdl:portType element) to a SEI name.

Organization of this subsection
(1) Mapping
(2) Conditions for the port type name
(3) Number of port types coded

(1) Mapping

The WSDL port type and SEI name are mapped in accordance with the JAX-WS2.2 specifications. The following figure shows an example of mapping:

Figure 15-2 Example of mapping the port type to the SEI name

[Figure]

During mapping, the first character of the WSDL port type name is converted into an upper case character. The following is an example of conversion:

Before conversion: portTypeName

After conversion: PortTypeName

(2) Conditions for the port type name

When specifying a port type name and a namespace for a WSDL, confirm that the SEI name, including the package name, is not changed to javax.xml.ws.Provider. Therefore, do not specify Provider or provider in the port type name. Also, do not specify http://ws.xml.javax in the namespace.

In the port type, you can code a string that fulfills all the conditions described in the following table. However, when customizing with the binding declaration, you can code the strings that can be used as the xsd:NCName type of the XML Schema specification.

Table 15-3 Conditions for strings that can be coded in the port type

No. Conditions Examples of invalid strings Operations when invalid strings are specified
1 Strings using only one-byte alphanumeric characters (0 to 9, A to Z, a to z) and underscore (_) Hitachi_portType The operation might not function properly (error message is not displayed).
2 Strings that do not begin with numeric characters 1User_portType An error message is output in the standard error output and log and the processing ends (KDJW51029-E).

(3) Number of port types coded

You can code 1 to 255 port types in WSDL. The following table describes the relationship between the number of port types coded and the operations:

Table 15-4 Relationship between the number of port types coded and the operations

No. Elements Number of coding Operations when invalid strings are specified
1 wsdl:portType 0 An error message is output in the standard error output and log and the processing ends (KDJW51008-E).
2 1 to 255 Terminates normally.
3 256 or more An error message is output in the standard error output and log and the processing ends (KDJW51008-E).