org.openehealth.ipf.commons.ihe.ws.utils

Class SoapUtils

java.lang.Object

org.openehealth.ipf.commons.ihe.ws.utils.SoapUtils

public abstract class SoapUtils
extends Object

Generic constants and subroutines for SOAP/XML processing.

Author:

Dmytro Rud

Field Summary

Fields

Modifier and Type	Field and Description
static Set<String>	SOAP_NS_URIS Set of URIs corresponding to supported SOAP versions.
static Set<String>	WS_ADDRESSING_NS_URIS Set of URIs corresponding to supported WS-Addressing specification versions.

Method Summary

Methods

Modifier and Type	Method and Description
static String	extractNonEmptyElement(String document, String elementName) Extracts the given XML element from the given XML document.
static Exception	extractOutgoingException(org.apache.cxf.message.Exchange exchange) Returns Exception object from the outgoing fault message contained in the given CXF exchange, or null, when no exception could be extracted.
static String	extractOutgoingPayload(org.apache.cxf.message.Exchange exchange) Returns String payload of the outgoing message contained in the given CXF exchange, or null, when no String payload could be extracted.
static String	extractSoapBody(String soapEnvelope) Extracts the proper body (for example, a Query) from the SOAP envelope, both represented as Strings.
static Element	getElementNS(Element root, Set<String> nsUris, String wantedLocalName) Searches for the first sub-element of the given XML element, which has the given local name and whose namespace belongs to the given set.

Methods inherited from class java.lang.Object

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

Field Detail

WS_ADDRESSING_NS_URIS

public static final Set<String> WS_ADDRESSING_NS_URIS

Set of URIs corresponding to supported WS-Addressing specification versions.

SOAP_NS_URIS

public static final Set<String> SOAP_NS_URIS

Set of URIs corresponding to supported SOAP versions.

Method Detail

getElementNS

public static Element getElementNS(Element root,
                   Set<String> nsUris,
                   String wantedLocalName)

Searches for the first sub-element of the given XML element, which has the given local name and whose namespace belongs to the given set.

Parameters:

root - an XML element whose children will be iterated, null values are allowed

nsUris - a set of namespace URIs the wanted element can belong to

wantedLocalName - local name of the wanted element

Returns:

corresponding child element or null when none found

extractSoapBody

public static String extractSoapBody(String soapEnvelope)

Extracts the proper body (for example, a Query) from the SOAP envelope, both represented as Strings.

Does really suppose that the given String contains a SOAP envelope and not check it thoroughly.

Parameters:

soapEnvelope - The SOAP Envelope (XML document) as String.

Returns:

Extracted SOAP Body contents as String, or the original parameter when it does not seem to represent a valid SOAP envelope.

extractNonEmptyElement

public static String extractNonEmptyElement(String document,
                            String elementName)

Extracts the given XML element from the given XML document.

Notes:

• Only non-empty elements can be found, the form <prefix:elementName (attr="value")* /> is not supported.
• When multiple elements with the given local name are present, the last one will be returned.

Parameters:

document - XML document as String.

elementName - XML local element name.

Returns:

XML element as String, or null when no element could be extracted.

extractOutgoingException

public static Exception extractOutgoingException(org.apache.cxf.message.Exchange exchange)

Returns Exception object from the outgoing fault message contained in the given CXF exchange, or null, when no exception could be extracted.

extractOutgoingPayload

public static String extractOutgoingPayload(org.apache.cxf.message.Exchange exchange)

Returns String payload of the outgoing message contained in the given CXF exchange, or null, when no String payload could be extracted.