EclipseLink 1.1.1_ 1.1.1.v20090430-r4097 API Reference

org.eclipse.persistence.oxm
Class XMLBinder

java.lang.Object
  extended by org.eclipse.persistence.oxm.XMLBinder

public class XMLBinder
extends java.lang.Object

PUBLIC:

Purpose:Provide a runtime public interface for preserving unmapped content from an XML Document.

Responsibilities:

The XML Binder is a runtime class that allows an association to be maintained between the original XML Document and the Java Objects built from the Document. It allows unmapped content (such as comments, processing instructions or other unmapped elements and attributes) to be preserved. The XMLBinder is created through an XMLContext.

See Also:
XMLContext
Author:
mmacivor

Constructor Summary
XMLBinder(XMLContext context)
           
 
Method Summary
 DocumentPreservationPolicy getDocumentPreservationPolicy()
          Gets this XMLBinder's document preservation policy.
 java.lang.Object getObject(org.w3c.dom.Node node)
          Gets the Java Object associated with the provided XML Node.
 org.w3c.dom.Node getXMLNode(java.lang.Object object)
          Gets the XML Node associated with the provided object.
 java.lang.Object unmarshal(org.w3c.dom.Node node)
          This method will unmarshal the provided node into mapped java objects.
 XMLRoot unmarshal(org.w3c.dom.Node node, java.lang.Class javaClass)
           
 void updateObject(org.w3c.dom.Node node)
          Updates the object associated with the provided node to reflect any changed made to that node.
 void updateXML(java.lang.Object obj)
          This method will update the cached XML node for the provided object.
 void updateXML(java.lang.Object obj, org.w3c.dom.Node associatedNode)
           
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

XMLBinder

public XMLBinder(XMLContext context)
Method Detail

unmarshal

public java.lang.Object unmarshal(org.w3c.dom.Node node)
This method will unmarshal the provided node into mapped java objects. The original node will be cached rather than thrown away.

Parameters:
node -
Returns:
The root object unmarshalled from the provided node.

unmarshal

public XMLRoot unmarshal(org.w3c.dom.Node node,
                         java.lang.Class javaClass)

updateXML

public void updateXML(java.lang.Object obj)
This method will update the cached XML node for the provided object. If no node exists for this object, then no operation is performed.

Parameters:
obj -

updateXML

public void updateXML(java.lang.Object obj,
                      org.w3c.dom.Node associatedNode)

getXMLNode

public org.w3c.dom.Node getXMLNode(java.lang.Object object)
Gets the XML Node associated with the provided object.

Parameters:
object -
Returns:
an XML Node used to construct the given object. Null if no node exists for this object.

getObject

public java.lang.Object getObject(org.w3c.dom.Node node)
Gets the Java Object associated with the provided XML Node.

Parameters:
node -
Returns:
the Java Object associated with this node. If no object is associated then returns null

updateObject

public void updateObject(org.w3c.dom.Node node)
Updates the object associated with the provided node to reflect any changed made to that node. If this Binder has no object associated with the given node, then no operation is performed.

Parameters:
node -

getDocumentPreservationPolicy

public DocumentPreservationPolicy getDocumentPreservationPolicy()
Gets this XMLBinder's document preservation policy.

Returns:
an instance of DocumentPreservationPolicy
See Also:
DocumentPreservationPolicy

EclipseLink 1.1.1_ 1.1.1.v20090430-r4097 API Reference