org.apache.axis2.transport.http

Class MultipartFormDataFormatter

java.lang.Object

org.apache.axis2.transport.http.MultipartFormDataFormatter

All Implemented Interfaces:

MessageFormatter

public class MultipartFormDataFormatter
extends Object
implements MessageFormatter

Formates the request message as multipart/form-data. An example of this serialization is shown below which was extracted from the Web Services Description Language (WSDL) Version 2.0 Part 2: Adjuncts

The following instance data of an input message:

Fréjus France @@@@-@@-@@

with the following operation element

will serialize the message as follow:

Content-Type: multipart/form-data; boundary=AaB03x Content-Length: xxx

--AaB03x Content-Disposition: form-data; name="town" Content-Type: application/xml

Fréjus France --AaB03x Content-Disposition: form-data; name="date" Content-Type: text/plain; charset=utf-8

Field Summary

Fields

Modifier and Type	Field and Description
static String	DEFAULT_CONTENT_TYPE
static String	DISPOSITION_TYPE

Constructor Summary

Constructors

Constructor and Description
MultipartFormDataFormatter()

Method Summary

Modifier and Type	Method and Description
String	formatSOAPAction(MessageContext messageContext, org.apache.axiom.om.OMOutputFormat format, String soapAction)
String	getContentType(MessageContext messageContext, org.apache.axiom.om.OMOutputFormat format, String soapAction) Different message formats can set their own content types Eg: JSONFormatter can set the content type as application/json
URL	getTargetAddress(MessageContext messageContext, org.apache.axiom.om.OMOutputFormat format, URL targetURL) Some message formats may want to alter the target url.
void	writeTo(MessageContext messageContext, org.apache.axiom.om.OMOutputFormat format, OutputStream outputStream, boolean preserve) To support deffered writing transports as in http chunking..

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_CONTENT_TYPE

public static final String DEFAULT_CONTENT_TYPE

See Also:

Constant Field Values

DISPOSITION_TYPE

public static final String DISPOSITION_TYPE

See Also:

Constant Field Values

Constructor Detail

MultipartFormDataFormatter

public MultipartFormDataFormatter()

Method Detail

getContentType

public String getContentType(MessageContext messageContext,
                             org.apache.axiom.om.OMOutputFormat format,
                             String soapAction)

Different message formats can set their own content types Eg: JSONFormatter can set the content type as application/json

Specified by:

getContentType in interface MessageFormatter

Parameters:

messageContext -

format -

soapAction -

getTargetAddress

public URL getTargetAddress(MessageContext messageContext,
                            org.apache.axiom.om.OMOutputFormat format,
                            URL targetURL)
                     throws AxisFault

Some message formats may want to alter the target url.

Specified by:

getTargetAddress in interface MessageFormatter

Returns:

the target URL

Throws:

AxisFault

formatSOAPAction

public String formatSOAPAction(MessageContext messageContext,
                               org.apache.axiom.om.OMOutputFormat format,
                               String soapAction)

Specified by:

formatSOAPAction in interface MessageFormatter

Returns:

this only if you want set a transport header for SOAP Action

writeTo

public void writeTo(MessageContext messageContext,
                    org.apache.axiom.om.OMOutputFormat format,
                    OutputStream outputStream,
                    boolean preserve)
             throws AxisFault

Description copied from interface: MessageFormatter

To support deffered writing transports as in http chunking.. Axis2 was doing this for some time..

Preserve flag can be used to preserve the envelope for later use. This is usefull when implementing authentication machnisms like NTLM.

Specified by:

writeTo in interface MessageFormatter

preserve - : do not consume the OM when this is set..

Throws:

AxisFault