uCosminexus Application Server, Web Service Development Guide

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

16.2.17 javax.xml.ws.ResponseWrapper annotation

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

[Figure]

Organization of this subsection
(1) localName element (javax.xml.ws.ResponseWrapper)
(2) targetNamespace element (javax.xml.ws.ResponseWrapper)
(3) className element (javax.xml.ws.ResponseWrapper)
(4) partName element (javax.xml.ws.ResponseWrapper)

(1) localName element (javax.xml.ws.ResponseWrapper)

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).

(2) targetNamespace element (javax.xml.ws.ResponseWrapper)

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:

(3) className element (javax.xml.ws.ResponseWrapper)

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:

(4) partName element (javax.xml.ws.ResponseWrapper)

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).