Module org.eclipse.persistence.core

Package org.eclipse.persistence.oxm.record

Class DOMRecord

java.lang.Object

org.eclipse.persistence.internal.core.sessions.CoreAbstractRecord

org.eclipse.persistence.internal.sessions.AbstractRecord

org.eclipse.persistence.oxm.record.XMLRecord

org.eclipse.persistence.oxm.record.DOMRecord

All Implemented Interfaces:

Serializable, Cloneable, Map, AbstractMarshalRecord<AbstractSession,DatabaseField,XMLMarshaller,NamespaceResolver>, AbstractUnmarshalRecord<AbstractSession,DatabaseField,XMLUnmarshaller>, TransformationRecord, XMLRecord<AbstractSession>, DataRecord

Direct Known Subclasses:

EISDOMRecord, XMLTransformationRecord

public class DOMRecord
extends XMLRecord
implements TransformationRecord

PUBLIC: Provides a Record/Map API on an XML DOM element.

See Also:

• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class org.eclipse.persistence.internal.sessions.AbstractRecord

AbstractRecord.EntrySet, AbstractRecord.KeySet, AbstractRecord.NoEntry, AbstractRecord.RecordEntry, AbstractRecord.RecordEntryIterator, AbstractRecord.RecordKeyIterator, AbstractRecord.RecordValuesIterator, AbstractRecord.ValuesSet

Nested classes/interfaces inherited from interface java.util.Map

Map.Entry<K,V>

Nested classes/interfaces inherited from interface org.eclipse.persistence.internal.oxm.record.XMLRecord

XMLRecord.Nil

Field Summary

Fields inherited from class org.eclipse.persistence.oxm.record.XMLRecord

currentObject, equalNamespaceResolvers, hasCustomNamespaceMapper, NIL, session, unmarshaller

Fields inherited from class org.eclipse.persistence.internal.sessions.AbstractRecord

fields, lookupField, noEntry, nullValueInFields, size, sopObject, values

Fields inherited from interface org.eclipse.persistence.internal.oxm.record.XMLRecord

DEFAULT_ATTRIBUTE_GROUP

Constructor Summary

Constructors

Constructor	Description
DOMRecord()	INTERNAL: Default constructor.
DOMRecord(String rootElementName)	INTERNAL: Create a record with the root element name.
DOMRecord(String rootElementName, String rootElementNamespaceURI)	INTERNAL: Create a record with the root element name get the namespace URI from the namespaceResolver.
DOMRecord(String rootElementName, NamespaceResolver namespaceResolver)	INTERNAL: Create a record with the root element name get the namespace URI from the namespaceResolver.
DOMRecord(String localRootElementName, NamespaceResolver namespaceResolver, Node parent)	INTERNAL: Create a record with the local root element name, that is a child of the parent.
DOMRecord(String localRootElementName, Node parent)	INTERNAL: Create a record with the local root element name, that is a child of the parent.
DOMRecord(Document document)	INTERNAL: Create a record with the element.
DOMRecord(Element element)	INTERNAL: Create a record with the element.
DOMRecord(Node node)

Method Summary

Modifier and Type	Method	Description
void	add(DatabaseField key, Object value)	INTERNAL: Add the field-value pair to the document.
XMLRecord	buildNestedRow(Element element)	INTERNAL: Build the nested record, this can be overwriten by subclasses to use their subclass instance.
void	clear()	PUBLIC: Clear the sub-nodes of the DOM.
DOMRecord	clone()	INTERNAL: Clone the row and its values.
boolean	contains(Object value)	PUBLIC: Check if the value is contained in the row.
boolean	containsKey(DatabaseField key)	INTERNAL: Check if the field is contained in the row.
Node	createNewDocument(String defaultRootElementName)	INTERNAL: Creates a new Document and returns the root element of that document
Node	createNewDocument(String defaultRootElementName, String namespaceURI)	INTERNAL: Creates a new Document and returns the root element of that document
Set	entrySet()	PUBLIC:
Object	get(DatabaseField key)	INTERNAL: Retrieve the value for the field.
Document	getDocument()	PUBLIC: Return the document.
Node	getDOM()	PUBLIC: Return the DOM.
Vector	getFields()	INTERNAL: This should not be used, but added some support for it as is called from some places such as sdk call used in the descriptor to define operation not supported, may also be called from toplin in some places.
Object	getIndicatingNoEntry(DatabaseField key)	INTERNAL: Given a DatabaseField return the corresponding value from the document
Object	getIndicatingNoEntry(DatabaseField key, boolean shouldReturnNode)
Object	getIndicatingNoEntry(DatabaseField key, boolean shouldReturnNode, boolean checkForXsiNil)
String	getLocalName()	PUBLIC: Get the local name of the context root element.
String	getNamespaceURI()	PUBLIC: Get the namespace URI for the context root element.
ReferenceResolver	getReferenceResolver()	INTERNAL: The ReferenceResolver that is leveraged by key based mappings.
Vector	getValues()	INTERNAL: This should not be used, but added some support for it as is called from some places such as sdk call used in the descriptor to define operation not supported, may also be called from TopLink in some places.
Object	getValues(String key)	INTERNAL: Retrieve the value for the field name.
Object	getValues(DatabaseField key)	INTERNAL: Given a DatabaseField, return the corresponding values from the document
Object	getValues(DatabaseField key, AbstractNullPolicy nullPolicy)
List<XMLEntry>	getValuesIndicatingNoEntry(List<DatabaseField> keys)
List<XMLEntry>	getValuesIndicatingNoEntry(List<DatabaseField> keys, boolean shouldReturnNodes)
Object	getValuesIndicatingNoEntry(DatabaseField key)
Object	getValuesIndicatingNoEntry(DatabaseField key, boolean shouldReturnNodes)	INTERNAL: Given a DatabaseField, return the corresponding values from the document
Object	getValuesIndicatingNoEntry(DatabaseField key, boolean shouldReturnNodes, AbstractNullPolicy nullPolicy)
Object	getValuesIndicatingNoEntry(DatabaseField key, AbstractNullPolicy nullPolicy)
Set	keySet()	PUBLIC: Return the set of element names from the DOM.
Object	put(Object key, Object value)	PUBLIC: Add the field-value pair to the row.
Object	put(List<XMLField> xmlFields, List<XMLEntry> values)
Object	put(DatabaseField key, Object value)	INTERNAL: Set the field value into the DOM.
Object	remove(DatabaseField key)	INTERNAL: Remove the field key from the row.
void	replaceAt(Object value, int index)	INTERNAL: replaces the value at index with value
String	resolveNamespacePrefix(String prefix)
void	resolveReferences(CoreAbstractSession abstractSession, IDResolver idResolver)	INTERNAL: If the UnmarshalRecord has a ReferenceResolver, tell it to resolve its references.
void	setDOM(Element element)
void	setDOM(Node element)	INTERNAL: Sets the dom and updated document to be the owner document of the given element
protected void	setFields(Vector fields)	INTERNAL: Setting fields vector will not update the document so this is not supported
void	setReferenceResolver(ReferenceResolver referenceResolver)	INTERNAL: Set the ReferenceResolver that will be leveraged by key based mappings.
void	setSession(AbstractSession session)
protected void	setValues(Vector values)	INTERNAL: Setting values vector will not update the document so this is not supported
int	size()	Return the number of elements in the DOM.
String	toString()	INTERNAL: Print the dom XML string.
void	transformFromXML(Reader reader)	Set the XML from an XML reader.
void	transformFromXML(String xml)	Set the XML from an XML string.
void	transformToWriter(Writer writer)	Write the XML string representation of the DOM.
String	transformToXML()	Return the XML string representation of the DOM.
Collection	values()	PUBLIC: Return the collection of element values from the DOM.

Methods inherited from class org.eclipse.persistence.oxm.record.XMLRecord

addExtraNamespacesToNamespaceResolver, addXsiTypeAndClassIndicatorIfRequired, addXsiTypeAndClassIndicatorIfRequired, attribute, attributeWithoutQName, convertToXMLField, convertToXMLField, get, getConversionManager, getCurrentObject, getDocPresPolicy, getIndicatingNoEntry, getLeafElementType, getMarshaller, getNamespaceResolver, getNamespaceSeparator, getOwningObject, getSession, getUnmarshaller, hasCustomNamespaceMapper, hasEqualNamespaceResolvers, isNamespaceAware, isXOPPackage, namespaceDeclaration, put, removeExtraNamespacesFromNamespaceResolver, setCurrentObject, setCustomNamespaceMapper, setDocPresPolicy, setEqualNamespaceResolvers, setLeafElementType, setLeafElementType, setMarshaller, setNamespaceResolver, setOwningObject, setUnmarshaller, setXOPPackage, writeXsiTypeAttribute, writeXsiTypeAttribute

Methods inherited from class org.eclipse.persistence.internal.sessions.AbstractRecord

containsKey, containsKey, containsValue, elements, get, getField, getLookupField, getSopObject, hasNullValueInFields, hasSopObject, isEmpty, keys, mergeFrom, putAll, remove, remove, replaceAt, resetSize, setNullValueInFields, setSopObject

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.Map

compute, computeIfAbsent, computeIfPresent, equals, forEach, getOrDefault, hashCode, merge, putIfAbsent, remove, replace, replace, replaceAll

Constructor Details

DOMRecord

public DOMRecord()

INTERNAL: Default constructor.

DOMRecord

public DOMRecord(String rootElementName)

INTERNAL: Create a record with the root element name.

DOMRecord

public DOMRecord(String rootElementName,
 NamespaceResolver namespaceResolver)

INTERNAL: Create a record with the root element name get the namespace URI from the namespaceResolver.

DOMRecord

public DOMRecord(String rootElementName,
 String rootElementNamespaceURI)

INTERNAL: Create a record with the root element name get the namespace URI from the namespaceResolver.

DOMRecord

public DOMRecord(String localRootElementName,
 Node parent)

INTERNAL: Create a record with the local root element name, that is a child of the parent.

DOMRecord

public DOMRecord(String localRootElementName,
 NamespaceResolver namespaceResolver,
 Node parent)

INTERNAL: Create a record with the local root element name, that is a child of the parent. Lookup the namespace URI from the namespaceResolver.

DOMRecord

public DOMRecord(Element element)

INTERNAL: Create a record with the element.

DOMRecord

public DOMRecord(Node node)

DOMRecord

public DOMRecord(Document document)

INTERNAL: Create a record with the element.

Method Details

getLocalName

public String getLocalName()

PUBLIC: Get the local name of the context root element.

Specified by:

getLocalName in class XMLRecord

getNamespaceURI

public String getNamespaceURI()

PUBLIC: Get the namespace URI for the context root element.

Specified by:

getNamespaceURI in class XMLRecord

getReferenceResolver

public ReferenceResolver getReferenceResolver()

INTERNAL: The ReferenceResolver that is leveraged by key based mappings.

Since:

EclipseLink 2.5.0

setReferenceResolver

public void setReferenceResolver(ReferenceResolver referenceResolver)

INTERNAL: Set the ReferenceResolver that will be leveraged by key based mappings.

Since:

EclipseLink 2.5.0

add

public void add(DatabaseField key,
 Object value)

INTERNAL: Add the field-value pair to the document.

Overrides:

add in class AbstractRecord

clear

public void clear()

PUBLIC: Clear the sub-nodes of the DOM.

Specified by:

clear in interface Map

Specified by:

clear in class XMLRecord

clone

public DOMRecord clone()

INTERNAL: Clone the row and its values.

Overrides:

clone in class AbstractRecord

createNewDocument

public Node createNewDocument(String defaultRootElementName)

INTERNAL: Creates a new Document and returns the root element of that document

createNewDocument

public Node createNewDocument(String defaultRootElementName,
 String namespaceURI)

INTERNAL: Creates a new Document and returns the root element of that document

getDocument

public Document getDocument()

PUBLIC: Return the document.

Specified by:

getDocument in class XMLRecord

containsKey

public boolean containsKey(DatabaseField key)

INTERNAL: Check if the field is contained in the row.

Overrides:

containsKey in class AbstractRecord

contains

public boolean contains(Object value)

PUBLIC: Check if the value is contained in the row.

Overrides:

contains in class XMLRecord

get

public Object get(DatabaseField key)

Description copied from class: XMLRecord

INTERNAL: Retrieve the value for the field. If missing null is returned.

Specified by:

get in interface AbstractUnmarshalRecord<AbstractSession,DatabaseField,XMLUnmarshaller>

Overrides:

get in class XMLRecord

getIndicatingNoEntry

public Object getIndicatingNoEntry(DatabaseField key)

INTERNAL: Given a DatabaseField return the corresponding value from the document

Overrides:

getIndicatingNoEntry in class AbstractRecord

getIndicatingNoEntry

public Object getIndicatingNoEntry(DatabaseField key,
 boolean shouldReturnNode)

getIndicatingNoEntry

public Object getIndicatingNoEntry(DatabaseField key,
 boolean shouldReturnNode,
 boolean checkForXsiNil)

getValues

public Object getValues(String key)

INTERNAL: Retrieve the value for the field name.

Overrides:

getValues in class AbstractRecord

getValues

public Object getValues(DatabaseField key)

INTERNAL: Given a DatabaseField, return the corresponding values from the document

Overrides:

getValues in class AbstractRecord

getValues

public Object getValues(DatabaseField key,
 AbstractNullPolicy nullPolicy)

getValuesIndicatingNoEntry

public Object getValuesIndicatingNoEntry(DatabaseField key)

getValuesIndicatingNoEntry

public Object getValuesIndicatingNoEntry(DatabaseField key,
 AbstractNullPolicy nullPolicy)

getValuesIndicatingNoEntry

public List<XMLEntry> getValuesIndicatingNoEntry(List<DatabaseField> keys)

getValuesIndicatingNoEntry

public List<XMLEntry> getValuesIndicatingNoEntry(List<DatabaseField> keys,
 boolean shouldReturnNodes)

getValuesIndicatingNoEntry

public Object getValuesIndicatingNoEntry(DatabaseField key,
 boolean shouldReturnNodes)

INTERNAL: Given a DatabaseField, return the corresponding values from the document

getValuesIndicatingNoEntry

public Object getValuesIndicatingNoEntry(DatabaseField key,
 boolean shouldReturnNodes,
 AbstractNullPolicy nullPolicy)

buildNestedRow

public XMLRecord buildNestedRow(Element element)

INTERNAL: Build the nested record, this can be overwriten by subclasses to use their subclass instance.

getDOM

public Node getDOM()

PUBLIC: Return the DOM.

Specified by:

getDOM in interface AbstractMarshalRecord<AbstractSession,DatabaseField,XMLMarshaller,NamespaceResolver>

Specified by:

getDOM in class XMLRecord

put

public Object put(DatabaseField key,
 Object value)

INTERNAL: Set the field value into the DOM. The field name must be a valid simple XPath expression.

Specified by:

put in interface AbstractMarshalRecord<AbstractSession,DatabaseField,XMLMarshaller,NamespaceResolver>

Overrides:

put in class AbstractRecord

put

public Object put(List<XMLField> xmlFields,
 List<XMLEntry> values)

put

public Object put(Object key,
 Object value)
           throws ValidationException

Description copied from class: AbstractRecord

PUBLIC: Add the field-value pair to the row.

Specified by:

put in interface Map

Specified by:

put in interface TransformationRecord

Overrides:

put in class AbstractRecord

Throws:

ValidationException

remove

public Object remove(DatabaseField key)

INTERNAL: Remove the field key from the row.

Overrides:

remove in class AbstractRecord

replaceAt

public void replaceAt(Object value,
 int index)

INTERNAL: replaces the value at index with value

Overrides:

replaceAt in class AbstractRecord

entrySet

public Set entrySet()

PUBLIC:

Specified by:

entrySet in interface Map

Overrides:

entrySet in class AbstractRecord

setFields

protected void setFields(Vector fields)
                  throws XMLMarshalException

INTERNAL: Setting fields vector will not update the document so this is not supported

Overrides:

setFields in class AbstractRecord

Throws:

XMLMarshalException

getFields

public Vector getFields()

INTERNAL: This should not be used, but added some support for it as is called from some places such as sdk call used in the descriptor to define operation not supported, may also be called from toplin in some places.

Overrides:

getFields in class AbstractRecord

getValues

public Vector getValues()

INTERNAL: This should not be used, but added some support for it as is called from some places such as sdk call used in the descriptor to define operation not supported, may also be called from TopLink in some places.

Overrides:

getValues in class AbstractRecord

setValues

protected void setValues(Vector values)
                  throws XMLMarshalException

INTERNAL: Setting values vector will not update the document so this is not supported

Overrides:

setValues in class AbstractRecord

Throws:

XMLMarshalException

setDOM

public void setDOM(Node element)

INTERNAL: Sets the dom and updated document to be the owner document of the given element

setDOM

public void setDOM(Element element)

toString

public String toString()

INTERNAL: Print the dom XML string.

Overrides:

toString in class AbstractRecord

keySet

public Set keySet()

PUBLIC: Return the set of element names from the DOM.

Specified by:

keySet in interface Map

Overrides:

keySet in class AbstractRecord

values

public Collection values()

PUBLIC: Return the collection of element values from the DOM.

Specified by:

values in interface Map

Overrides:

values in class AbstractRecord

size

public int size()

Return the number of elements in the DOM.

Specified by:

size in interface Map

Overrides:

size in class AbstractRecord

transformFromXML

public void transformFromXML(String xml)

Set the XML from an XML string.

setSession

public void setSession(AbstractSession session)

Specified by:

setSession in interface AbstractMarshalRecord<AbstractSession,DatabaseField,XMLMarshaller,NamespaceResolver>

Overrides:

setSession in class XMLRecord

transformFromXML

public void transformFromXML(Reader reader)

Set the XML from an XML reader.

transformToXML

public String transformToXML()

Return the XML string representation of the DOM.

Specified by:

transformToXML in class XMLRecord

transformToWriter

public void transformToWriter(Writer writer)

Write the XML string representation of the DOM.

resolveNamespacePrefix

public String resolveNamespacePrefix(String prefix)

Specified by:

resolveNamespacePrefix in interface AbstractMarshalRecord<AbstractSession,DatabaseField,XMLMarshaller,NamespaceResolver>

Specified by:

resolveNamespacePrefix in interface AbstractUnmarshalRecord<AbstractSession,DatabaseField,XMLUnmarshaller>

Overrides:

resolveNamespacePrefix in class XMLRecord

resolveReferences

public void resolveReferences(CoreAbstractSession abstractSession,
 IDResolver idResolver)

INTERNAL: If the UnmarshalRecord has a ReferenceResolver, tell it to resolve its references.

Since:

EclipseLink 2.5.0