[ 
https://issues.apache.org/jira/browse/AXIS2-4502?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
 ]

Rich Scheuerle resolved AXIS2-4502.
-----------------------------------

    Resolution: Fixed

> 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
>   Original Estimate: 24h
>  Remaining Estimate: 24h
>
> 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.

Reply via email to