uCosminexus Application Server, Web Service Development Guide
The javax.xml.ws.RequestWrapper annotation can be specified in the wrapper style. If specified in the non-wrapper style, a warning message is output to the standard error output and log and the processing continues (KDJW61061-W).
The javax.xml.ws.RequestWrapper annotation is specified in SEI. If specified in the Web Service Implementation Class, this annotation is ignored. When this annotation is specified in the Web Service Implementation Class, a warning message is output to the standard error output and log and the processing continues (KDJW61077-W).
The following figure shows an example of customization with the javax.xml.ws.RequestWrapper annotation:
Figure 16-23 Example of customization with the javax.xml.ws.RequestWrapper annotation
You specify the localName element to customize the mapping of the local names of the request wrapper element. If the element value is specified in the localName element, you can also customize the type name of the wrapper element.
The precautions for specifying the localName element are as follows:
You specify the targetNamespace element to customize the mapping of the name spaces of the request wrapper element.
In the targetNamespace element, the http:// or urn: protocol is specified as a name space. The following name space formats and strings can be specified:
Table 16-22 Conditions for the strings that can be coded in the name space (javax.xml.ws.RequestWrapper)
| No. | Condition | Example of invalid string | Operation when an invalid string is specified |
|---|---|---|---|
| 1 | Strings using only one-byte alphanumeric characters (0 to 9, A to Z, a to z) | http://Hitachi.com http://133.145.224.19/ http://[1080:2C14;D30:BA04:275:806:270C:418A]/ |
The operations might not function properly (error message is not displayed). |
| 2 | Strings other than Java reserved words | http://hitachi.com/abstract | The operations might not function properly. |
| 3 | Strings that do not begin with numeric characters | http://1hitachi.com |
The className element specifies the class name of the generated request bean using a fully qualified name.
The precautions for specifying the className element are as follows:
Specify the partName element when customizing the mapping of the part name of the input message that references the request wrapper element.
Specify the partName with one-byte alphanumeric characters and underscore (_). The operation is not guaranteed if any other character is specified (no error message is output).
All Rights Reserved. Copyright (C) 2013, Hitachi, Ltd.