Skip navigation links

oracle.webservices.soap
Interface OracleSOAPElement

All Superinterfaces:

Element, Node, SOAPElement

All Known Subinterfaces:

LazyElement

public interface OracleSOAPElement

extends SOAPElement

Oracle proprietary extension to the standard SAAJ interface SOAPElement. Currently it contains MTOM/XOP related methods.

Field Summary

Fields inherited from interface org.w3c.dom.Node

ATTRIBUTE_NODE, CDATA_SECTION_NODE, COMMENT_NODE, DOCUMENT_FRAGMENT_NODE, DOCUMENT_NODE, DOCUMENT_POSITION_CONTAINED_BY, DOCUMENT_POSITION_CONTAINS, DOCUMENT_POSITION_DISCONNECTED, DOCUMENT_POSITION_FOLLOWING, DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC, DOCUMENT_POSITION_PRECEDING, DOCUMENT_TYPE_NODE, ELEMENT_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, NOTATION_NODE, PROCESSING_INSTRUCTION_NODE, TEXT_NODE

Method Summary

DataHandler	getDataHandler() Gets the DataHandler object for this OracleSOAPElement object.
void	setDataHandler(DataHandler datahandler) Sets the given DataHandler object as the data handler for this OracleSOAPElement object.

Methods inherited from interface javax.xml.soap.SOAPElement

addAttribute, addAttribute, addChildElement, addChildElement, addChildElement, addChildElement, addChildElement, addChildElement, addNamespaceDeclaration, addTextNode, createQName, getAllAttributes, getAllAttributesAsQNames, getAttributeValue, getAttributeValue, getChildElements, getChildElements, getChildElements, getElementName, getElementQName, getEncodingStyle, getNamespacePrefixes, getNamespaceURI, getVisibleNamespacePrefixes, removeAttribute, removeAttribute, removeContents, removeNamespaceDeclaration, setElementQName, setEncodingStyle

Methods inherited from interface javax.xml.soap.Node

detachNode, getParentElement, getValue, recycleNode, setParentElement, setValue

Methods inherited from interface org.w3c.dom.Element

getAttribute, getAttributeNode, getAttributeNodeNS, getAttributeNS, getElementsByTagName, getElementsByTagNameNS, getSchemaTypeInfo, getTagName, hasAttribute, hasAttributeNS, removeAttribute, removeAttributeNode, removeAttributeNS, setAttribute, setAttributeNode, setAttributeNodeNS, setAttributeNS, setIdAttribute, setIdAttributeNode, setIdAttributeNS

Methods inherited from interface org.w3c.dom.Node

appendChild, cloneNode, compareDocumentPosition, getAttributes, getBaseURI, getChildNodes, getFeature, getFirstChild, getLastChild, getLocalName, getNamespaceURI, getNextSibling, getNodeName, getNodeType, getNodeValue, getOwnerDocument, getParentNode, getPrefix, getPreviousSibling, getTextContent, getUserData, hasAttributes, hasChildNodes, insertBefore, isDefaultNamespace, isEqualNode, isSameNode, isSupported, lookupNamespaceURI, lookupPrefix, normalize, removeChild, replaceChild, setNodeValue, setPrefix, setTextContent, setUserData

Method Detail

getDataHandler

DataHandler getDataHandler()
                           throws SOAPException

Gets the DataHandler object for this OracleSOAPElement object. This method assumes the element is of type xsd:base64Binary, either in native base64 string form or MTOM/XOP attachment form. Results of calling of this method on elements of other types are undefined. This method can be called irrespective of whether the associated SOAPMessage is packaged in MTOM/XOP format.

Returns:

The DataHandler object created from the MTOM/XOP attachment associated with this OracleSOAPElement or the only text node of this OracleSOAPElement.

Throws:

SOAPException - Thrown when the above conditions do not apply, e.g. this OracleSOAPElement has child elements.

setDataHandler

void setDataHandler(DataHandler datahandler)

Sets the given DataHandler object as the data handler for this OracleSOAPElement object. When the SOAPMessage containing this element is serialized into MTOM/XOP format, a MIME part will be created out of this DataHandler. When this SOAPMessage is serialized into other formats, the bytes read from this DataHandler will be encoded into a base64 string and set as the only child of this OracleSOAPElement. See oracle.j2ee.ws.saaj.soap.MessageImpl for properties to be set on SOAPMessage to serialize message into various formats. Typically, on an incoming message, the data handler is automatically set. When a message is being created and populated with content, the setDataHandler method can be used to include data from various sources.

Parameters:

datahandler - DataHandler object to be set.

Throws:

IllegalArgumentException - Thrown when the data handler is invalid.

Skip navigation links