• For mapping from a WSDL of a request-response operation
  The following figure shows an example of mapping of parameters and return values of the Java methods and the message part of a WSDL (define one wsdl:input element and one wsdl:output element , and zero or more wsdl:fault elements) of a request-response operation.
  

  Figure 15-6 Example of mapping the message part to the parameters and return values (request-response operation)

  

• For mapping from a WSDL of a one-way operation
  The following figure shows an example of mapping of parameters of the Java method and the message part of a WSDL (define only one wsdl:input element) of a one-way operation. Also, annotate javax.jws.Oneway in the mapped Java method.
  

  Figure 15-7 Example of mapping of message parts and parameter (one-way operation)

  

During the mapping, the first character of the message part name (name attribute of the wsdl:part element) is converted into a lower-case character in both, the request-response operations and one-way operations.

Before conversion: PartName

After conversion: partName

• Relationship between the part types and the mapping to Java source
  The following table describes the relationship between the part types (in, inout, out) and the mapping to Java source:
  

  Table 15-11 Relationship between the part types and the mapping to Java source (Non-wrapper style)

  No.	WSDL part types	Mapping to Java
  		Mapped to	Mapping method
  1	in	Parameter	Not mapped using javax.xml.ws.Holder<T> class. Mapped using classes such as java.lang.String.
  2	inout	Parameter	Mapped using javax.xml.ws.Holder<T> class.
  3	out	Parameter	Mapped using javax.xml.ws.Holder<T> class.
  4		Return value	Not mapped using javax.xml.ws.Holder<T> class. Mapped using classes such as java.lang.String.

In the part name, 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 xsd:NCName type of the XML Schema specification.

Table 15-12 Conditions for strings that can be coded in the part name (non-wrapper style)

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_part	The operation might not function properly (error message is not displayed).
2	Strings other than Java reserved words #	abstract	An error message is output in the standard error output and log and the processing ends (KDJW51017-E).
3	Strings that do not begin with numeric characters	1User_part	An error message is output in the standard error output and log and the processing ends (KDJW51029-E).

#

You cannot code strings such as Abstract where the first character of the Java reserved word is in upper case (since the first character is converted into a lower case character due to mapping).

When the part that appears in the input message or output message is coded several times in WSDL, the part is handled as the same part only when the part name is the same and the global element being referenced is the same.

If either the part name or the global element being referenced is different, the part is handled as a different part.

• The part of in and inout is mapped in the order of appearance of the corresponding part in the input message. The part of out is mapped in the order of appearance of the corresponding part in the output message.
• If the part of in, inout, and out are mixed, the part of in and inout is mapped in the order of appearance of the corresponding part in the input message and then the part of out is mapped in the order of appearance of the corresponding part in the output message.
• The part of out (excluding the parameters mapped to the return value) and inout that are Java primitive type and Java array type, user-defined type are mapped to the Holder type (javax.xml.ws.Holder<T>) in the Java source. The example is as follows:
  

  Example:

  Data type of the part of out and inout: java.lang.String

  Data type after mapping to Java: javax.xml.ws.Holder<java.lang.String>

If there is only 1 part of out in the output message, the part is mapped to the return value of the method. If there are 2 or more parts of out, the parts are mapped to the return value.