Package org.springframework.ws.soap.soap11

Interface Soap11Body

All Superinterfaces:

SoapBody, SoapElement

public interface Soap11Body
extends SoapBody

Subinterface of SoapBody that exposes SOAP 1.1 functionality. Necessary because SOAP 1.1 differs from SOAP 1.2 with respect to SOAP Faults.

Since:

1.0.0

Author:

Arjen Poutsma

See Also:

• Soap11Fault

Method Summary

Modifier and Type	Method	Description
Soap11Fault	addClientOrSenderFault(String faultStringOrReason, Locale locale)	Adds a Client/Sender fault to the body.
Soap11Fault	addFault(QName faultCode, String faultString, Locale faultStringLocale)	Adds a SOAP 1.1 Fault to the body with a localized message.
Soap11Fault	addMustUnderstandFault(String faultStringOrReason, Locale locale)	Adds a MustUnderstand fault to the body.
Soap11Fault	addServerOrReceiverFault(String faultStringOrReason, Locale locale)	Adds a Server/Receiver fault to the body.
Soap11Fault	addVersionMismatchFault(String faultStringOrReason, Locale locale)	Adds a VersionMismatch fault to the body.
Soap11Fault	getFault()	Returns the SoapFault of this body.

Methods inherited from interface org.springframework.ws.soap.SoapBody

getPayloadResult, getPayloadSource, hasFault

Methods inherited from interface org.springframework.ws.soap.SoapElement

addAttribute, addNamespaceDeclaration, getAllAttributes, getAttributeValue, getName, getSource, removeAttribute

Method Details

addFault

Soap11Fault addFault(QName faultCode,
 String faultString,
 Locale faultStringLocale)
              throws SoapFaultException

Adds a SOAP 1.1 Fault to the body with a localized message. Adding a fault removes the current content of the body.

Parameters:

faultCode - the fully qualified fault faultCode

faultString - the faultString

faultStringLocale - the faultString locale. May be null

Returns:

the added Soap11Fault

Throws:

IllegalArgumentException - if the fault faultCode is not fully qualified

SoapFaultException

getFault

Soap11Fault getFault()

Description copied from interface: SoapBody

Returns the SoapFault of this body.

Specified by:

getFault in interface SoapBody

Returns:

the SoapFault, or null if none is present

addMustUnderstandFault

Soap11Fault addMustUnderstandFault(String faultStringOrReason,
 Locale locale)
                            throws SoapFaultException

Description copied from interface: SoapBody

Adds a MustUnderstand fault to the body. A MustUnderstand is returned when a SOAP header with a MustUnderstand attribute is not understood.

Adding a fault removes the current content of the body.

Specified by:

addMustUnderstandFault in interface SoapBody

Parameters:

faultStringOrReason - the SOAP 1.1 fault string or SOAP 1.2 reason text

locale - the language of faultStringOrReason. Optional for SOAP 1.1

Returns:

the created SoapFault

Throws:

SoapFaultException

addClientOrSenderFault

Soap11Fault addClientOrSenderFault(String faultStringOrReason,
 Locale locale)
                            throws SoapFaultException

Description copied from interface: SoapBody

Adds a Client/Sender fault to the body. For SOAP 1.1, this adds a fault with a Client fault code. For SOAP 1.2, this adds a fault with a Sender code.

Adding a fault removes the current content of the body.

Specified by:

addClientOrSenderFault in interface SoapBody

Parameters:

faultStringOrReason - the SOAP 1.1 fault string or SOAP 1.2 reason text

locale - the language of faultStringOrReason. Optional for SOAP 1.1

Returns:

the created SoapFault

Throws:

SoapFaultException

addServerOrReceiverFault

Soap11Fault addServerOrReceiverFault(String faultStringOrReason,
 Locale locale)
                              throws SoapFaultException

Description copied from interface: SoapBody

Adds a Server/Receiver fault to the body. For SOAP 1.1, this adds a fault with a Server fault code. For SOAP 1.2, this adds a fault with a Receiver code.

Adding a fault removes the current content of the body.

Specified by:

addServerOrReceiverFault in interface SoapBody

Parameters:

faultStringOrReason - the SOAP 1.1 fault string or SOAP 1.2 reason text

locale - the language of faultStringOrReason. Optional for SOAP 1.1

Returns:

the created SoapFault

Throws:

SoapFaultException

addVersionMismatchFault

Soap11Fault addVersionMismatchFault(String faultStringOrReason,
 Locale locale)
                             throws SoapFaultException

Description copied from interface: SoapBody

Adds a VersionMismatch fault to the body.

Adding a fault removes the current content of the body.

Specified by:

addVersionMismatchFault in interface SoapBody

Parameters:

faultStringOrReason - the SOAP 1.1 fault string or SOAP 1.2 reason text

locale - the language of faultStringOrReason. Optional for SOAP 1.1

Returns:

the created SoapFault

Throws:

SoapFaultException