A Provider
implementation can accept and return objects that are derived
from the javax.xml.transform.Source
interface. Source
objects
are low level objects that hold XML documents. Each Source
implementation
provides methods that access the stored XML documents and manipulate its contents. The
following objects implement the Source
interface:
-
DOMSource
holds XML messages as a Document Object Model(DOM) tree. The XML message is stored as a set ofNode
objects that can be accessed using thegetNode()
method. Nodes can be updated or added to the DOM tree using thesetNode()
method. -
SAXSource
holds XML messages as a Simple API for XML (SAX) object. SAX objects contain anInputSource
object that contains the raw data and anXMLReader
object that parses the raw data. -
StreamSource
holds XML messages as a data stream. The data stream can be manipulated as would any other data stream.Note: When usingSource
objects the developer is responsible for ensuring that all required binding specific wrappers are added to the message. For example, when interacting with a service expecting SOAP messages, the developer must ensure that the required SOAP envelope is added to the outgoing request and that the SOAP envelope's contents are correct.