com.evolveum.midpoint.prism.xnode

Class PrimitiveXNode<T>

java.lang.Object

com.evolveum.midpoint.prism.xnode.XNode

com.evolveum.midpoint.prism.xnode.PrimitiveXNode<T>

All Implemented Interfaces:

Visitable, DebugDumpable, Serializable, Cloneable

public class PrimitiveXNode<T>
extends XNode
implements Serializable

See Also:

Serialized Form

Field Summary

Fields inherited from class com.evolveum.midpoint.prism.xnode.XNode

KEY_CONTAINER_ID, KEY_OID, KEY_REFERENCE_DESCRIPTION, KEY_REFERENCE_FILTER, KEY_REFERENCE_OBJECT, KEY_REFERENCE_OID, KEY_REFERENCE_RELATION, KEY_REFERENCE_RESOLUTION_TIME, KEY_REFERENCE_TARGET_NAME, KEY_REFERENCE_TYPE, KEY_VERSION

Fields inherited from interface com.evolveum.midpoint.util.DebugDumpable

INDENT_STRING

Constructor Summary

Constructors

Constructor and Description
PrimitiveXNode()
PrimitiveXNode(T value)

Method Summary

Methods

Modifier and Type	Method and Description
void	accept(Visitor visitor)
String	debugDump(int indent)
boolean	equals(Object obj)
String	getDesc()
String	getFormattedValue() Returns a value that is correctly string-formatted according to its type definition.
String	getGuessedFormattedValue() Returns formatted parsed value without actually changing node state from UNPARSED to PARSED (if node is originally unparsed).
T	getParsedValue(QName typeName)
T	getParsedValue(QName typeName, XNodeProcessorEvaluationMode mode)
T	getParsedValueWithoutRecording(QName typeName) Returns parsed value without actually changing node state from UNPARSED to PARSED (if node is originally unparsed).
Map<String,String>	getRelevantNamespaceDeclarations() This method is used with conjunction with getStringValue, typically when serializing unparsed values.
String	getStringValue() Returns the value represented as string - in the best format that we can.
T	getValue()
ValueParser<T>	getValueParser()
int	hashCode() The basic idea of equals() is: - if parsed, compare the value; - if unparsed, compare getStringValue() Therefore the hashcode is generated based on value (if parsed) or getStringValue() (if unparsed).
boolean	isAttribute()
boolean	isEmpty()
boolean	isParsed()
void	parseValue(QName typeName, XNodeProcessorEvaluationMode mode)
void	setAttribute(boolean isAttribute)
void	setValue(T value, QName typeQName)
void	setValueParser(ValueParser<T> valueParser)
String	toString()

Methods inherited from class com.evolveum.midpoint.prism.xnode.XNode

clone, cloneTransformKeys, copyCommonAttributesFrom, debugDump, dumpSuffix, getComment, getLineNumber, getMaxOccurs, getOriginDescription, getOriginFile, getParent, getTypeQName, isExplicitTypeDeclaration, setComment, setExplicitTypeDeclaration, setLineNumber, setMaxOccurs, setOriginDescription, setOriginFile, setParent, setTypeQName

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

PrimitiveXNode

public PrimitiveXNode()

PrimitiveXNode

public PrimitiveXNode(T value)

Method Detail

parseValue

public void parseValue(QName typeName,
              XNodeProcessorEvaluationMode mode)
                throws SchemaException

Throws:

SchemaException

getValue

public T getValue()

getParsedValue

public T getParsedValue(QName typeName)
                 throws SchemaException

Throws:

SchemaException

getParsedValue

public T getParsedValue(QName typeName,
               XNodeProcessorEvaluationMode mode)
                 throws SchemaException

Throws:

SchemaException

getValueParser

public ValueParser<T> getValueParser()

setValueParser

public void setValueParser(ValueParser<T> valueParser)

setValue

public void setValue(T value,
            QName typeQName)

isParsed

public boolean isParsed()

isAttribute

public boolean isAttribute()

setAttribute

public void setAttribute(boolean isAttribute)

isEmpty

public boolean isEmpty()

Specified by:

isEmpty in class XNode

getParsedValueWithoutRecording

public T getParsedValueWithoutRecording(QName typeName)
                                 throws SchemaException

Returns parsed value without actually changing node state from UNPARSED to PARSED (if node is originally unparsed). Useful when we are not sure about the type name and do not want to record parsed value based on wrong type name.

Throws:

SchemaException

getFormattedValue

public String getFormattedValue()

Returns a value that is correctly string-formatted according to its type definition. Works properly only if definition is set.

getGuessedFormattedValue

public String getGuessedFormattedValue()
                                throws SchemaException

Returns formatted parsed value without actually changing node state from UNPARSED to PARSED (if node is originally unparsed). Useful e.g. to serialize nodes that have a type declaration but were not parsed yet. Experimental. Should be thought through yet.

Returns:

properly formatted value

Throws:

SchemaException

accept

public void accept(Visitor visitor)

Specified by:

accept in interface Visitable

Specified by:

accept in class XNode

debugDump

public String debugDump(int indent)

Specified by:

debugDump in interface DebugDumpable

getDesc

public String getDesc()

Specified by:

getDesc in class XNode

toString

public String toString()

Overrides:

toString in class Object

getStringValue

public String getStringValue()

Returns the value represented as string - in the best format that we can. There is no guarantee that the returned value will be precise. This method is used as a "last instance" if everything else fails. Invocation of this method will not change the state of this xnode, e.g. it will NOT cause it to be parsed.

getRelevantNamespaceDeclarations

public Map<String,String> getRelevantNamespaceDeclarations()

This method is used with conjunction with getStringValue, typically when serializing unparsed values. Because the string value can represent QName or ItemPath, we have to provide relevant namespace declarations. Because we cannot know for sure, we are allowed to return namespace declarations that are not actually used. We should minimize number of such declarations, however. Current implementation simply grabs all potential namespace declarations and searches the xnode's string value for any 'prefix:' substrings. I'm afraid it is all we can do for now. THIS METHOD SHOULD BE CALLED ONLY ON EITHER UNPARSED OR EMPTY NODES.

Returns:

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

hashCode

public int hashCode()

The basic idea of equals() is: - if parsed, compare the value; - if unparsed, compare getStringValue() Therefore the hashcode is generated based on value (if parsed) or getStringValue() (if unparsed).

Overrides:

hashCode in class Object