com.whitestein.lsps.engine.state.xml

Class ExternalValue

java.lang.Object

com.whitestein.lsps.engine.state.xml.ComplexValue

com.whitestein.lsps.engine.state.xml.ExternalValue

All Implemented Interfaces:

Collectible, CommonRecordValue, EntityWithId, EvaluationLevelAware, ModelInstanceAware, RecordChangeProxy, Value

public class ExternalValue
extends ComplexValue
implements RecordChangeProxy, CommonRecordValue

Class used to represent an object that is not defined in the core model types.

Author:

rba

Field Summary

Fields inherited from class com.whitestein.lsps.engine.state.xml.ComplexValue

modelInstance

Constructor Summary

Constructors

Constructor and Description
ExternalValue(long id, ModelInstance modelInstance, String type, String objectIdentification, Long processInstanceId, Long version, boolean renewVersion, boolean register, Long auditRevision) Creates new instance of ExternalValue.
ExternalValue(ModelInstance modelInstance, String type, String objectIdentification, Long processInstanceId, Long auditRevision) Creates new instance of ExternalValue.
ExternalValue(SExternalValue source, ModelInstance modelInstance) Creates a new instance from the serialized companion.

Method Summary

Modifier and Type	Method and Description
<T,E extends Throwable> T	accept(ValueVisitor<T,E> visitor) Accepts visitor.
void	addToCachedNonsharedAssociations(String name, ComplexValue value) Adds to cache of nonshared associations.
void	cleanAndSetRenewVersion() Cleans version string and sets renewVersion to true.
protected void	convertToDirectReferences()
RecordValue	createChangeProxy(RecordProxySetValue proxySet, boolean isLazySpreading) Created a change proxy on this object.
protected Context	createContext(long parentContextId)
ExternalValue	createCopy(ModelInstance targetModelInstance) Creates a copy without references to other objects.
void	finishCopy(com.whitestein.lsps.engine.state.xml.Copiable source, CopyHelper helper) Copy references.
Long	getAuditRevision() Returns audit revision.
ComplexValue	getFromCachedNonsharedAssociations(String name) Returns value from to cache of nonshared associations.
Handle	getHandle() Returns handle.
String	getObjectIdentification() Returns the object identification.
String[]	getObjectIdentificationSegments() Returns segments of the identification.
RecordChangeProxy	getOriginalRecord() Returns a record object that is original non-proxy record.
Context	getOwnContext(long parentContextId) Returns own context
ProcessInstance	getProcessInstance() Deprecated. information about process instance id is stored in the objectIdentificationSegments
Long	getProcessInstanceId() Deprecated. information about process instance id is stored in the objectIdentificationSegments
int	getProxyLevel() Gets number of proxies from this object to original non-proxy record.
RecordProxySetValue	getProxySet() Returns proxy set in which the proxy is registered.
Collection<Collectible>	getReferences() Returns collection of all referenced collectible objects.
Long	getVersion() Returns shared entity version.
boolean	hasObjectIdentification() Returns true if object identification is set.
boolean	isLazySpreadingProxy() Returns true if the proxy is lazy spreading.
boolean	isProxyOf(RecordChangeProxy record) Returns true if this is direct or non-direct proxy of the record.
boolean	isRemoved() Returns true if value is removed
boolean	isRenewVersion() Returns true if the version should be set to new value.
void	rebind(ModelInstance modelInstance) Re-binds to a model instance.
void	refreshDirectReferences() Re-set references to elements from the same model instance.
void	remove() Set this value to removed.
void	removeFromCacheNonsharedAssociation(String name) Removes from the nonshared association cache.
void	replaceReferencedIds(Map<Long,Long> replacementMap) Replace referenced ids according to mappings in the replacement map.
void	revertRemove() Set this value to not removed.
void	setObjectIdentification(String objectIdentification) Sets the object identification.
void	setProcessInstanceId(Long processInstanceId) Deprecated. information about process instance id is stored in the objectIdentificationSegments
void	setRenewVersion(boolean renewVersion) Sets renewVersion value.
void	setVersion(Long versionValue) Sets shared entity version.
SExternalValue	toSerializable(SModelInstance smi, MarshallerConfig config) Creates a serializable object.
String	toString()
ExternalValueUniqueKey	toUniqueKey() Returns unique key for this instance.

Methods inherited from class com.whitestein.lsps.engine.state.xml.ComplexValue

clear, collect, fillSerializable, findReplacementId, getBaseLevelEntity, getBaseLevelEntityId, getCompiledType, getEvaluationLevel, getId, getLowerLevelEntity, getLowerLevelEntityId, getModelInstance, getType, isPersistent, replaceIdAndEvaluationLevel, setLowerLevelEntity, toSimpleValue, toValue

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.whitestein.lsps.engine.state.xml.CommonRecordValue

getId, getModelInstance

Methods inherited from interface com.whitestein.lsps.engine.state.xml.Value

getCompiledType, getType, toSimpleValue, toValue

Methods inherited from interface com.whitestein.lsps.engine.state.xml.Collectible

collect, isPersistent

Constructor Detail

ExternalValue

public ExternalValue(SExternalValue source,
                     ModelInstance modelInstance)

Creates a new instance from the serialized companion.

Parameters:

source -

modelInstance -

ExternalValue

public ExternalValue(ModelInstance modelInstance,
                     String type,
                     String objectIdentification,
                     Long processInstanceId,
                     Long auditRevision)

Creates new instance of ExternalValue.

Parameters:

modelInstance -

type -

objectIdentification -

processInstanceId -

auditRevision -

Throws:

NullPointerException - if modelInstance or type is null

ExternalValue

public ExternalValue(long id,
                     ModelInstance modelInstance,
                     String type,
                     String objectIdentification,
                     Long processInstanceId,
                     Long version,
                     boolean renewVersion,
                     boolean register,
                     Long auditRevision)

Creates new instance of ExternalValue.

Parameters:

id -

modelInstance -

type -

objectIdentification -

processInstanceId -

version -

renewVersion -

register -

auditRevision -

Throws:

NullPointerException - if modelInstance or type is null

Method Detail

toSerializable

public SExternalValue toSerializable(SModelInstance smi,
                                     MarshallerConfig config)

Description copied from class: ComplexValue

Creates a serializable object.

Specified by:

toSerializable in interface Value

Specified by:

toSerializable in class ComplexValue

Returns:

a serializable object

getObjectIdentification

public String getObjectIdentification()

Returns the object identification.

Returns:

the object identification

hasObjectIdentification

public boolean hasObjectIdentification()

Returns true if object identification is set.

Returns:

true if object identification is set

setObjectIdentification

public void setObjectIdentification(String objectIdentification)

Sets the object identification.

Parameters:

objectIdentification -

getProcessInstance

@Deprecated
public ProcessInstance getProcessInstance()

Deprecated. information about process instance id is stored in the objectIdentificationSegments

Returns the referenced process instance.

Returns:

the referenced process instance

getProcessInstanceId

@Deprecated
public Long getProcessInstanceId()

Deprecated. information about process instance id is stored in the objectIdentificationSegments

Returns the referenced process instance id.

Returns:

the referenced process instance id

setProcessInstanceId

@Deprecated
public void setProcessInstanceId(Long processInstanceId)

Deprecated. information about process instance id is stored in the objectIdentificationSegments

Sets the process instance id.

Parameters:

processInstanceId -

getHandle

public Handle getHandle()

Description copied from class: ComplexValue

Returns handle.

Overrides:

getHandle in class ComplexValue

Returns:

handle

accept

public <T,E extends Throwable> T accept(ValueVisitor<T,E> visitor)
                                 throws E extends Throwable

Description copied from interface: Value

Accepts visitor.

Specified by:

accept in interface Value

Returns:

the result

Throws:

E

E extends Throwable

toString

public String toString()

Overrides:

toString in class Object

toUniqueKey

public ExternalValueUniqueKey toUniqueKey()

Returns unique key for this instance.

Returns:

unique key for this instance

replaceReferencedIds

public void replaceReferencedIds(Map<Long,Long> replacementMap)

Description copied from class: ComplexValue

Replace referenced ids according to mappings in the replacement map.

Specified by:

replaceReferencedIds in interface EvaluationLevelAware

Overrides:

replaceReferencedIds in class ComplexValue

rebind

public void rebind(ModelInstance modelInstance)

Description copied from class: ComplexValue

Re-binds to a model instance.

Specified by:

rebind in interface ModelInstanceAware

Overrides:

rebind in class ComplexValue

getReferences

public Collection<Collectible> getReferences()

Description copied from interface: Collectible

Returns collection of all referenced collectible objects.

Specified by:

getReferences in interface Collectible

Returns:

collection of all referenced collectible objects

remove

public void remove()

Set this value to removed.

revertRemove

public void revertRemove()

Set this value to not removed.

isRemoved

public boolean isRemoved()

Description copied from interface: Value

Returns true if value is removed

Specified by:

isRemoved in interface Value

Overrides:

isRemoved in class ComplexValue

Returns:

true if value is removed

addToCachedNonsharedAssociations

public void addToCachedNonsharedAssociations(String name,
                                             ComplexValue value)

Adds to cache of nonshared associations.

Parameters:

name -

value -

removeFromCacheNonsharedAssociation

public void removeFromCacheNonsharedAssociation(String name)

Removes from the nonshared association cache.

Parameters:

name -

getFromCachedNonsharedAssociations

public ComplexValue getFromCachedNonsharedAssociations(String name)

Returns value from to cache of nonshared associations.

Parameters:

name -

Returns:

value from to cache of nonshared associations

createCopy

public ExternalValue createCopy(ModelInstance targetModelInstance)

Creates a copy without references to other objects.

Returns:

creates a copy

finishCopy

public void finishCopy(com.whitestein.lsps.engine.state.xml.Copiable source,
                       CopyHelper helper)

Copy references.

Overrides:

finishCopy in class ComplexValue

getVersion

public Long getVersion()

Returns shared entity version.

Returns:

shared entity version

setVersion

public void setVersion(Long versionValue)

Sets shared entity version.

Parameters:

versionValue -

isRenewVersion

public boolean isRenewVersion()

Returns true if the version should be set to new value.

Returns:

true if the version should be set to new value

setRenewVersion

public void setRenewVersion(boolean renewVersion)

Sets renewVersion value.

Parameters:

renewVersion -

cleanAndSetRenewVersion

public void cleanAndSetRenewVersion()

Cleans version string and sets renewVersion to true.

getAuditRevision

public Long getAuditRevision()

Returns audit revision.

Returns:

audit revision

getObjectIdentificationSegments

public String[] getObjectIdentificationSegments()

Returns segments of the identification.

Returns:

segments of the identification

createChangeProxy

public RecordValue createChangeProxy(RecordProxySetValue proxySet,
                                     boolean isLazySpreading)

Description copied from interface: RecordChangeProxy

Created a change proxy on this object.

Specified by:

createChangeProxy in interface RecordChangeProxy

Returns:

a change proxy on this object

getProxyLevel

public int getProxyLevel()

Description copied from interface: RecordChangeProxy

Gets number of proxies from this object to original non-proxy record. If this is not a proxy it returns 0. If this is a proxy it returns "proxy level of proxied object" + 1.

Specified by:

getProxyLevel in interface RecordChangeProxy

Returns:

level of wrapping for this object

getProxySet

public RecordProxySetValue getProxySet()

Description copied from interface: RecordChangeProxy

Returns proxy set in which the proxy is registered.

Specified by:

getProxySet in interface RecordChangeProxy

Returns:

proxy set in which the proxy is registered

isLazySpreadingProxy

public boolean isLazySpreadingProxy()

Description copied from interface: RecordChangeProxy

Returns true if the proxy is lazy spreading. It means that all accessed properties are automatically converted to proxy objects and the created proxies are again lazy spreading.

Specified by:

isLazySpreadingProxy in interface RecordChangeProxy

Returns:

true if the proxy is lazy spreading

getOriginalRecord

public RecordChangeProxy getOriginalRecord()

Description copied from interface: RecordChangeProxy

Returns a record object that is original non-proxy record. If this is a proxy it returns proxied object recursively. If this is not proxy it returns itself.

Specified by:

getOriginalRecord in interface RecordChangeProxy

Returns:

a record object that is original non-proxy record

isProxyOf

public boolean isProxyOf(RecordChangeProxy record)

Description copied from interface: RecordChangeProxy

Returns true if this is direct or non-direct proxy of the record.

Specified by:

isProxyOf in interface RecordChangeProxy

Returns:

true if this is direct or non-direct proxy of the record

convertToDirectReferences

protected void convertToDirectReferences()

Specified by:

convertToDirectReferences in class ComplexValue

refreshDirectReferences

public void refreshDirectReferences()

Description copied from interface: EvaluationLevelAware

Re-set references to elements from the same model instance.

Specified by:

refreshDirectReferences in interface EvaluationLevelAware

Specified by:

refreshDirectReferences in class ComplexValue

createContext

protected Context createContext(long parentContextId)

getOwnContext

public Context getOwnContext(long parentContextId)

Returns own context

Specified by:

getOwnContext in interface CommonRecordValue

Parameters:

parentContextId -

Returns:

own context