org.apache.synapse.util

Class MessageHelper

java.lang.Object

org.apache.synapse.util.MessageHelper

public class MessageHelper
extends Object

Constructor Summary

Constructors

Constructor and Description
MessageHelper()

Method Summary

Modifier and Type	Method and Description
static org.apache.axis2.context.MessageContext	cloneAxis2MessageContext(org.apache.axis2.context.MessageContext mc) This method will simulate cloning the message context and creating an exact copy of the passed message.
static MessageContext	cloneMessageContext(MessageContext synCtx) This method will simulate cloning the message context and creating an exact copy of the passed message.
static org.apache.axis2.client.Options	cloneOptions(org.apache.axis2.client.Options options) Clones the given Options object.
static org.apache.axis2.context.MessageContext	clonePartially(org.apache.axis2.context.MessageContext ori)
static org.apache.axiom.soap.SOAPEnvelope	cloneSOAPEnvelope(org.apache.axiom.soap.SOAPEnvelope envelope) This method will clone the provided SOAPEnvelope and returns the cloned envelope as an exact copy of the provided envelope
static Map	getClonedTransportHeaders(org.apache.axis2.context.MessageContext msgCtx)
static org.apache.neethi.Policy	getPolicy(MessageContext synCtx, String propertyKey) Get the Policy object for the given name from the Synapse configuration at runtime
static org.apache.axiom.soap.SOAPEnvelope	removeAddressingHeaders(org.apache.axis2.context.MessageContext axisMsgCtx) Removes Submission and Final WS-Addressing headers and return the SOAPEnvelope from the given message context
static void	removeProcessedHeaders(org.apache.axis2.context.MessageContext axisMsgCtx, boolean preserveAddressing) Remove the headers that are marked as processed.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

MessageHelper

public MessageHelper()

Method Detail

cloneMessageContext

public static MessageContext cloneMessageContext(MessageContext synCtx)
                                          throws org.apache.axis2.AxisFault

This method will simulate cloning the message context and creating an exact copy of the passed message. One should use this method with care; that is because, inside the new MC, most of the attributes of the MC like opCtx and so on are still kept as references inside the axis2 MessageContext for performance improvements. (Note: You don't have to worry about the SOAPEnvelope, it is a cloned copy and not a reference from any other MC)

Parameters:

synCtx - - this will be cloned

Returns:

cloned Synapse MessageContext

Throws:

org.apache.axis2.AxisFault - if there is a failure in creating the new Synapse MC or in a failure in cloning the underlying axis2 MessageContext

See Also:

cloneAxis2MessageContext(org.apache.axis2.context.MessageContext)

cloneAxis2MessageContext

public static org.apache.axis2.context.MessageContext cloneAxis2MessageContext(org.apache.axis2.context.MessageContext mc)
                                                                        throws org.apache.axis2.AxisFault

This method will simulate cloning the message context and creating an exact copy of the passed message. One should use this method with care; that is because, inside the new MC, most of the attributes of the MC like opCtx and so on are still kept as references. Otherwise there will be performance issues. But ..... this may reveal in some conflicts in the cloned message if you try to do advanced mediations with the cloned message, in which case you should manually get a clone of the changing part of the MC and set that cloned part to your MC. Changing the MC after doing that will solve most of the issues. (Note: You don't have to worry about the SOAPEnvelope, it is a cloned copy and not a reference from any other MC)

Parameters:

mc - - this will be cloned for getting an exact copy

Returns:

cloned MessageContext from the given mc

Throws:

org.apache.axis2.AxisFault - if there is a failure in copying the certain attributes of the provided message context

getClonedTransportHeaders

public static Map getClonedTransportHeaders(org.apache.axis2.context.MessageContext msgCtx)

clonePartially

public static org.apache.axis2.context.MessageContext clonePartially(org.apache.axis2.context.MessageContext ori)
                                                              throws org.apache.axis2.AxisFault

Throws:

org.apache.axis2.AxisFault

cloneSOAPEnvelope

public static org.apache.axiom.soap.SOAPEnvelope cloneSOAPEnvelope(org.apache.axiom.soap.SOAPEnvelope envelope)

This method will clone the provided SOAPEnvelope and returns the cloned envelope as an exact copy of the provided envelope

Parameters:

envelope - - this will be cloned to get the new envelope

Returns:

cloned SOAPEnvelope from the provided one

cloneOptions

public static org.apache.axis2.client.Options cloneOptions(org.apache.axis2.client.Options options)

Clones the given Options object. This is not a deep copy because this will be called for each and every message going out from synapse. The parent of the cloning options object is kept as a reference.

Parameters:

options - cloning object

Returns:

cloned Options object

removeAddressingHeaders

public static org.apache.axiom.soap.SOAPEnvelope removeAddressingHeaders(org.apache.axis2.context.MessageContext axisMsgCtx)

Removes Submission and Final WS-Addressing headers and return the SOAPEnvelope from the given message context

Parameters:

axisMsgCtx - the Axis2 Message context

Returns:

the resulting SOAPEnvelope

getPolicy

public static org.apache.neethi.Policy getPolicy(MessageContext synCtx,
                                                 String propertyKey)

Get the Policy object for the given name from the Synapse configuration at runtime

Parameters:

synCtx - the current synapse configuration to get to the synapse configuration

propertyKey - the name of the property which holds the Policy required

Returns:

the Policy object with the given name, from the configuration

removeProcessedHeaders

public static void removeProcessedHeaders(org.apache.axis2.context.MessageContext axisMsgCtx,
                                          boolean preserveAddressing)

Remove the headers that are marked as processed.

Parameters:

axisMsgCtx - the Axis2 Message context

preserveAddressing - if true preserve the addressing headers