com.evolveum.midpoint.prism

Class PrismReferenceValue

java.lang.Object

com.evolveum.midpoint.prism.PrismValue

com.evolveum.midpoint.prism.PrismReferenceValue

All Implemented Interfaces:

IPrismValue, PathVisitable, Revivable, Visitable, DebugDumpable, Serializable

public class PrismReferenceValue
extends PrismValue
implements DebugDumpable, Serializable

Author:

Radovan Semancik

See Also:

Serialized Form

Field Summary

Fields inherited from class com.evolveum.midpoint.prism.PrismValue

immutable, prismContext

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

INDENT_STRING

Constructor Summary

Constructors

Constructor and Description
PrismReferenceValue()
PrismReferenceValue(String oid)
PrismReferenceValue(String oid, OriginType type, Objectable source)
PrismReferenceValue(String oid, QName targetType)

Method Summary

Modifier and Type	Method and Description
void	applyDefinition(ItemDefinition definition, boolean force)
void	applyDefinition(PrismReferenceDefinition definition, boolean force)
Referencable	asReferencable()
void	checkConsistenceInternal(Itemable rootItem, boolean requireDefinitions, boolean prohibitRaw, ConsistencyCheckScope scope)
PrismReferenceValue	clone()
protected void	copyValues(PrismReferenceValue clone)
static PrismReferenceValue	createFromTarget(PrismObject<?> refTarget)
String	debugDump() Show the content of the object intended for diagnostics by system administrator.
String	debugDump(int indent)
String	debugDump(int indent, boolean expandObject)
boolean	equals(Object obj)
boolean	equalsComplex(PrismReferenceValue other, boolean ignoreMetadata, boolean isLiteral)
boolean	equalsComplex(PrismValue other, boolean ignoreMetadata, boolean isLiteral)
Object	find(ItemPath path)
<IV extends PrismValue,ID extends ItemDefinition> PartiallyResolvedItem<IV,ID>	findPartial(ItemPath path)
PrismReferenceDefinition	getDefinition()
String	getDescription()
SearchFilterType	getFilter()
PrismObject	getObject()
String	getOid() OID of the object that this reference refers to (reference target).
Class<?>	getRealClass()
Referencable	getRealValue()
QName	getRelation()
EvaluationTimeType	getResolutionTime()
PolyString	getTargetName() Returns cached name of the target object.
QName	getTargetType() Returns XSD type of the object that this reference refers to.
Class<Objectable>	getTargetTypeCompileTimeClass()
int	hashCode()
boolean	isEmpty()
boolean	isRaw() Returns true if the value is raw.
boolean	match(PrismValue otherValue)
void	recompute(PrismContext prismContext)
boolean	representsSameValue(PrismReferenceValue other)
boolean	representsSameValue(PrismValue other, boolean lax) Returns true if this and other value represent the same value.
void	setDescription(String description)
void	setFilter(SearchFilterType filter)
void	setObject(PrismObject object)
void	setOid(String oid)
void	setRelation(QName relation)
void	setResolutionTime(EvaluationTimeType resolutionTime)
void	setTargetName(PolyString name)
void	setTargetName(PolyStringType name)
void	setTargetType(QName targetType)
void	setTargetType(QName targetType, boolean allowEmptyNamespace)
PrismReferenceValue	toCannonical() Returns a version of this value that is cannonical, that means it has the minimal form.
String	toHumanReadableString() Returns a short (one-line) representation of the real value stored in this object.
String	toString()

Methods inherited from class com.evolveum.midpoint.prism.PrismValue

accept, accept, appendOriginDump, applyDefinition, checkMutability, clearParent, clearParent, cloneCollection, cloneValues, collectionContainsEquivalentValue, contains, containsAll, containsRealValue, copyValues, diff, diff, equals, equals, equalsRealValue, equalsRealValue, equalsRealValues, getOriginObject, getOriginType, getParent, getPath, getPrismContext, getRealValuesOfCollection, getUserData, getUserData, isImmutable, normalize, recompute, resetParentCollection, revive, setImmutable, setOriginObject, setOriginType, setParent, setPrismContext, setUserData

Methods inherited from class java.lang.Object

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

Constructor Detail

PrismReferenceValue

public PrismReferenceValue()

PrismReferenceValue

public PrismReferenceValue(String oid)

PrismReferenceValue

public PrismReferenceValue(String oid,
                           QName targetType)

PrismReferenceValue

public PrismReferenceValue(String oid,
                           OriginType type,
                           Objectable source)

Method Detail

getOid

public String getOid()

OID of the object that this reference refers to (reference target). May return null, but the reference is in that case incomplete and unusable.

Returns:

the target oid

setOid

public void setOid(String oid)

getObject

public PrismObject getObject()

setObject

public void setObject(PrismObject object)

getTargetType

public QName getTargetType()

Returns XSD type of the object that this reference refers to. It may be used in XPath expressions and similar filters. May return null if the type name is not set.

Returns:

the target type name

setTargetType

public void setTargetType(QName targetType)

setTargetType

public void setTargetType(QName targetType,
                          boolean allowEmptyNamespace)

Parameters:

targetType -

allowEmptyNamespace - This is an ugly hack. See comment in DOMUtil.validateNonEmptyQName.

getTargetName

public PolyString getTargetName()

Returns cached name of the target object. This is a ephemeral value. It is usually not stored. It may be computed at object retrieval time or it may not be present at all. This is NOT an authoritative information. Setting it or changing it will not influence the reference meaning. OID is the only authoritative linking mechanism.

Returns:

cached name of the target object.

setTargetName

public void setTargetName(PolyString name)

setTargetName

public void setTargetName(PolyStringType name)

getTargetTypeCompileTimeClass

public Class<Objectable> getTargetTypeCompileTimeClass()

getRelation

public QName getRelation()

setRelation

public void setRelation(QName relation)

getDescription

public String getDescription()

setDescription

public void setDescription(String description)

getFilter

public SearchFilterType getFilter()

setFilter

public void setFilter(SearchFilterType filter)

getResolutionTime

public EvaluationTimeType getResolutionTime()

setResolutionTime

public void setResolutionTime(EvaluationTimeType resolutionTime)

getDefinition

public PrismReferenceDefinition getDefinition()

Overrides:

getDefinition in class PrismValue

isRaw

public boolean isRaw()

Description copied from interface: IPrismValue

Returns true if the value is raw. Raw value is a semi-parsed value. A value for which we don't have a full definition yet and therefore the parsing could not be finished until the definition is supplied.

Specified by:

isRaw in interface IPrismValue

find

public Object find(ItemPath path)

Specified by:

find in interface IPrismValue

findPartial

public <IV extends PrismValue,ID extends ItemDefinition> PartiallyResolvedItem<IV,ID> findPartial(ItemPath path)

Specified by:

findPartial in interface IPrismValue

applyDefinition

public void applyDefinition(ItemDefinition definition,
                            boolean force)
                     throws SchemaException

Specified by:

applyDefinition in interface IPrismValue

Overrides:

applyDefinition in class PrismValue

Throws:

SchemaException

applyDefinition

public void applyDefinition(PrismReferenceDefinition definition,
                            boolean force)
                     throws SchemaException

Throws:

SchemaException

recompute

public void recompute(PrismContext prismContext)

Specified by:

recompute in interface IPrismValue

checkConsistenceInternal

public void checkConsistenceInternal(Itemable rootItem,
                                     boolean requireDefinitions,
                                     boolean prohibitRaw,
                                     ConsistencyCheckScope scope)

Specified by:

checkConsistenceInternal in class PrismValue

isEmpty

public boolean isEmpty()

Specified by:

isEmpty in interface IPrismValue

toCannonical

public PrismReferenceValue toCannonical()

Returns a version of this value that is cannonical, that means it has the minimal form. E.g. it will have only OID and no object.

equalsComplex

public boolean equalsComplex(PrismValue other,
                             boolean ignoreMetadata,
                             boolean isLiteral)

Overrides:

equalsComplex in class PrismValue

equalsComplex

public boolean equalsComplex(PrismReferenceValue other,
                             boolean ignoreMetadata,
                             boolean isLiteral)

equals

public boolean equals(Object obj)

Overrides:

equals in class PrismValue

hashCode

public int hashCode()

Overrides:

hashCode in class PrismValue

representsSameValue

public boolean representsSameValue(PrismValue other,
                                   boolean lax)

Description copied from class: PrismValue

Returns true if this and other value represent the same value. E.g. if they have the same IDs, OIDs or it is otherwise know that they "belong together" without a deep examination of the values.

Overrides:

representsSameValue in class PrismValue

lax - If we can reasonably assume that the two values belong together even if they don't have the same ID, e.g. if they both belong to single-valued parent items. This is useful e.g. when comparing multi-valued containers. But can cause problems when we want to be sure we are removing the correct value.

representsSameValue

public boolean representsSameValue(PrismReferenceValue other)

createFromTarget

public static PrismReferenceValue createFromTarget(PrismObject<?> refTarget)

toString

public String toString()

Overrides:

toString in class Object

asReferencable

public Referencable asReferencable()

debugDump

public String debugDump()

Description copied from interface: DebugDumpable

Show the content of the object intended for diagnostics by system administrator. The out put should be suitable to use in system logs at "debug" level. It may be multi-line, but in that case it should be well indented and quite terse. As it is intended to be used by system administrator, it should not use any developer terms such as class names, exceptions or stack traces.

Specified by:

debugDump in interface DebugDumpable

Returns:

content of the object intended for diagnostics by system administrator.

debugDump

public String debugDump(int indent)

Specified by:

debugDump in interface DebugDumpable

debugDump

public String debugDump(int indent,
                        boolean expandObject)

clone

public PrismReferenceValue clone()

Specified by:

clone in class PrismValue

copyValues

protected void copyValues(PrismReferenceValue clone)

match

public boolean match(PrismValue otherValue)

Specified by:

match in interface IPrismValue

toHumanReadableString

public String toHumanReadableString()

Description copied from interface: IPrismValue

Returns a short (one-line) representation of the real value stored in this object. The value is returned without any decorations or type demarcations (such as PPV, PRV, etc.)

Specified by:

toHumanReadableString in interface IPrismValue

getRealClass

public Class<?> getRealClass()

Specified by:

getRealClass in class PrismValue

getRealValue

@Nullable
public Referencable getRealValue()

Specified by:

getRealValue in class PrismValue