Class LensElementContext<O extends ObjectType>
- java.lang.Object
-
- com.evolveum.midpoint.model.impl.lens.LensElementContext<O>
-
- All Implemented Interfaces:
ModelElementContext<O>
,DebugDumpable
,Serializable
,Cloneable
- Direct Known Subclasses:
LensFocusContext
,LensProjectionContext
public abstract class LensElementContext<O extends ObjectType> extends Object implements ModelElementContext<O>, Cloneable
Lens context for a computation element - a focus or a projection.- Author:
- semancik
- See Also:
- Serialized Form
-
-
Field Summary
Fields Modifier and Type Field Description protected @NotNull LensContext<? extends ObjectType>
lensContext
Link to the parent context.protected @NotNull ElementState<O>
state
State of the element, i.e.-
Fields inherited from interface com.evolveum.midpoint.util.DebugDumpable
INDENT_STRING
-
-
Constructor Summary
Constructors Constructor Description LensElementContext(@NotNull ElementState<O> elementState, @NotNull LensContext<? extends ObjectType> lensContext)
LensElementContext(@NotNull Class<O> objectTypeClass, @NotNull LensContext<? extends ObjectType> lensContext)
-
Method Summary
All Methods Instance Methods Abstract Methods Concrete Methods Modifier and Type Method Description void
addObjectPolicyRule(EvaluatedPolicyRuleImpl policyRule)
void
addToExecutedDeltas(LensObjectDeltaOperation<O> executedDelta)
void
addToPendingAssignmentPolicyStateModifications(@NotNull AssignmentType assignment, @NotNull PlusMinusZero mode, @NotNull ItemDelta<?,?> modification)
void
addToPendingObjectPolicyStateModifications(ItemDelta<?,?> modification)
void
addToPrimaryDelta(ObjectDelta<O> delta)
Adds (merges) a delta into primary delta.void
adopt(PrismContext prismContext)
void
checkConsistence()
abstract void
checkConsistence(String contextDesc)
void
checkEncrypted()
abstract void
cleanup()
Cleans up the contexts by removing some of the working state.void
clearCurrentObject()
Clears the current state, e.g.void
clearObjectPolicyRules()
void
clearPendingPolicyStateModifications()
void
deleteNonTransientComputationResults()
Removes results of any previous computations from the context.void
forEachDelta(Consumer<ObjectDelta<O>> consumer)
void
forEachObject(Consumer<PrismObject<O>> consumer)
@NotNull ObjectDeltaWaves<O>
getArchivedSecondaryDeltas()
CredentialsPolicyType
getCredentialsPolicy()
ObjectDelta<O>
getCurrentDelta()
Returns object delta valid for the current clockwork click.protected String
getDebugDumpTitle()
protected String
getDebugDumpTitle(String suffix)
protected abstract String
getElementDefaultDesc()
protected String
getElementDesc()
@NotNull List<LensObjectDeltaOperation<O>>
getExecutedDeltas()
abstract String
getHumanReadableName()
int
getIteration()
String
getIterationToken()
@NotNull LensContext<? extends ObjectType>
getLensContext()
@Nullable PrismObject<O>
getObjectAny()
PrismObject<O>
getObjectCurrent()
"Current" state of the object i.e.@Nullable PrismObject<O>
getObjectCurrentOrNew()
PrismObjectDefinition<O>
getObjectDefinition()
PrismObject<O>
getObjectNew()
Expected state of the object after application of currentDelta i.e.@NotNull PrismObject<O>
getObjectNewOrCurrentRequired()
PrismObject<O>
getObjectOld()
"Old" state of the object i.e.@NotNull Collection<EvaluatedPolicyRuleImpl>
getObjectPolicyRules()
Returns all policy rules that apply to this object - even those that were not triggered.String
getObjectReadVersion()
@NotNull Class<O>
getObjectTypeClass()
String
getOid()
@NotNull SimpleOperationName
getOperation()
Returns a characterization of current operation (add, delete, modify).@NotNull Map<AssignmentSpec,List<ItemDelta<?,?>>>
getPendingAssignmentPolicyStateModifications()
@NotNull List<ItemDelta<?,?>>
getPendingObjectPolicyStateModifications()
Integer
getPolicyRuleCounter(String policyRuleIdentifier)
ObjectDelta<O>
getPrimaryDelta()
ObjectDelta<O>
getSecondaryDelta()
Returns secondary delta for the current clockwork click.SecurityPolicyType
getSecurityPolicy()
Returns security policy applicable to the object.ObjectDelta<O>
getSummaryDelta()
Returns object delta comprising both primary delta and (all) secondary deltas, merged together.void
initializeElementState(String oid, PrismObject<O> objectOld, PrismObject<O> objectCurrent, ObjectDelta<O> primaryDelta)
Initializes the state of the element: sets old/current state and primary delta, clears the secondary delta.abstract boolean
isAdd()
Be cautious when using this method forLensProjectionContext
.abstract boolean
isDelete()
See also limitations forisAdd()
.boolean
isFresh()
boolean
isModify()
TODO description See also limitations forisAdd()
.boolean
isOfType(Class<?> aClass)
void
modifyPrimaryDelta(DeltaModifier<O> modifier)
Modifies the primary delta.void
normalize()
boolean
operationMatches(ChangeTypeType operation)
void
recompute()
There is no longer explicit "recompute" action.RememberedElementState<O>
rememberElementState()
void
replaceOldAndCurrentObject(String oid, PrismObject<O> objectOld, PrismObject<O> objectCurrent)
Replaces OID, old, and current object state.boolean
represents(Class<?> type)
void
restoreElementState(@NotNull RememberedElementState<O> rememberedState)
void
rot()
void
setAnyDeltasExecutedFlag()
void
setCurrentObject(@Nullable PrismObject<O> objectCurrent)
Updates the current object.void
setCurrentObjectAndOid(@NotNull PrismObject<O> object)
Used to update current object and also the OID.void
setEstimatedOldValuesInPrimaryDelta()
void
setFresh(boolean fresh)
void
setInitialObject(@NotNull PrismObject<O> object)
Sets the value of an object that should be present on the clockwork start: both objectCurrent and objectOld.void
setInitialObject(@NotNull PrismObject<O> object, @Nullable ObjectDelta<O> objectDelta)
Sets the value of an object that should be present on the clockwork start: both objectCurrent, and (if delta is not "add") also objectOld.void
setIteration(int iteration)
void
setIterationToken(String iterationToken)
abstract void
setLoadedObject(@NotNull PrismObject<O> object)
Sets current and possibly also old object.void
setOid(String oid)
Sets OID of the new object but also to the deltas (if applicable).void
setPolicyRuleCounter(String policyRuleIdentifier, int value)
void
setPrimaryDelta(ObjectDelta<O> primaryDelta)
Assumes clockwork was not started.void
setPrimaryDeltaAfterStart(ObjectDelta<O> primaryDelta)
Sets the primary delta.void
setSecurityPolicy(SecurityPolicyType securityPolicy)
void
swallowToPrimaryDelta(ItemDelta<?,?> itemDelta)
Adds an item delta to primary delta.void
swallowToSecondaryDelta(ItemDelta<?,?> itemDelta)
void
swallowToSecondaryDelta(Collection<? extends ItemDelta<?,?>> itemDeltas)
void
swallowToSecondaryDeltaUnchecked(ItemDelta<?,?> itemDelta)
void
triggerRule(@NotNull EvaluatedPolicyRule rule, Collection<EvaluatedPolicyRuleTrigger<?>> triggers)
boolean
wasAddExecuted()
-
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
-
Methods inherited from interface com.evolveum.midpoint.util.DebugDumpable
debugDump, debugDump, debugDumpLazily, debugDumpLazily
-
Methods inherited from interface com.evolveum.midpoint.model.api.context.ModelElementContext
getArchetype, getArchetypes, getSummarySecondaryDelta
-
-
-
-
Field Detail
-
state
@NotNull protected final @NotNull ElementState<O extends ObjectType> state
State of the element, i.e. object old, current, new, along with the respective deltas (primary, secondary, current, summary).
-
lensContext
@NotNull protected final @NotNull LensContext<? extends ObjectType> lensContext
Link to the parent context.
-
-
Constructor Detail
-
LensElementContext
public LensElementContext(@NotNull @NotNull Class<O> objectTypeClass, @NotNull @NotNull LensContext<? extends ObjectType> lensContext)
-
LensElementContext
public LensElementContext(@NotNull @NotNull ElementState<O> elementState, @NotNull @NotNull LensContext<? extends ObjectType> lensContext)
-
-
Method Detail
-
getLensContext
@NotNull public @NotNull LensContext<? extends ObjectType> getLensContext()
-
getObjectTypeClass
@NotNull public @NotNull Class<O> getObjectTypeClass()
- Specified by:
getObjectTypeClass
in interfaceModelElementContext<O extends ObjectType>
- Returns:
- Type of object represented by this context. It is declared when context is created, so the actual type of the object can be its subtype. (Although this is quite unusual.)
-
getObjectDefinition
public PrismObjectDefinition<O> getObjectDefinition()
-
represents
public boolean represents(Class<?> type)
-
isOfType
public boolean isOfType(Class<?> aClass)
- Specified by:
isOfType
in interfaceModelElementContext<O extends ObjectType>
- Returns:
- True if the declared or actual object type is a subtype of aClass.
-
getIteration
public int getIteration()
-
setIteration
public void setIteration(int iteration)
-
getIterationToken
public String getIterationToken()
-
setIterationToken
public void setIterationToken(String iterationToken)
-
getOid
public String getOid()
- Specified by:
getOid
in interfaceModelElementContext<O extends ObjectType>
- Returns:
- OID of the object. If not determined yet, it is obtained from available sources, like object old, current, new, or primary delta.
-
getObjectOld
public PrismObject<O> getObjectOld()
Description copied from interface:ModelElementContext
"Old" state of the object i.e. the one that was present when the clockwork started. It can be present on the beginning or filled-in during projector execution by the context loaded. This value is used as an "old state" for resource object mappings (in constructions or resources), persona mappings, notifications, policy rules, and so on.- Specified by:
getObjectOld
in interfaceModelElementContext<O extends ObjectType>
-
getObjectCurrent
public PrismObject<O> getObjectCurrent()
Description copied from interface:ModelElementContext
"Current" state of the object i.e. the one that was present when the current clockwork click started. It is typically filled-in by the context loader. For projections, it is usually the same as the "old" state, as they are not updated iteratively but only once per clockwork run. This value used as an "old state" for focus mappings (in object template or assigned ones). INVARIANT: For LensProjectionContext the `shadowLifecycleState` must be present on this object (if the object is not null).- Specified by:
getObjectCurrent
in interfaceModelElementContext<O extends ObjectType>
-
getObjectNew
public PrismObject<O> getObjectNew()
Description copied from interface:ModelElementContext
Expected state of the object after application of currentDelta i.e. item deltas computed during current projection: objectCurrent + currentDelta = objectNew.- Specified by:
getObjectNew
in interfaceModelElementContext<O extends ObjectType>
-
getObjectAny
@Nullable public @Nullable PrismObject<O> getObjectAny()
- Specified by:
getObjectAny
in interfaceModelElementContext<O extends ObjectType>
- Returns:
- "Any" value of the object in this order: new, current, old; taking the first non-null one. It is used when we are not interested in the details but we want just "any" value, e.g. for reporting purposes.
-
getObjectCurrentOrNew
@Nullable public @Nullable PrismObject<O> getObjectCurrentOrNew()
-
getObjectNewOrCurrentRequired
@NotNull public @NotNull PrismObject<O> getObjectNewOrCurrentRequired()
-
getPrimaryDelta
public ObjectDelta<O> getPrimaryDelta()
- Specified by:
getPrimaryDelta
in interfaceModelElementContext<O extends ObjectType>
- Returns:
- Primary delta i.e. one that the caller specified that has to be executed.
-
getSecondaryDelta
public ObjectDelta<O> getSecondaryDelta()
Description copied from interface:ModelElementContext
Returns secondary delta for the current clockwork click. The caller MUST NOT modify returned object in any way.- Specified by:
getSecondaryDelta
in interfaceModelElementContext<O extends ObjectType>
-
getCurrentDelta
public ObjectDelta<O> getCurrentDelta()
Description copied from interface:ModelElementContext
Returns object delta valid for the current clockwork click. It is either primary delta merged with the current secondary delta (if primary delta was not applied yet), or simply current secondary delta. The returned object is (kind of) immutable. Changing it may do strange things, but most likely the changes will be lost.- Specified by:
getCurrentDelta
in interfaceModelElementContext<O extends ObjectType>
-
getSummaryDelta
public ObjectDelta<O> getSummaryDelta()
Description copied from interface:ModelElementContext
Returns object delta comprising both primary delta and (all) secondary deltas, merged together. The returned object is (kind of) immutable. Changing it may do strange things, but most likely the changes will be lost.- Specified by:
getSummaryDelta
in interfaceModelElementContext<O extends ObjectType>
-
getArchivedSecondaryDeltas
@NotNull public @NotNull ObjectDeltaWaves<O> getArchivedSecondaryDeltas()
-
getObjectReadVersion
public String getObjectReadVersion()
-
setOid
public void setOid(String oid)
Sets OID of the new object but also to the deltas (if applicable).
-
setInitialObject
public void setInitialObject(@NotNull @NotNull PrismObject<O> object)
Sets the value of an object that should be present on the clockwork start: both objectCurrent and objectOld. Assumes that clockwork has not started yet.
-
setInitialObject
public void setInitialObject(@NotNull @NotNull PrismObject<O> object, @Nullable @Nullable ObjectDelta<O> objectDelta)
Sets the value of an object that should be present on the clockwork start: both objectCurrent, and (if delta is not "add") also objectOld. Assumes that clockwork has not started yet.
-
setLoadedObject
public abstract void setLoadedObject(@NotNull @NotNull PrismObject<O> object)
Sets current and possibly also old object. This method is used with freshly loaded object. The object is set as current object. If the old object should be initialized, then the object is also set as old object. Should be used only from the context loader!
-
setCurrentObject
public void setCurrentObject(@Nullable @Nullable PrismObject<O> objectCurrent)
Updates the current object. Should be called only from the context loader.
-
clearCurrentObject
public void clearCurrentObject()
Clears the current state, e.g. when determining that the object does not exist anymore. Should be used only from the context loader.
-
setCurrentObjectAndOid
public void setCurrentObjectAndOid(@NotNull @NotNull PrismObject<O> object)
Used to update current object and also the OID. (In cases when the OID might have changed as well.) Should be called only from the context loader.
-
replaceOldAndCurrentObject
public void replaceOldAndCurrentObject(String oid, PrismObject<O> objectOld, PrismObject<O> objectCurrent)
Replaces OID, old, and current object state. Deltas (primary, secondary) are kept untouched. Currently used when doing some magic with resolving conflicts while iterating during the projection of projections. Very dangerous! Use at your own risk!
-
setPrimaryDelta
public void setPrimaryDelta(ObjectDelta<O> primaryDelta)
Assumes clockwork was not started.- Specified by:
setPrimaryDelta
in interfaceModelElementContext<O extends ObjectType>
-
setPrimaryDeltaAfterStart
public void setPrimaryDeltaAfterStart(ObjectDelta<O> primaryDelta)
Sets the primary delta. Does not check for clockwork not being started, so use with care! TODO The check should be perhaps reduced to "context was not yet used" in the future.
-
addToPrimaryDelta
public void addToPrimaryDelta(ObjectDelta<O> delta) throws SchemaException
Adds (merges) a delta into primary delta. Use with care! (This method is 100% safe only when the clockwork has not started.)- Specified by:
addToPrimaryDelta
in interfaceModelElementContext<O extends ObjectType>
- Throws:
SchemaException
-
swallowToPrimaryDelta
public void swallowToPrimaryDelta(ItemDelta<?,?> itemDelta) throws SchemaException
Adds an item delta to primary delta. Dangerous. DO NOT USE unless you know what you are doing. Used from tests and from some scripting hooks.- Throws:
SchemaException
-
modifyPrimaryDelta
public void modifyPrimaryDelta(DeltaModifier<O> modifier) throws SchemaException
Modifies the primary delta. Dangerous! Primary delta is generally supposed to be immutable. Use with utmost care!- Throws:
SchemaException
-
setEstimatedOldValuesInPrimaryDelta
public void setEstimatedOldValuesInPrimaryDelta() throws SchemaException
- Throws:
SchemaException
-
swallowToSecondaryDelta
public void swallowToSecondaryDelta(Collection<? extends ItemDelta<?,?>> itemDeltas) throws SchemaException
- Throws:
SchemaException
-
swallowToSecondaryDeltaUnchecked
public void swallowToSecondaryDeltaUnchecked(ItemDelta<?,?> itemDelta)
-
swallowToSecondaryDelta
public void swallowToSecondaryDelta(ItemDelta<?,?> itemDelta) throws SchemaException
- Throws:
SchemaException
-
initializeElementState
public void initializeElementState(String oid, PrismObject<O> objectOld, PrismObject<O> objectCurrent, ObjectDelta<O> primaryDelta)
Initializes the state of the element: sets old/current state and primary delta, clears the secondary delta. Use with care!
-
rememberElementState
public RememberedElementState<O> rememberElementState()
-
restoreElementState
public void restoreElementState(@NotNull @NotNull RememberedElementState<O> rememberedState) throws SchemaException
- Throws:
SchemaException
-
getPendingObjectPolicyStateModifications
@NotNull public @NotNull List<ItemDelta<?,?>> getPendingObjectPolicyStateModifications()
-
clearPendingPolicyStateModifications
public void clearPendingPolicyStateModifications()
-
addToPendingObjectPolicyStateModifications
public void addToPendingObjectPolicyStateModifications(ItemDelta<?,?> modification)
-
getPendingAssignmentPolicyStateModifications
@NotNull public @NotNull Map<AssignmentSpec,List<ItemDelta<?,?>>> getPendingAssignmentPolicyStateModifications()
-
addToPendingAssignmentPolicyStateModifications
public void addToPendingAssignmentPolicyStateModifications(@NotNull @NotNull AssignmentType assignment, @NotNull @NotNull PlusMinusZero mode, @NotNull @NotNull ItemDelta<?,?> modification)
-
setPolicyRuleCounter
public void setPolicyRuleCounter(String policyRuleIdentifier, int value)
-
getObjectPolicyRules
@NotNull public @NotNull Collection<EvaluatedPolicyRuleImpl> getObjectPolicyRules()
Description copied from interface:ModelElementContext
Returns all policy rules that apply to this object - even those that were not triggered. The policy rules are compiled from all the applicable sources (target, meta-roles, etc.)- Specified by:
getObjectPolicyRules
in interfaceModelElementContext<O extends ObjectType>
-
addObjectPolicyRule
public void addObjectPolicyRule(EvaluatedPolicyRuleImpl policyRule)
-
clearObjectPolicyRules
public void clearObjectPolicyRules()
-
triggerRule
public void triggerRule(@NotNull @NotNull EvaluatedPolicyRule rule, Collection<EvaluatedPolicyRuleTrigger<?>> triggers)
-
isAdd
public abstract boolean isAdd()
Be cautious when using this method forLensProjectionContext
. The projection may be called into existence because a construction is assigned - i.e., no primary delta exists in this case. But the policy decision can also be null: untilActivationProcessor.processProjectionsActivation(LensContext, String, XMLGregorianCalendar, Task, OperationResult)
is started - e.g. during the whole focus projection! See also MID-8569.- Specified by:
isAdd
in interfaceModelElementContext<O extends ObjectType>
-
isDelete
public abstract boolean isDelete()
See also limitations forisAdd()
.- Specified by:
isDelete
in interfaceModelElementContext<O extends ObjectType>
-
isModify
public boolean isModify()
TODO description See also limitations forisAdd()
.
-
getOperation
@NotNull public @NotNull SimpleOperationName getOperation()
Returns a characterization of current operation (add, delete, modify).
-
operationMatches
public boolean operationMatches(ChangeTypeType operation)
-
getExecutedDeltas
@NotNull public @NotNull List<LensObjectDeltaOperation<O>> getExecutedDeltas()
- Specified by:
getExecutedDeltas
in interfaceModelElementContext<O extends ObjectType>
- Returns:
- List of all executed deltas (in fact,
ObjectDeltaOperation
objects).
-
addToExecutedDeltas
public void addToExecutedDeltas(LensObjectDeltaOperation<O> executedDelta)
-
wasAddExecuted
public boolean wasAddExecuted()
-
setAnyDeltasExecutedFlag
public void setAnyDeltasExecutedFlag()
-
isFresh
public boolean isFresh()
-
setFresh
public void setFresh(boolean fresh)
-
rot
public void rot()
-
deleteNonTransientComputationResults
public void deleteNonTransientComputationResults()
Removes results of any previous computations from the context. (Expecting that transient values are not present. So deals only with non-transient ones. Currently this means deletion of secondary deltas.)
-
cleanup
public abstract void cleanup()
Cleans up the contexts by removing some of the working state.
-
getSecurityPolicy
public SecurityPolicyType getSecurityPolicy()
Returns security policy applicable to the object. This means security policy applicable directory to focus or projection. It will NOT return global security policy.
-
setSecurityPolicy
public void setSecurityPolicy(SecurityPolicyType securityPolicy)
-
getCredentialsPolicy
public CredentialsPolicyType getCredentialsPolicy()
-
recompute
public void recompute() throws SchemaException
There is no longer explicit "recompute" action. The validity of computed parts (current/summary delta, adjusted current object, new object) is continuously monitored, and these parts are (re)computed as necessary. So here we may have to callgetObjectNew()
to trigger the recomputation, if needed. We might even remove this method altogether.- Throws:
SchemaException
-
normalize
public void normalize()
-
adopt
public void adopt(PrismContext prismContext) throws SchemaException
- Throws:
SchemaException
-
checkEncrypted
public void checkEncrypted()
-
forEachObject
public void forEachObject(Consumer<PrismObject<O>> consumer)
-
forEachDelta
public void forEachDelta(Consumer<ObjectDelta<O>> consumer)
-
getElementDefaultDesc
protected abstract String getElementDefaultDesc()
-
getElementDesc
protected String getElementDesc()
-
getDebugDumpTitle
protected String getDebugDumpTitle()
-
getHumanReadableName
public abstract String getHumanReadableName()
-
checkConsistence
public final void checkConsistence()
-
checkConsistence
public abstract void checkConsistence(String contextDesc)
-
-