uCosminexus Application Server, Web Service Development Guide
The javax.xml.ws.ResponseWrapper 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 (KDJW61062-W).
The javax.xml.ws.ResponseWrapper 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 (KDJW61078-W).
The following figure shows an example of customization with the javax.xml.ws.ResponseWrapper annotation:
Figure 16-24 Example of customization with the javax.xml.ws.ResponseWrapper annotation
You specify the localName element to customize the mapping of the local names of the response wrapper element. If the element value is specified in the localName element, you can also customize the type name of the wrapper element.
Specify the localName element using one-byte alphanumeric characters and underscore (_). If other characters are specified, the operations might not function properly (error message is not output).
You specify the targetNamespace element to customize the mapping of the name spaces of the response 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-23 Conditions for the strings that can be coded in the name space (javax.xml.ws.ResponseWrapper)
| 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 response bean using a fully qualified name.
The precautions for specifying the className element are as follows:
Specify the partName element when customizing the part name of the output message that references the request wrapper element.
Specify the partName with one-byte alphanumeric characters and underscore (_). If you specify partName with any other character, the operation is not guaranteed. (no error message is output).
All Rights Reserved. Copyright (C) 2013, Hitachi, Ltd.