uCosminexus Application Server, Web Service Development Guide

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

16.2.15 javax.xml.ws.FaultAction annotation

With the javax.xml.ws.FaultAction annotation, specify a value of the wsa:Action element of the addressing header used by the Web Service, when sending a fault message.

You can specify the javax.xml.ws.FaultAction annotation only in the fault element of the javax.xml.ws.Action annotation. This annotation is disabled even when specified in the SEI and a Service Implementation Class.

Organization of this subsection
(1) className element (javax.xml.ws.FaultAction)
(2) value element (javax.xml.ws.FaultAction)

(1) className element (javax.xml.ws.FaultAction)

The className element is a required element of the javax.xml.ws.FaultAction annotation. Specify the class name of the exception class sent by the Web Service. If you do not specify the className element, an exception occurs in the JAX-WS engine at the Web Service machine, and the Web Services cannot be started (KDJW40013-E).

Note that the operation is not guaranteed if any class other than the exception class that is sent by the Web Services is specified in the className element.

The className element is referenced only when starting the Web Services. This is not interpreted when executing the apt command or the cjwsgen command.

(2) value element (javax.xml.ws.FaultAction)

In the value element, specify the value of the wsa:Action element of the addressing header that is used by the Web Service, when sending the fault message of the exception class specified in the className element. In the value element, specify the characters that satisfy xsd:anyURI stipulated in RFC 2396. If you specify any other character, the operation is not guaranteed.

If you specify a blank space in the output element, the blank space will become the value of the wsa:Action element of the addressing header. If you specify a blank character, the specification is ignored, and it will be assumed that you have not coded the value element.

The value element is referenced when starting the Web Services. This is not interpreted when executing the apt command or the cjwsgen command.