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, ModelProviderClientService modelProviderService) 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() Creates change proxy on this record holder.
void	createPropertyProxy(HolderFactory holderFactory, String property) 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 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.
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.
int	getProxyLevel() For original record it returns 0.
RecordHolder	getRecordOnProxyLevel(int wrappingLevel) Returns record on the defined proxy level or on 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 cascade, boolean checkConflicts) If this is wrapper it merges all its changes to the wrapped record.
protected void	setAdapter(RecordEntityAdapter adapter) Sets adapter.
void	setCompiled(RecordHolder compiled)
void	setThisSideOfAssociation(String name, 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, getModelProviderService, getNotCompiledValue, 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, getVersionString, remove, setProperty

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

getId, getNotCompiledValue

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,
                           ModelProviderClientService modelProviderService)

Creates new instance of RecordHolderBase.

Parameters:

val -

modelProviderService -

Throws:

NullPointerException - if val or modelProviderService 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(String name,
                                     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>

getBaseLevelHolder

public RecordHolder getBaseLevelHolder()

Returns holder for the base level value.

Specified by:

getBaseLevelHolder in interface RecordHolder

Returns:

holder for the base level value

setAdapter

protected void setAdapter(RecordEntityAdapter adapter)

Sets adapter.

Parameters:

adapter -

getAdapter

protected 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 cascade,
                                 boolean checkConflicts)
                          throws LspsException

Description copied from interface: RecordHolder

If this is wrapper it merges all its changes to the wrapped record. If cascaded is false it merges only the record. If cascaded is true it merges changes from all wrappers that can be accessed from the record and has same wrapper level. 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()

Description copied from interface: RecordHolder

Creates change proxy on this record holder.

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.

Specified by:

getProxiedRecord in interface RecordHolder

Returns:

getRecordOnProxyLevel

public RecordHolder getRecordOnProxyLevel(int wrappingLevel)

Description copied from interface: RecordHolder

Returns record on the defined proxy level or on the smaller level if such does not exist.

Specified by:

getRecordOnProxyLevel in interface RecordHolder

Returns:

proxied record on the defined proxy level or on 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)

Description copied from interface: RecordHolder

Creates change proxy for all object referenced by the propery and sets the proxy values to the property.

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)

Specified by:

setCompiled in interface RecordHolder