|
EclipseLink 1.1.0_ 1.1.0.r3634 API Reference | |||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
java.lang.Objectorg.eclipse.persistence.oxm.mappings.nullpolicy.AbstractNullPolicy
public abstract class AbstractNullPolicy
PUBLIC: Description: This node null policy allows for the handling of
various representations of null in XML documents.
Null policies have 2 concrete implementations:
| Unmarshal Flag | Description |
|---|---|
| isSetPerformedForAbsentNode | This umarshal flag represents whether a set is done for absent nodes only. |
| isNullRepresentedByEmptyNode | If this unmarshal flag is false for empty nodes we set an empty Object for composite mappings, otherwise we set to null. |
| isNullRepresentedByXsiNil | If this unmarshal flag is false for xsi:nil nodes we ignore
the xsi:nil attribute and treat as an empty node. Otherwise we set to null. |
| Marshal Enum | XMLNullRepresentationType Description | XSI_NIL | Nillable: Write out an xsi:nil="true" attribute. |
|---|---|
| ABSENT_NODE(default) | Optional: Write out no node. |
| EMPTY_NODE | Required: Write out an empty |
NullCapableValue| Field Summary | |
|---|---|
protected static java.lang.String |
COLON_W_SCHEMA_NIL_ATTRIBUTE
|
protected static java.lang.String |
EMPTY_STRING
|
protected boolean |
isNullRepresentedByEmptyNode
This state flag determines how we unmarshal empty nodes. true = Perform a set(null) or primitive type equivalent. false = (default) Perform a set(new Object()). |
protected boolean |
isNullRepresentedByXsiNil
This state flag determines how we unmarshal xsi:nil nodes. |
protected boolean |
isSetPerformedForAbsentNode
This state flag determines how we unmarshal absent nodes. true = (default) Perform a set(null). false = Do not perform a set(null). |
protected XMLNullRepresentationType |
marshalNullRepresentation
This enum instance determines what to write out during a marshal operation. |
protected static java.lang.String |
TRUE
|
protected static java.lang.String |
XSI_NIL_ATTRIBUTE
|
| Constructor Summary | |
|---|---|
AbstractNullPolicy()
|
|
| Method Summary | |
|---|---|
boolean |
compositeObjectMarshal(XMLRecord record,
java.lang.Object object,
XMLField field,
org.eclipse.persistence.internal.sessions.AbstractSession session)
INTERNAL: When using the DOM Platform, this method is responsible for marshalling null values for the XML Composite Object Mapping. |
boolean |
compositeObjectMarshal(org.eclipse.persistence.internal.oxm.XPathFragment xPathFragment,
MarshalRecord marshalRecord,
java.lang.Object object,
Session session,
NamespaceResolver namespaceResolver)
INTERNAL: When using the SAX Platform, this method is responsible for marshalling null values for the XML Composite Object Mapping. |
boolean |
directMarshal(org.eclipse.persistence.internal.oxm.XPathFragment xPathFragment,
MarshalRecord marshalRecord,
java.lang.Object object,
Session session,
NamespaceResolver namespaceResolver)
INTERNAL: When using the SAX or DOM Platform, this method is responsible for marshalling null values for the XML Direct Mapping. |
boolean |
getIsSetPerformedForAbsentNode()
|
XMLNullRepresentationType |
getMarshalNullRepresentation()
Get the enum that determines what XML to write when a null value is encountered. |
boolean |
isNullRepresentedByEmptyNode()
|
boolean |
isNullRepresentedByXsiNil()
|
protected java.lang.String |
processNamespaceResolverForXSIPrefix(NamespaceResolver namespaceResolver)
INTERNAL: Private function to process or create an entry in the NamespaceResolver for the xsi prefix. |
void |
setMarshalNullRepresentation(XMLNullRepresentationType anEnumInstance)
Set the enum that determines what XML to write when a null value is encountered. |
void |
setNullRepresentedByEmptyNode(boolean bisNullRepresentedByEmptyNode)
|
void |
setNullRepresentedByXsiNil(boolean bIsNullRepresentedByXsiNil)
|
boolean |
valueIsNull(org.xml.sax.Attributes attributes)
INTERNAL: When using the SAX or DOM Platform during unmarshal operations. |
boolean |
valueIsNull(org.w3c.dom.Element element)
INTERNAL: When using the DOM Platform during unmarshal operations. |
abstract void |
xPathNode(org.eclipse.persistence.internal.oxm.XPathNode xPathNode,
org.eclipse.persistence.internal.oxm.NullCapableValue nullCapableValue)
INTERNAL: When using the SAX Platform this allows a NodeValue to be registered to receive events from the TreeObjectBuilder. |
| Methods inherited from class java.lang.Object |
|---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Field Detail |
|---|
protected static final java.lang.String EMPTY_STRING
protected static final java.lang.String TRUE
protected static final java.lang.String COLON_W_SCHEMA_NIL_ATTRIBUTE
protected static final java.lang.String XSI_NIL_ATTRIBUTE
protected boolean isSetPerformedForAbsentNode
protected boolean isNullRepresentedByEmptyNode
protected boolean isNullRepresentedByXsiNil
protected XMLNullRepresentationType marshalNullRepresentation
| Constructor Detail |
|---|
public AbstractNullPolicy()
| Method Detail |
|---|
public XMLNullRepresentationType getMarshalNullRepresentation()
enumValue - public void setMarshalNullRepresentation(XMLNullRepresentationType anEnumInstance)
enumValue -
public boolean directMarshal(org.eclipse.persistence.internal.oxm.XPathFragment xPathFragment,
MarshalRecord marshalRecord,
java.lang.Object object,
Session session,
NamespaceResolver namespaceResolver)
xPathFragment - marshalRecord - object - session - namespaceResolver -
public boolean compositeObjectMarshal(org.eclipse.persistence.internal.oxm.XPathFragment xPathFragment,
MarshalRecord marshalRecord,
java.lang.Object object,
Session session,
NamespaceResolver namespaceResolver)
xPathFragment - marshalRecord - object - session - namespaceResolver -
public boolean compositeObjectMarshal(XMLRecord record,
java.lang.Object object,
XMLField field,
org.eclipse.persistence.internal.sessions.AbstractSession session)
record - object - field -
public boolean valueIsNull(org.xml.sax.Attributes attributes)
attributes -
public boolean valueIsNull(org.w3c.dom.Element element)
public abstract void xPathNode(org.eclipse.persistence.internal.oxm.XPathNode xPathNode,
org.eclipse.persistence.internal.oxm.NullCapableValue nullCapableValue)
xPathNode - nullCapableValue - public boolean getIsSetPerformedForAbsentNode()
public boolean isNullRepresentedByEmptyNode()
public void setNullRepresentedByEmptyNode(boolean bisNullRepresentedByEmptyNode)
bIsNullRepresentedByEmptyNode - public boolean isNullRepresentedByXsiNil()
public void setNullRepresentedByXsiNil(boolean bIsNullRepresentedByXsiNil)
isNullRepresentedByXsiNil - protected java.lang.String processNamespaceResolverForXSIPrefix(NamespaceResolver namespaceResolver)
namespaceResolver -
|
EclipseLink 1.1.0_ 1.1.0.r3634 API Reference | |||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||