com.whitestein.lsps.engine.lang

Class RecordHolderBase<T extends ComplexValue>

java.lang.Object

com.whitestein.lsps.engine.lang.HolderImpl<T>

com.whitestein.lsps.engine.lang.RecordHolderBase<T>

Type Parameters:

T -

All Implemented Interfaces:

AssociationHandler, RecordHolder, ValueHolder

Direct Known Subclasses:

ExternalRecordHolderBase, InternalRecordHolder

public abstract class RecordHolderBase<T extends ComplexValue>
extends HolderImpl<T>
implements RecordHolder

Base class for all RecordHolder implementations.

Author:

rba

Field Summary

Fields

Modifier and Type	Field and Description
protected static String	NO_PROPERTY_MSG Error message.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	RecordHolderBase(T val, ModelProvider modelProvider) Creates new instance of RecordHolderBase.

Method Summary

Modifier and Type	Method and Description
Map<String,Object>	asMap() Returns a map view of this record.
void	clearRuntimeValues() Clears referenced runtime values.
RecordHolder	createChangeProxy(RecordHolder proxySet, boolean isLazySpreading) Creates change proxy on this record holder.
void	createPropertyProxy(HolderFactory holderFactory, String property, RecordHolder proxySet) Creates change proxy for all object referenced by the propery and sets the proxy values to the property.
Object	executeMethod(Namespace parentNamespace, FunctionSignature signature, Object... arguments) Executes method with parameters.
protected abstract RecordEntityAdapter	getAdapter() Returns adapter.
RecordHolder	getBaseLevelHolder() Returns holder for the base level value.
RecordHolder	getCompiled(Object compiledContext) Returns instance of the compiled record for this record holder.
String	getEvaluationLevel() Returns the evaluation level.
Object	getJavaObject() Returns underlying java object if there is some.
Namespace	getNamespace(Namespace parentNamespace) Returns namespace of this record.
RecordHolder	getOriginalRecord() Returns proxied record that is not proxy.
RecordHolder	getProxiedRecord() Returns proxied record of this record.
int	getProxyLevel() For original record it returns 0.
RecordHolder	getProxySet() Returns proxySet of this record.
RecordHolder	getRecordOnProxyLevel(int wrappingLevel) Returns record with the defined proxy level or with the smaller level if such does not exist.
RecordType	getType() Returns the type of the holder.
boolean	hasOptimisticLockRelevantChanges() Returns true if record has changes of properties that affect optimistic lock version.
boolean	isProxy() Returns true if record is proxy.
boolean	isRemoved() Returns true if the record is removed from the model instance.
boolean	isUpdateNecessary(String property) Returns true if association should be updated.
RecordHolder	mergeChanges(Namespace namespace, boolean checkConflicts) If this is wrapper it merges all its changes to the wrapped record.
void	setCompiled(RecordHolder compiled) Set instance of compiled record.
void	setThisSideOfAssociation(RecordProperty property, Object object) Sets value only this side of the association.

Methods inherited from class com.whitestein.lsps.engine.lang.HolderImpl

equals, getBaseLevelEntityId, getConverter, getEvaluationConverter, getHandle, getId, getModelInstance, getModelProvider, getNotCompiledValueHolder, getProcessModel, getVal, hashCode, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.whitestein.lsps.lang.exec.RecordHolder

getBaseLevelEntityId, getIdentificationString, getJavaIdentification, getProperty, getVersion, remove, setProperty

Methods inherited from interface com.whitestein.lsps.lang.exec.ValueHolder

getId, getNotCompiledValueHolder

Field Detail

NO_PROPERTY_MSG

protected static final String NO_PROPERTY_MSG

Error message.

See Also:

Constant Field Values

Constructor Detail

RecordHolderBase

protected RecordHolderBase(T val,
                           ModelProvider modelProvider)

Creates new instance of RecordHolderBase.

Parameters:

val -

modelProvider -

Throws:

NullPointerException - if val or modelProvider is null

Method Detail

getType

public RecordType getType()

Description copied from interface: ValueHolder

Returns the type of the holder.

Specified by:

getType in interface RecordHolder

Specified by:

getType in interface ValueHolder

Overrides:

getType in class HolderImpl<T extends ComplexValue>

Returns:

the type of the holder

asMap

public Map<String,Object> asMap()

Description copied from interface: RecordHolder

Returns a map view of this record.

Specified by:

asMap in interface RecordHolder

Returns:

a map view of this record

setThisSideOfAssociation

public void setThisSideOfAssociation(RecordProperty property,
                                     Object object)

Description copied from interface: AssociationHandler

Sets value only this side of the association.

Specified by:

setThisSideOfAssociation in interface AssociationHandler

isUpdateNecessary

public boolean isUpdateNecessary(String property)

Description copied from interface: AssociationHandler

Returns true if association should be updated.

Specified by:

isUpdateNecessary in interface AssociationHandler

Returns:

true if association should be updated

clearRuntimeValues

public void clearRuntimeValues()

Description copied from class: HolderImpl

Clears referenced runtime values.

Specified by:

clearRuntimeValues in class HolderImpl<T extends ComplexValue>

getEvaluationLevel

public String getEvaluationLevel()

Description copied from interface: RecordHolder

Returns the evaluation level.

Specified by:

getEvaluationLevel in interface RecordHolder

Returns:

evaluation level

getBaseLevelHolder

public RecordHolder getBaseLevelHolder()

Returns holder for the base level value.

Specified by:

getBaseLevelHolder in interface RecordHolder

Returns:

holder for the base level value

getAdapter

protected abstract RecordEntityAdapter getAdapter()

Returns adapter.

Returns:

adapter

hasOptimisticLockRelevantChanges

public boolean hasOptimisticLockRelevantChanges()

Description copied from interface: RecordHolder

Returns true if record has changes of properties that affect optimistic lock version.

Specified by:

hasOptimisticLockRelevantChanges in interface RecordHolder

Returns:

true if record has changes of properties that affect optimistic lock version

isRemoved

public boolean isRemoved()

Description copied from interface: RecordHolder

Returns true if the record is removed from the model instance.

Specified by:

isRemoved in interface RecordHolder

Returns:

true if the record is removed from the model instance

getNamespace

public Namespace getNamespace(Namespace parentNamespace)

Description copied from interface: RecordHolder

Returns namespace of this record.

Specified by:

getNamespace in interface RecordHolder

Returns:

namespace of this record

getJavaObject

public Object getJavaObject()

Description copied from interface: RecordHolder

Returns underlying java object if there is some. E.g. for pojo based shared records.

Specified by:

getJavaObject in interface RecordHolder

Returns:

underlying java object if there is some

mergeChanges

public RecordHolder mergeChanges(Namespace namespace,
                                 boolean checkConflicts)
                          throws LspsException

Description copied from interface: RecordHolder

If this is wrapper it merges all its changes to the wrapped record. It returns wrapped record of the record with applied changes.

Specified by:

mergeChanges in interface RecordHolder

Returns:

wrapped record of the record with applied changes

Throws:

LspsException

createChangeProxy

public RecordHolder createChangeProxy(RecordHolder proxySet,
                                      boolean isLazySpreading)

Description copied from interface: RecordHolder

Creates change proxy on this record holder. If the record already has proxy in the proxy set it returns the proxy. If a new proxy is created it is added to the proxy set. Proxy set can be null.

Specified by:

createChangeProxy in interface RecordHolder

Returns:

change proxy on this record holder

getOriginalRecord

public RecordHolder getOriginalRecord()

Description copied from interface: RecordHolder

Returns proxied record that is not proxy.

Specified by:

getOriginalRecord in interface RecordHolder

Returns:

proxied record that is not proxy

getProxiedRecord

public RecordHolder getProxiedRecord()

Description copied from interface: RecordHolder

Returns proxied record of this record.

Specified by:

getProxiedRecord in interface RecordHolder

Returns:

proxied record of this record

getProxySet

public RecordHolder getProxySet()

Description copied from interface: RecordHolder

Returns proxySet of this record.

Specified by:

getProxySet in interface RecordHolder

Returns:

proxySet of this record

getRecordOnProxyLevel

public RecordHolder getRecordOnProxyLevel(int wrappingLevel)

Description copied from interface: RecordHolder

Returns record with the defined proxy level or with the smaller level if such does not exist. In other case returns null.

Specified by:

getRecordOnProxyLevel in interface RecordHolder

Returns:

record with the defined proxy level or with the smaller level if such does not exist

getProxyLevel

public int getProxyLevel()

Description copied from interface: RecordHolder

For original record it returns 0. For proxy it returns "proxy level of "proxied record"+1.

Specified by:

getProxyLevel in interface RecordHolder

Returns:

proxy level

createPropertyProxy

public void createPropertyProxy(HolderFactory holderFactory,
                                String property,
                                RecordHolder proxySet)

Description copied from interface: RecordHolder

Creates change proxy for all object referenced by the propery and sets the proxy values to the property. If some of the proxy already exists in the proxy set it does not create new proxy. All new created proxies are added to the proxy set. Proxy set can be null.

Specified by:

createPropertyProxy in interface RecordHolder

isProxy

public boolean isProxy()

Description copied from interface: RecordHolder

Returns true if record is proxy.

Specified by:

isProxy in interface RecordHolder

Returns:

true if record is proxy

executeMethod

public Object executeMethod(Namespace parentNamespace,
                            FunctionSignature signature,
                            Object... arguments)
                     throws ErrorException

Description copied from interface: RecordHolder

Executes method with parameters.

Specified by:

executeMethod in interface RecordHolder

Returns:

result of method execution

Throws:

ErrorException

getCompiled

public RecordHolder getCompiled(Object compiledContext)

Description copied from interface: RecordHolder

Returns instance of the compiled record for this record holder.

Specified by:

getCompiled in interface RecordHolder

Returns:

instance of the compiled record for this record holder

setCompiled

public void setCompiled(RecordHolder compiled)

Description copied from interface: RecordHolder

Set instance of compiled record.

Specified by:

setCompiled in interface RecordHolder