org.ow2.petals.binding.soap.util
Class Marshaller

java.lang.Object
  org.ow2.petals.binding.soap.util.Marshaller

public final class Marshaller
extends Object

A marshaller to create JBI message from SOAP ones and vice versa.

Author:

Christophe HAMERLING (chamerling) - eBM WebSourcing

Method Summary

static void	close() Frees all resources used by this utility class.
static void	copyAttachments(org.apache.axiom.om.OMElement from, javax.jbi.messaging.NormalizedMessage to) Create the JBI message from the OMElement object.
static org.apache.axiom.soap.SOAPBody	createSOAPBody(org.apache.axiom.soap.SOAPFactory factory, org.apache.axiom.soap.SOAPEnvelope envelope, Source source) Create a SOAPBody from a source
static org.apache.axiom.soap.SOAPBody	createSOAPBodyWithFault(org.apache.axiom.soap.SOAPFactory factory, org.apache.axiom.soap.SOAPEnvelope envelope, Source source) Create a SOAPBody from a source
static org.apache.axiom.soap.SOAPEnvelope	createSOAPEnvelope(org.apache.axiom.soap.SOAPFactory factory, javax.jbi.messaging.NormalizedMessage nm, boolean isJBIFault) Creates a SOAP response from a NormalizedMessage
static Source	createSourceContent(org.apache.axiom.soap.SOAPEnvelope soapEnvelope, boolean axis1Compatibility) Create a the JBI payload from the SOAP body.
static Source	createSourceContentAndAttachment(org.apache.axis2.context.MessageContext inContext) Create the JBI payload from the soap body.
static void	fillSOAPBodyWithAttachments(javax.jbi.messaging.NormalizedMessage nm, org.apache.axiom.soap.SOAPFactory soapFactory, org.apache.axis2.context.MessageContext messageContext) Handles attachments.
static void	setAttachments(org.apache.axiom.attachments.Attachments attachments, javax.jbi.messaging.NormalizedMessage to) Put the SOAP attachments in the normalized message
static void	setProperties(org.apache.axis2.context.MessageContext from, javax.jbi.messaging.NormalizedMessage to) Copy properties from a SOAP message to the normalized message

Methods inherited from class java.lang.Object

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

Method Detail

close

public static final void close()

Frees all resources used by this utility class.

copyAttachments

public static void copyAttachments(org.apache.axiom.om.OMElement from,
                                   javax.jbi.messaging.NormalizedMessage to)
                            throws javax.jbi.messaging.MessagingException

Create the JBI message from the OMElement object.

Parameters:

from -

outBodyElement -

to -

Throws:

javax.jbi.messaging.MessagingException

createSOAPBody

public static org.apache.axiom.soap.SOAPBody createSOAPBody(org.apache.axiom.soap.SOAPFactory factory,
                                                            org.apache.axiom.soap.SOAPEnvelope envelope,
                                                            Source source)
                                                     throws org.apache.axis2.AxisFault

Create a SOAPBody from a source

Parameters:

factory -

envelope -

response -

Returns:

Throws:

org.apache.axis2.AxisFault

createSOAPBodyWithFault

public static org.apache.axiom.soap.SOAPBody createSOAPBodyWithFault(org.apache.axiom.soap.SOAPFactory factory,
                                                                     org.apache.axiom.soap.SOAPEnvelope envelope,
                                                                     Source source)
                                                              throws org.apache.axis2.AxisFault

Create a SOAPBody from a source

Parameters:

factory -

envelope -

response -

Returns:

Throws:

org.apache.axis2.AxisFault

createSOAPEnvelope

public static org.apache.axiom.soap.SOAPEnvelope createSOAPEnvelope(org.apache.axiom.soap.SOAPFactory factory,
                                                                    javax.jbi.messaging.NormalizedMessage nm,
                                                                    boolean isJBIFault)
                                                             throws org.apache.axis2.AxisFault

Creates a SOAP response from a NormalizedMessage

Parameters:

factory - soap factory

nm - NormalizedMessage containing the response

Returns:

a SOAPEnveloppe created from the nm NomalizedMessage content

Throws:

org.apache.axis2.AxisFault

createSourceContent

public static Source createSourceContent(org.apache.axiom.soap.SOAPEnvelope soapEnvelope,
                                         boolean axis1Compatibility)
                                  throws Exception

Create a the JBI payload from the SOAP body. The SOAP envelope is required to get namespaces.

Parameters:

envelope -

axis1Compatibility -

Returns:

Throws:

Exception

createSourceContentAndAttachment

public static Source createSourceContentAndAttachment(org.apache.axis2.context.MessageContext inContext)
                                               throws Exception

Create the JBI payload from the soap body. The soap envelope is created from the inContext.getAttachmentMap().getSOAPPartInputStream() stream because it's dosen't contain the attachment as text element. That's avoid to put the attachment both in the JBI payload and in the JBI attachments.

Parameters:

inContext -

removeRootBodyElement -

Returns:

Throws:

Exception

fillSOAPBodyWithAttachments

public static final void fillSOAPBodyWithAttachments(javax.jbi.messaging.NormalizedMessage nm,
                                                     org.apache.axiom.soap.SOAPFactory soapFactory,
                                                     org.apache.axis2.context.MessageContext messageContext)
                                              throws UnsupportedEncodingException

Handles attachments. Two cases can occurs:

• NMR attachments are declared in the XML of the NMR message using MTOM/XOP,
• NMR are not declared in the XML.

In the first case, it is needed to replace the XML node that declares the attachment by the same using OMElement (it's needed by Axis API).

In the other case, each attachment is added, using MTOM/XOP, in the special node inside the SOAP Body: <soapbc:attachments xmlns:soapbc="http://petals.ow2.org/ns/soapbc">/<soapbc:attachment>

Parameters:

nm -

soapFactory -

messageContext -

Throws:

UnsupportedEncodingException

setAttachments

public static void setAttachments(org.apache.axiom.attachments.Attachments attachments,
                                  javax.jbi.messaging.NormalizedMessage to)

Put the SOAP attachments in the normalized message

Parameters:

attachments -

to -

setProperties

public static void setProperties(org.apache.axis2.context.MessageContext from,
                                 javax.jbi.messaging.NormalizedMessage to)
                          throws Exception

Copy properties from a SOAP message to the normalized message

Parameters:

from -

to - Normalized message

Throws:

Exception