org.apache.axiom.soap.impl.llom

Class SOAPEnvelopeImpl

java.lang.Object

org.apache.axiom.om.impl.llom.OMSerializableImpl

org.apache.axiom.om.impl.llom.OMNodeImpl

org.apache.axiom.om.impl.llom.OMElementImpl

org.apache.axiom.soap.impl.llom.SOAPElement

org.apache.axiom.soap.impl.llom.SOAPEnvelopeImpl

All Implemented Interfaces:

IChildNode, IContainer, IElement, IParentNode, OMContainerEx, OMElementEx, OMNodeEx, OMConstants, OMContainer, OMElement, OMInformationItem, OMNamedInformationItem, OMNode, OMSerializable, SOAPEnvelope

public class SOAPEnvelopeImpl
extends SOAPElement
implements SOAPEnvelope, OMConstants

Class SOAPEnvelopeImpl

Field Summary

Fields

Modifier and Type	Field and Description
private static org.apache.commons.logging.Log	log

Fields inherited from class org.apache.axiom.om.impl.llom.OMElementImpl

attributes, builder, firstChild, lastChild, localName, namespaces, ns, qName, state

Fields inherited from class org.apache.axiom.om.impl.llom.OMNodeImpl

nextSibling, parent, previousSibling

Fields inherited from class org.apache.axiom.om.impl.llom.OMSerializableImpl

factory

Fields inherited from interface org.apache.axiom.om.OMNode

CDATA_SECTION_NODE, COMMENT_NODE, DTD_NODE, ELEMENT_NODE, ENTITY_REFERENCE_NODE, PI_NODE, SPACE_NODE, TEXT_NODE

Fields inherited from interface org.apache.axiom.om.OMConstants

ARRAY_ITEM_LOCALNAME, ARRAY_ITEM_NS_PREFIX, ARRAY_ITEM_NSURI, ARRAY_ITEM_QNAME, DATA_HANDLER, DEFAULT_CHAR_SET_ENCODING, DEFAULT_DEFAULT_NAMESPACE, DEFAULT_XML_VERSION, IS_BINARY, IS_DATA_HANDLERS_AWARE, PULL_TYPE_BUILDER, PUSH_TYPE_BUILDER, XMLATTRTYPE_CDATA, XMLATTRTYPE_ENTITIES, XMLATTRTYPE_ENTITY, XMLATTRTYPE_ID, XMLATTRTYPE_IDREF, XMLATTRTYPE_IDREFS, XMLATTRTYPE_NMTOKEN, XMLATTRTYPE_NMTOKENS, XMLATTRTYPE_NOTATION, XMLNS_NS_PREFIX, XMLNS_NS_URI, XMLNS_PREFIX, XMLNS_URI

Fields inherited from interface org.apache.axiom.om.impl.common.IParentNode

COMPLETE, DISCARDED, INCOMPLETE

Constructor Summary

Constructors

Constructor and Description
SOAPEnvelopeImpl(OMNamespace ns, SOAPFactory factory) Constructor
SOAPEnvelopeImpl(SOAPMessage message, OMXMLParserWrapper builder, SOAPFactory factory) Constructor

Method Summary

Modifier and Type	Method and Description
void	addChild(OMNode child, boolean fromBuilder) Add a SOAPHeader or SOAPBody object
private void	checkChild(OMNode child) Check that a node is allowed as a child of a SOAP envelope.
protected void	checkParent(OMElement parent) This has to be implemented by all the derived classes to check for the correct parent.
protected OMElement	createClone(OMCloneOptions options, OMContainer targetParent)
SOAPBody	getBody() Returns the SOAPBody object associated with this SOAPEnvelope object.
SOAPHeader	getHeader() Returns the SOAPHeader object for this SOAPEnvelope object.
private javax.xml.namespace.QName	getPayloadQName_Optimized() Use a parser property to fetch the first element in the body.
java.lang.String	getSOAPBodyFirstElementLocalName() Retrieves the local name of the first element in the body.
OMNamespace	getSOAPBodyFirstElementNS() Retrieves the OMNamespace of the first element in the body.
SOAPVersion	getVersion()
boolean	hasFault() Returns true if there is a SOAPFault in the body.
void	internalSerialize(javax.xml.stream.XMLStreamWriter writer2, boolean cache) Serializes the node.
private void	serializeInternally(OMNodeImpl child, MTOMXMLStreamWriter writer)

Methods inherited from class org.apache.axiom.soap.impl.llom.SOAPElement

registerContentHandler, setParent

Methods inherited from class org.apache.axiom.om.impl.llom.OMElementImpl

addAttribute, addAttribute, addChild, addNamespaceDeclaration, build, buildWithAttachments, cloneOMElement, declareDefaultNamespace, declareNamespace, declareNamespace, detach, discard, discarded, findNamespace, findNamespaceURI, getAllAttributes, getAllDeclaredNamespaces, getAttribute, getAttributeValue, getBuilder, getChildElements, getChildren, getChildrenWithLocalName, getChildrenWithName, getChildrenWithNamespaceURI, getDefaultNamespace, getDescendants, getFirstChildWithName, getFirstElement, getFirstOMChild, getFirstOMChildIfAvailable, getLastKnownOMChild, getLineNumber, getLocalName, getNamespace, getNamespaceContext, getNamespacesInScope, getNamespaceURI, getPrefix, getQName, getSAXSource, getState, getText, getTextAsQName, getTextAsStream, getType, getXMLStreamReader, getXMLStreamReader, getXMLStreamReader, getXMLStreamReaderWithoutCaching, isComplete, removeAttribute, removeChildren, resolveQName, setBuilder, setComplete, setFirstChild, setLastChild, setLineNumber, setLocalName, setNamespace, setNamespaceWithNoFindInCurrentScope, setText, setText, toString, toStringWithConsume, undeclarePrefix, writeTextTo

Methods inherited from class org.apache.axiom.om.impl.llom.OMNodeImpl

clone, getIParentNode, getNextOMSibling, getNextOMSiblingIfAvailable, getParent, getPreviousOMSibling, insertSiblingAfter, insertSiblingBefore, internalSerialize, internalSerializeAndConsume, setNextOMSibling, setPreviousOMSibling

Methods inherited from class org.apache.axiom.om.impl.llom.OMSerializableImpl

close, getOMFactory, serialize, serialize, serialize, serialize, serialize, serialize, serializeAndConsume, serializeAndConsume, serializeAndConsume, serializeAndConsume, serializeAndConsume

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.axiom.om.OMElement

addAttribute, addAttribute, cloneOMElement, declareDefaultNamespace, declareNamespace, declareNamespace, findNamespace, findNamespaceURI, getAllAttributes, getAllDeclaredNamespaces, getAttribute, getAttributeValue, getChildElements, getDefaultNamespace, getFirstElement, getLineNumber, getNamespaceContext, getNamespacesInScope, getText, getTextAsQName, getTextAsStream, removeAttribute, resolveQName, serialize, serialize, serialize, serialize, serializeAndConsume, serializeAndConsume, serializeAndConsume, serializeAndConsume, setBuilder, setLineNumber, setNamespace, setNamespaceWithNoFindInCurrentScope, setText, setText, toString, toStringWithConsume, undeclarePrefix, writeTextTo

Methods inherited from interface org.apache.axiom.om.OMNode

buildWithAttachments, detach, discard, getNextOMSibling, getParent, getPreviousOMSibling, getType, insertSiblingAfter, insertSiblingBefore

Methods inherited from interface org.apache.axiom.om.OMContainer

addChild, getBuilder, getChildren, getChildrenWithLocalName, getChildrenWithName, getChildrenWithNamespaceURI, getDescendants, getFirstChildWithName, getFirstOMChild, getSAXSource, getXMLStreamReader, getXMLStreamReader, getXMLStreamReader, getXMLStreamReaderWithoutCaching, removeChildren

Methods inherited from interface org.apache.axiom.om.OMSerializable

build, close, isComplete, serialize, serialize, serializeAndConsume

Methods inherited from interface org.apache.axiom.om.OMInformationItem

clone, getOMFactory

Methods inherited from interface org.apache.axiom.om.OMNamedInformationItem

getLocalName, getNamespace, getNamespaceURI, getPrefix, getQName, setLocalName

Methods inherited from interface org.apache.axiom.om.impl.common.IChildNode

getIParentNode

Methods inherited from interface org.apache.axiom.om.impl.OMNodeEx

getNextOMSiblingIfAvailable, internalSerialize, internalSerializeAndConsume, setNextOMSibling, setPreviousOMSibling

Field Detail

log

private static final org.apache.commons.logging.Log log

Constructor Detail

SOAPEnvelopeImpl

public SOAPEnvelopeImpl(SOAPMessage message,
                        OMXMLParserWrapper builder,
                        SOAPFactory factory)

Constructor

Parameters:

message -

builder - the OMXMLParserWrapper building this envelope

factory - the SOAPFactory building this envelope

SOAPEnvelopeImpl

public SOAPEnvelopeImpl(OMNamespace ns,
                        SOAPFactory factory)

Constructor

Parameters:

ns - OMNamespace for this envelope

factory - SOAPFactory associated with this envelope

Method Detail

getVersion

public SOAPVersion getVersion()

Specified by:

getVersion in interface SOAPEnvelope

getHeader

public SOAPHeader getHeader()
                     throws OMException

Returns the SOAPHeader object for this SOAPEnvelope object.

This SOAPHeader will just be a container for all the headers in the OMMessage

Specified by:

getHeader in interface SOAPEnvelope

Returns:

the SOAPHeader object or null if there is none

Throws:

OMException - if there is a problem obtaining the SOAPHeader object

checkChild

private void checkChild(OMNode child)

Check that a node is allowed as a child of a SOAP envelope.

Parameters:

child -

addChild

public void addChild(OMNode child,
                     boolean fromBuilder)

Add a SOAPHeader or SOAPBody object

Specified by:

addChild in interface OMContainerEx

Overrides:

addChild in class OMElementImpl

Parameters:

child - an OMNode to add - must be either a SOAPHeader or a SOAPBody

getBody

public SOAPBody getBody()
                 throws OMException

Returns the SOAPBody object associated with this SOAPEnvelope object.

This SOAPBody will just be a container for all the BodyElements in the OMMessage

Specified by:

getBody in interface SOAPEnvelope

Returns:

the SOAPBody object for this SOAPEnvelope object or null if there is none

Throws:

OMException - if there is a problem obtaining the SOAPBody object

checkParent

protected void checkParent(OMElement parent)
                    throws SOAPProcessingException

Description copied from class: SOAPElement

This has to be implemented by all the derived classes to check for the correct parent.

Specified by:

checkParent in class SOAPElement

Throws:

SOAPProcessingException

internalSerialize

public void internalSerialize(javax.xml.stream.XMLStreamWriter writer2,
                              boolean cache)
                       throws javax.xml.stream.XMLStreamException

Description copied from class: OMSerializableImpl

Serializes the node.

Specified by:

internalSerialize in interface OMNodeEx

Overrides:

internalSerialize in class OMElementImpl

cache - indicates if caching should be enabled

Throws:

javax.xml.stream.XMLStreamException

serializeInternally

private void serializeInternally(OMNodeImpl child,
                                 MTOMXMLStreamWriter writer)
                          throws javax.xml.stream.XMLStreamException

Throws:

javax.xml.stream.XMLStreamException

hasFault

public boolean hasFault()

Description copied from interface: SOAPEnvelope

Returns true if there is a SOAPFault in the body. The implementation may choose to get this information by building the OM tree or use parser provided information.

Specified by:

hasFault in interface SOAPEnvelope

Returns:

true if SOAPFault in the body

getSOAPBodyFirstElementLocalName

public java.lang.String getSOAPBodyFirstElementLocalName()

Description copied from interface: SOAPEnvelope

Retrieves the local name of the first element in the body. The implementation might build the OMElement or it may obtain this information from the builder/parser without building the OMElement. Use this method in the situations where you need to know the name, but don't necessarily need the OMElement.

Specified by:

getSOAPBodyFirstElementLocalName in interface SOAPEnvelope

Returns:

local name of first element in the body or null

getSOAPBodyFirstElementNS

public OMNamespace getSOAPBodyFirstElementNS()

Description copied from interface: SOAPEnvelope

Retrieves the OMNamespace of the first element in the body. The implementation might build the OMElement or it may obtain this information from the builder/parser without building the OMElement. Use this method in the situations where you need to know the OMNamespace, but don't necessarily need the OMElement.

Specified by:

getSOAPBodyFirstElementNS in interface SOAPEnvelope

Returns:

the namespace of first element in the body, or null if the element has no namespace or the body is empty

getPayloadQName_Optimized

private javax.xml.namespace.QName getPayloadQName_Optimized()

Use a parser property to fetch the first element in the body. Returns null if this optimized property is not set or not available.

Returns:

The qname of the first element in the body or null

createClone

protected OMElement createClone(OMCloneOptions options,
                                OMContainer targetParent)

Overrides:

createClone in class OMElementImpl