org.opensaml.soap.util

Class SOAPSupport

java.lang.Object

org.opensaml.soap.util.SOAPSupport

public final class SOAPSupport
extends Object

Helper methods for working with SOAP.

Constructor Summary

Constructors

Modifier	Constructor and Description
private	SOAPSupport() Private constructor.

Method Summary

Methods

Modifier and Type	Method and Description
static void	addHeaderBlock(MessageContext messageContext, org.opensaml.core.xml.XMLObject headerBlock) Add a header block to the SOAP envelope contained within the specified message context's SOAP subcontext.
static void	addSOAP11ActorAttribute(org.opensaml.core.xml.XMLObject soapObject, String actorURI) Adds a soap11:actor attribute to the given SOAP object.
static void	addSOAP11EncodingStyle(org.opensaml.core.xml.XMLObject soapObject, String encodingStyle) Adds a single encoding style to the given SOAP object.
static void	addSOAP11EncodingStyles(org.opensaml.core.xml.XMLObject soapObject, List<String> encodingStyles) Adds a soap11:encodingStyle attribute to the given SOAP object.
static void	addSOAP11HeaderBlock(Envelope envelope, org.opensaml.core.xml.XMLObject headerBlock) Add a header to the SOAP 1.1 Envelope.
static void	addSOAP11MustUnderstandAttribute(org.opensaml.core.xml.XMLObject soapObject, boolean mustUnderstand) Adds a soap11:mustUnderstand attribute to the given SOAP object.
static void	addSOAP12EncodingStyleAttribute(org.opensaml.core.xml.XMLObject soapObject, String style) Adds the soap12:encodingStyle attribute to the given soap object.
static void	addSOAP12MustUnderstandAttribute(org.opensaml.core.xml.XMLObject soapObject, boolean mustUnderstand) Adds a soap12:mustUnderstand attribute to the given SOAP object.
static void	addSOAP12RelayAttribute(org.opensaml.core.xml.XMLObject soapObject, boolean relay) Adds a soap12:relay attribute to the given SOAP object.
static void	addSOAP12RoleAttribute(org.opensaml.core.xml.XMLObject soapObject, String role) Adds the soap12:role attribute to the given soap object.
static Fault	buildSOAP11Fault(QName faultCode, String faultString, String faultActor, List<org.opensaml.core.xml.XMLObject> detailChildren, Map<QName,String> detailAttributes) Build a SOAP 1.1.
static List<org.opensaml.core.xml.XMLObject>	getInboundHeaderBlock(MessageContext messageContext, QName headerName, Set<String> targetNodes, boolean isFinalDestination) Get a header block from the SOAP envelope contained within the specified message context's SOAP subcontext.
static String	getSOAP11ActorAttribute(org.opensaml.core.xml.XMLObject soapObject) Gets the soap11:actor attribute from a given SOAP object.
static List<String>	getSOAP11EncodingStyles(org.opensaml.core.xml.XMLObject soapObject) Gets the list value of the soap11:encodingStyle attribute from the given SOAP object.
static List<org.opensaml.core.xml.XMLObject>	getSOAP11HeaderBlock(Envelope envelope, QName headerName, Set<String> targetNodes, boolean isFinalDestination) Get a header block from the SOAP 1.1 envelope.
static boolean	getSOAP11MustUnderstandAttribute(org.opensaml.core.xml.XMLObject soapObject) Get the soap11:mustUnderstand attribute from a given SOAP object.
static String	getSOAP12EncodingStyleAttribute(org.opensaml.core.xml.XMLObject soapObject) Gets the soap12:encodingStyle.
static boolean	getSOAP12MustUnderstandAttribute(org.opensaml.core.xml.XMLObject soapObject) Get the soap12:mustUnderstand attribute from a given SOAP object.
static boolean	getSOAP12RelayAttribute(org.opensaml.core.xml.XMLObject soapObject) Get the soap12:relay attribute from a given SOAP object.
static String	getSOAP12RoleAttribute(org.opensaml.core.xml.XMLObject soapObject) Gets the soap12:role.
static boolean	isSOAP11HeaderTargetedToNode(org.opensaml.core.xml.XMLObject header, Set<String> nodeActors, boolean isFinalDestination) Evaluate whether the specified header block is targeted to a SOAP 1.1 node given the specified parameters.
static boolean	isSOAPMessage(MessageContext<? extends org.opensaml.core.xml.XMLObject> messageContext) Determine whether the message represented by the message context contains a SOAP Envelope.

Methods inherited from class java.lang.Object

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

Constructor Detail

SOAPSupport

private SOAPSupport()

Private constructor.

Method Detail

addSOAP11MustUnderstandAttribute

public static void addSOAP11MustUnderstandAttribute(@Nonnull
                                    org.opensaml.core.xml.XMLObject soapObject,
                                    boolean mustUnderstand)

Adds a soap11:mustUnderstand attribute to the given SOAP object.

Parameters:

soapObject - the SOAP object to add the attribute to

mustUnderstand - whether mustUnderstand is true or false

getSOAP11MustUnderstandAttribute

public static boolean getSOAP11MustUnderstandAttribute(@Nonnull
                                       org.opensaml.core.xml.XMLObject soapObject)

Get the soap11:mustUnderstand attribute from a given SOAP object.

Parameters:

soapObject - the SOAP object to add the attribute to

Returns:

value of the mustUnderstand attribute, or false if not present

addSOAP11ActorAttribute

public static void addSOAP11ActorAttribute(@Nonnull
                           org.opensaml.core.xml.XMLObject soapObject,
                           @Nonnull
                           String actorURI)

Adds a soap11:actor attribute to the given SOAP object.

Parameters:

soapObject - the SOAP object to add the attribute to

actorURI - the URI of the actor

getSOAP11ActorAttribute

@Nullable
public static String getSOAP11ActorAttribute(@Nonnull
                                      org.opensaml.core.xml.XMLObject soapObject)

Gets the soap11:actor attribute from a given SOAP object.

Parameters:

soapObject - the SOAP object to add the attribute to

Returns:

the value of the actor attribute, or null if not present

addSOAP11EncodingStyle

public static void addSOAP11EncodingStyle(@Nonnull
                          org.opensaml.core.xml.XMLObject soapObject,
                          @Nonnull
                          String encodingStyle)

Adds a single encoding style to the given SOAP object. If an existing soap11:encodingStyle attribute is present, the given style will be added to the existing list.

Parameters:

soapObject - the SOAP object to add the attribute to

encodingStyle - the encoding style to add

addSOAP11EncodingStyles

public static void addSOAP11EncodingStyles(@Nonnull
                           org.opensaml.core.xml.XMLObject soapObject,
                           @Nonnull
                           List<String> encodingStyles)

Adds a soap11:encodingStyle attribute to the given SOAP object.

Parameters:

soapObject - the SOAP object to add the attribute to

encodingStyles - the list of encoding styles to add

getSOAP11EncodingStyles

@Nullable
public static List<String> getSOAP11EncodingStyles(@Nonnull
                                            org.opensaml.core.xml.XMLObject soapObject)

Gets the list value of the soap11:encodingStyle attribute from the given SOAP object.

Parameters:

soapObject - the SOAP object to add the attribute to

Returns:

the list of encoding styles, or null if not present

addSOAP12EncodingStyleAttribute

public static void addSOAP12EncodingStyleAttribute(@Nonnull
                                   org.opensaml.core.xml.XMLObject soapObject,
                                   @Nonnull
                                   String style)

Adds the soap12:encodingStyle attribute to the given soap object.

Parameters:

soapObject - object to which the encoding style attribute should be added

style - the encoding style

getSOAP12EncodingStyleAttribute

@Nullable
public static String getSOAP12EncodingStyleAttribute(@Nonnull
                                              org.opensaml.core.xml.XMLObject soapObject)

Gets the soap12:encodingStyle.

Parameters:

soapObject - the SOAP object which may contain the encoding style

Returns:

the encoding style or null if it is not set on the object

addSOAP12MustUnderstandAttribute

public static void addSOAP12MustUnderstandAttribute(@Nonnull
                                    org.opensaml.core.xml.XMLObject soapObject,
                                    boolean mustUnderstand)

Adds a soap12:mustUnderstand attribute to the given SOAP object.

Parameters:

soapObject - the SOAP object to add the attribute to

mustUnderstand - whether mustUnderstand is true or false

getSOAP12MustUnderstandAttribute

public static boolean getSOAP12MustUnderstandAttribute(@Nonnull
                                       org.opensaml.core.xml.XMLObject soapObject)

Get the soap12:mustUnderstand attribute from a given SOAP object.

Parameters:

soapObject - the SOAP object to add the attribute to

Returns:

value of the mustUnderstand attribute, or false if not present

addSOAP12RelayAttribute

public static void addSOAP12RelayAttribute(@Nonnull
                           org.opensaml.core.xml.XMLObject soapObject,
                           boolean relay)

Adds a soap12:relay attribute to the given SOAP object.

Parameters:

soapObject - the SOAP object to add the attribute to

relay - whether relay is true or false

getSOAP12RelayAttribute

public static boolean getSOAP12RelayAttribute(@Nonnull
                              org.opensaml.core.xml.XMLObject soapObject)

Get the soap12:relay attribute from a given SOAP object.

Parameters:

soapObject - the SOAP object to add the attribute to

Returns:

value of the relay attribute, or false if not present

addSOAP12RoleAttribute

public static void addSOAP12RoleAttribute(@Nonnull
                          org.opensaml.core.xml.XMLObject soapObject,
                          @Nonnull
                          String role)

Adds the soap12:role attribute to the given soap object.

Parameters:

soapObject - object to which the rol attribute should be added

role - the role

getSOAP12RoleAttribute

@Nullable
public static String getSOAP12RoleAttribute(@Nonnull
                                     org.opensaml.core.xml.XMLObject soapObject)

Gets the soap12:role.

Parameters:

soapObject - the SOAP object which may contain the role

Returns:

the role or null if it is not set on the object

addHeaderBlock

public static void addHeaderBlock(@Nonnull
                  MessageContext messageContext,
                  @Nonnull
                  org.opensaml.core.xml.XMLObject headerBlock)

Add a header block to the SOAP envelope contained within the specified message context's SOAP subcontext.

Parameters:

messageContext - the message context being processed

headerBlock - the header block to add

addSOAP11HeaderBlock

public static void addSOAP11HeaderBlock(@Nonnull
                        Envelope envelope,
                        @Nonnull
                        org.opensaml.core.xml.XMLObject headerBlock)

Add a header to the SOAP 1.1 Envelope.

Parameters:

envelope - the SOAP 1.1 envelope to process

headerBlock - the header to add

getInboundHeaderBlock

@Nonnull
public static List<org.opensaml.core.xml.XMLObject> getInboundHeaderBlock(@Nonnull
                                                                  MessageContext messageContext,
                                                                  @Nonnull
                                                                  QName headerName,
                                                                  @Nullable
                                                                  Set<String> targetNodes,
                                                                  boolean isFinalDestination)

Get a header block from the SOAP envelope contained within the specified message context's SOAP subcontext.

Parameters:

messageContext - the message context being processed

headerName - the name of the header block to return

targetNodes - the explicitly specified SOAP node actors (1.1) or roles (1.2) for which the header is desired

isFinalDestination - true specifies that headers targeted for message final destination should be returned, false means they should not be returned

Returns:

the list of matching header blocks

getSOAP11HeaderBlock

@Nonnull
public static List<org.opensaml.core.xml.XMLObject> getSOAP11HeaderBlock(@Nonnull
                                                                 Envelope envelope,
                                                                 @Nonnull
                                                                 QName headerName,
                                                                 @Nullable
                                                                 Set<String> targetNodes,
                                                                 boolean isFinalDestination)

Get a header block from the SOAP 1.1 envelope.

Parameters:

envelope - the SOAP 1.1 envelope to process

headerName - the name of the header block to return

targetNodes - the explicitly specified SOAP node actors for which the header is desired

isFinalDestination - true specifies that headers targeted for message final destination should be returned, false specifies they should not be returned

Returns:

the list of matching header blocks

isSOAP11HeaderTargetedToNode

public static boolean isSOAP11HeaderTargetedToNode(@Nonnull
                                   org.opensaml.core.xml.XMLObject header,
                                   @Nullable
                                   Set<String> nodeActors,
                                   boolean isFinalDestination)

Evaluate whether the specified header block is targeted to a SOAP 1.1 node given the specified parameters.

Parameters:

header - the header to evaluate

nodeActors - the explicitly specified node actors for which the header is desired

isFinalDestination - true specifies that headers targeted for message final destination should be returned, false specifies they should not be returned

Returns:

the list of matching header blocks

isSOAPMessage

public static boolean isSOAPMessage(@Nonnull
                    MessageContext<? extends org.opensaml.core.xml.XMLObject> messageContext)

Determine whether the message represented by the message context contains a SOAP Envelope.

Parameters:

messageContext - the current message context

Returns:

true iff the message context contains a SOAP Envelope

buildSOAP11Fault

public static Fault buildSOAP11Fault(@Nonnull
                     QName faultCode,
                     @Nonnull
                     String faultString,
                     @Nullable
                     String faultActor,
                     @Nullable
                     List<org.opensaml.core.xml.XMLObject> detailChildren,
                     @Nullable
                     Map<QName,String> detailAttributes)

Build a SOAP 1.1. Fault element.

Parameters:

faultCode - the 'faultcode' QName (required)

faultString - the 'faultstring' value (required)

faultActor - the 'faultactor' value (may be null)

detailChildren - the 'detail' child elements

detailAttributes - the 'detail' element attributes

Returns:

the new Fault element object