JAX-WS Needs a property to prevent lossy transformations before the application
handlers are called
---------------------------------------------------------------------------------------------------
Key: AXIS2-4502
URL: https://issues.apache.org/jira/browse/AXIS2-4502
Project: Axis 2.0 (Axis2)
Issue Type: Bug
Components: jaxws
Reporter: Rich Scheuerle
Assignee: Rich Scheuerle
Problem:
When a message is received, we want to quickly transform the message into the
"final form" to reduce memory and increase speed.
For example, in the JAX-WS server inbound case, the message payload is
transformed into a JAXB object (which is what the JAXWS @WebService needs).
However if the customer has installed a JAX-WS soap handler AND that handler
inspects the message payload (the contents of the soap Body), then
the JAXB object must be "re-transformed" into an SAAJ tree.
This re-transformation is slow and is also "lossy". For example, the
namespaces in the original message and post-JAXB message may be different.
Most SOAP Handlers don't touch the SOAP body. The JAX-WS specification does
not provide a mechanism to allow SOAP Handlers to tell the engine their
"intent".
So we want to expose an option that would allow a customer (developer or
administrator) to preserve the original message.
Solution:
The Axis JAX-RPC web service engine had a property call "high fidelity". The
intention of the property was to preserve the original message.
I am working on a fix to introduce a "jaxws.payload.highFidelity" property.
The property will be available for programatic property (used by the developer
)or as a configuration parameter (used by an administrator).
**
* Context Property:
* Name: jaxws.payload.highFidelity
* Value: Boolean.TRUE or Boolean.FALSE
* Default: null, which is interpreted as FALSE....engine may set this to
TRUE in some cases.
*
* Configuration Parameter
* Name: jaxws.payload.highFidelity
* Value: String or Boolean representing true or false
* Default: null, which is interpreted as FALSE
*
* Description:
* If the value is false, the jax-ws engine will transform the message in
the most
* performant manner. In some cases these transformations will cause the
loss of some information.
* For example, JAX-B transformations are lossy.
*
* If the value is true, the jax-ws engine will transform the message in
the most loss-less manner.
* In some cases this will result in slower performance. The message in
such cases is "high fidelity",
* which means that it is a close replica of the original message.
*
* Customers should accept the default behavior (false), and only set the
value to true if it is
* necessary for a SOAP Handler or other code requires a high fidelity
message.
*
* The engine will first examine the Context property. If not set, the
value of the Configuration
* property is used.
*/
public static final String JAXWS_PAYLOAD_HIGH_FIDELITY =
"jaxws.payload.highFidelity";
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
