org.springframework.ws.soap
Interface SoapMessageFactory

All Superinterfaces:

WebServiceMessageFactory

All Known Implementing Classes:

AxiomSoapMessageFactory, SaajSoapMessageFactory

public interface SoapMessageFactory
extends WebServiceMessageFactory

Sub-interface of WebServiceMessageFactory which contains SOAP-specific properties and methods.

The soapVersion property can be used to indicate the SOAP version of the factory. By default, the version is SoapVersion.SOAP_11.

Since:

1.0.0

Author:

Arjen Poutsma

Method Summary

SoapMessage	createWebServiceMessage() Creates a new, empty SoapMessage.
SoapMessage	createWebServiceMessage(InputStream inputStream) Reads a SoapMessage from the given input stream.
void	setSoapVersion(SoapVersion version) Sets the SOAP Version used by this factory.

Method Detail

setSoapVersion

void setSoapVersion(SoapVersion version)

Sets the SOAP Version used by this factory.

Parameters:

version - the version constant

See Also:

SoapVersion.SOAP_11, SoapVersion.SOAP_12

createWebServiceMessage

SoapMessage createWebServiceMessage()

Creates a new, empty SoapMessage.

Specified by:

createWebServiceMessage in interface WebServiceMessageFactory

Returns:

the empty message

createWebServiceMessage

SoapMessage createWebServiceMessage(InputStream inputStream)
                                    throws IOException

Reads a SoapMessage from the given input stream.

If the given stream is an instance of TransportInputStream, the headers will be read from the request.

Specified by:

createWebServiceMessage in interface WebServiceMessageFactory

Parameters:

inputStream - the input stream to read the message from

Returns:

the created message

Throws:

IOException - if an I/O exception occurs