com.whitestein.lsps.engine.lang

Class InternalRecordHolder

java.lang.Object

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

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

com.whitestein.lsps.engine.lang.InternalRecordHolder

All Implemented Interfaces:

AssociationHandler, RecordHolder, ValueHolder

public final class InternalRecordHolder
extends RecordHolderBase<RecordValue>
implements RecordHolder

Implementation of RecordHolder used for runtime. It is backed by given RecordValue. It translates its values using RuntimeToPersistentConverter.

Author:

rba

Field Summary

Fields inherited from class com.whitestein.lsps.engine.lang.RecordHolderBase

NO_PROPERTY_MSG

Constructor Summary

Constructors

Constructor and Description
InternalRecordHolder(RecordValue val, ModelProvider modelProvider) Creates new instance of InternalRecordHolder.
InternalRecordHolder(RecordValue val, ModelProvider modelProvider, Map<RecordProperty,? extends Object> values) Creates new instance of InternalRecordHolder.

Method Summary

Modifier and Type	Method and Description
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.
boolean	equals(Object obj)
protected RecordEntityAdapter	getAdapter() Returns adapter.
String	getIdentificationString() Returns identification string (string form of primary key)
Object	getJavaIdentification() Returns identification in plain java form.
RecordHolder	getOriginalRecord() Returns proxied record that is not proxy.
Object	getProperty(String name) Returns the property given the property name, if no such property exists, exception is thrown.
RecordHolder	getProxiedRecord() Returns proxied record of this record.
int	getProxyLevel() For original record it returns 0.
RecordProxySetHolder	getProxySet() Returns proxySet of this record.
RecordHolder	getRecordOnProxyLevel(int proxyLevel) Returns record with the defined proxy level or with the smaller level if such does not exist.
Long	getVersion() Returns version in string format.
int	hashCode()
boolean	hasOptimisticLockRelevantChanges() Returns true if record has changes of properties that affect optimistic lock version.
boolean	isProxy() Returns true if record is proxy.
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	remove(boolean isCascaded) Removes record.
void	setProperty(String name, Object value) Sets the property given the property name.
void	setThisSideOfAssociation(RecordProperty property, Object object) Sets value only this side of the association.

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

asMap, clearRuntimeValues, executeMethod, getBaseLevelHolder, getCompiled, getEvaluationLevel, getJavaObject, getNamespace, getType, isRemoved, setCompiled

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

getBaseLevelEntityId, getConverter, getEvaluationConverter, getHandle, getId, getModelInstance, getModelProvider, getNotCompiledValueHolder, getProcessModel, getVal, 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

asMap, executeMethod, getBaseLevelEntityId, getBaseLevelHolder, getCompiled, getEvaluationLevel, getJavaObject, getNamespace, getType, isRemoved, setCompiled

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

getId, getNotCompiledValueHolder

Constructor Detail

InternalRecordHolder

public InternalRecordHolder(RecordValue val,
                            ModelProvider modelProvider)

Creates new instance of InternalRecordHolder.

Parameters:

val -

modelProvider -

Throws:

NullPointerException - if val or modelProvider is null

InternalRecordHolder

public InternalRecordHolder(RecordValue val,
                            ModelProvider modelProvider,
                            Map<RecordProperty,? extends Object> values)

Creates new instance of InternalRecordHolder.

Parameters:

val -

modelProvider -

values -

Throws:

NullPointerException - if val or modelProvider is null

Method Detail

getAdapter

protected RecordEntityAdapter getAdapter()

Description copied from class: RecordHolderBase

Returns adapter.

Specified by:

getAdapter in class RecordHolderBase<RecordValue>

Returns:

adapter

getProperty

public Object getProperty(String name)

Description copied from interface: RecordHolder

Returns the property given the property name, if no such property exists, exception is thrown.

Specified by:

getProperty in interface RecordHolder

Returns:

the property given the property name

setProperty

public void setProperty(String name,
                        Object value)

Description copied from interface: RecordHolder

Sets the property given the property name.

Specified by:

setProperty in interface RecordHolder

getIdentificationString

public String getIdentificationString()

Description copied from interface: RecordHolder

Returns identification string (string form of primary key)

Specified by:

getIdentificationString in interface RecordHolder

Returns:

identification string

getVersion

public Long getVersion()

Description copied from interface: RecordHolder

Returns version in string format.

Specified by:

getVersion in interface RecordHolder

Returns:

version in string format

getJavaIdentification

public Object getJavaIdentification()

Description copied from interface: RecordHolder

Returns identification in plain java form.

Specified by:

getJavaIdentification in interface RecordHolder

Returns:

identification in plain java form

isUpdateNecessary

public boolean isUpdateNecessary(String property)

Description copied from interface: AssociationHandler

Returns true if association should be updated.

Specified by:

isUpdateNecessary in interface AssociationHandler

Overrides:

isUpdateNecessary in class RecordHolderBase<RecordValue>

Returns:

true if association should be updated

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

Overrides:

setThisSideOfAssociation in class RecordHolderBase<RecordValue>

remove

public void remove(boolean isCascaded)

Description copied from interface: RecordHolder

Removes record. If cascaded removes also orphaned entities.

Specified by:

remove in interface RecordHolder

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

Overrides:

hasOptimisticLockRelevantChanges in class RecordHolderBase<RecordValue>

Returns:

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

equals

public boolean equals(Object obj)

Overrides:

equals in class HolderImpl<RecordValue>

hashCode

public int hashCode()

Overrides:

hashCode in class HolderImpl<RecordValue>

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

Overrides:

createChangeProxy in class RecordHolderBase<RecordValue>

Returns:

change proxy on this record holder

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

Overrides:

mergeChanges in class RecordHolderBase<RecordValue>

Returns:

wrapped record of the record with applied changes

Throws:

LspsException

getProxiedRecord

public RecordHolder getProxiedRecord()

Description copied from interface: RecordHolder

Returns proxied record of this record.

Specified by:

getProxiedRecord in interface RecordHolder

Overrides:

getProxiedRecord in class RecordHolderBase<RecordValue>

Returns:

proxied record of this record

getRecordOnProxyLevel

public RecordHolder getRecordOnProxyLevel(int proxyLevel)

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

Overrides:

getRecordOnProxyLevel in class RecordHolderBase<RecordValue>

Returns:

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

getOriginalRecord

public RecordHolder getOriginalRecord()

Description copied from interface: RecordHolder

Returns proxied record that is not proxy.

Specified by:

getOriginalRecord in interface RecordHolder

Overrides:

getOriginalRecord in class RecordHolderBase<RecordValue>

Returns:

proxied record that is not proxy

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

Overrides:

getProxyLevel in class RecordHolderBase<RecordValue>

Returns:

proxy level

getProxySet

public RecordProxySetHolder getProxySet()

Description copied from interface: RecordHolder

Returns proxySet of this record.

Specified by:

getProxySet in interface RecordHolder

Overrides:

getProxySet in class RecordHolderBase<RecordValue>

Returns:

proxySet of this record

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

Overrides:

createPropertyProxy in class RecordHolderBase<RecordValue>

isProxy

public boolean isProxy()

Description copied from interface: RecordHolder

Returns true if record is proxy.

Specified by:

isProxy in interface RecordHolder

Overrides:

isProxy in class RecordHolderBase<RecordValue>

Returns:

true if record is proxy