com.whitestein.lsps.engine.state.xml

Class BinaryValue

java.lang.Object

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

com.whitestein.lsps.engine.state.xml.BinaryValue

All Implemented Interfaces:

Collectible, EntityWithId, EvaluationLevelAware, ModelInstanceAware, Value

public class BinaryValue
extends ComplexValue

External binary value that stores info about shared record instance that contains binary. In case the binary is stored in a variable of field on non-shared record the data are stored in the value property. In case the binary is stored in a binary field of a shared record the data is stored in a blob in the table of the shared record. The properties recordType, objectIdentification, propertyName, blob, blobLoader are used in this case. If a binary value from a shared record is set to a variable, the data from the blob are set to the value during marshaling. This is implemented in the method prepareMarshal.

Author:

bhl

Field Summary

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

modelInstance

Constructor Summary

Constructors

Constructor and Description
BinaryValue(ModelInstance modelInstance, java.lang.String level, byte[] value) Creates new instance of BinaryValue.
BinaryValue(ModelInstance modelInstance, java.lang.String level, byte[] value, java.lang.String datasourceJndi, java.lang.String recordType, java.lang.String objectIdentification, java.lang.String propertyName, java.sql.Blob blob, BlobLoader blobLoader) Creates new instance.
BinaryValue(ModelInstance modelInstance, java.lang.String level, java.lang.String datasourceJndi, java.lang.String recordType, java.lang.String objectIdentification, java.lang.String propertyName, java.sql.Blob blob, BlobLoader blobLoader) Creates new instance.
BinaryValue(SBinarySimpleValue source, ModelInstance modelInstance) Creates a new instance from the serialized companion.
BinaryValue(SBinaryValue source, ModelInstance modelInstance) Creates a new instance from the serialized companion.

Method Summary

Modifier and Type	Method and Description
<T,E extends java.lang.Throwable> T	accept(ValueVisitor<T,E> visitor) Accepts visitor.
protected void	convertToDirectReferences()
BinaryValue	createCopy(ModelInstance targetModelInstance) Creates a copy without references to other objects.
java.sql.Blob	getBlob() Returns blob, if fails tries to reload referencing record holder.
Type	getCompiledType(ModelProvider modelProvider) Returns the compiled type.
byte[]	getData() Returns binary data.
java.lang.String	getDatasourceJndi() Returns datasource jndi.
java.lang.String	getEvaluationLevel() Returns evaluation level,
ModelInstance	getModelInstance() Returns the model instance.
java.lang.String	getObjectIdentification() Returns referenced object identification.
java.lang.String	getPropertyName() Returns property name in which binary is stored.
java.lang.String	getRecordType() Returns referenced record type.
java.util.Collection<Collectible>	getReferences() Returns collection of all referenced collectible objects.
java.lang.String	getType() Returns the type.
byte[]	getValue()
boolean	isRemoved() Returns true if value is removed
void	rebind(ModelInstance modelInstance) Re-binds to a model instance.
void	refreshDirectReferences() Re-set references to elements from the same model instance.
void	setBlobLoader(BlobLoader blobLoader) Sets blob loader.
SBinaryValue	toSerializable(SModelInstance smi, MarshallerConfig config) Creates a serializable object.
java.lang.String	toString()
Value	toValue() If this is a ValueRef this method returns the referenced value, otherwise it returns this.

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

clear, collect, fillSerializable, findReplacementId, finishCopy, getBaseLevelEntity, getBaseLevelEntityId, getHandle, getId, getLowerLevelEntity, getLowerLevelEntityId, isPersistent, replaceIdAndEvaluationLevel, replaceReferencedIds, setLowerLevelEntity, toSimpleValue

Methods inherited from class java.lang.Object

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

Constructor Detail

BinaryValue

public BinaryValue(ModelInstance modelInstance,
                   java.lang.String level,
                   byte[] value,
                   java.lang.String datasourceJndi,
                   java.lang.String recordType,
                   java.lang.String objectIdentification,
                   java.lang.String propertyName,
                   java.sql.Blob blob,
                   BlobLoader blobLoader)

Creates new instance.

Parameters:

modelInstance -

level -

value -

datasourceJndi -

recordType -

objectIdentification -

propertyName -

blob -

blobLoader -

BinaryValue

public BinaryValue(ModelInstance modelInstance,
                   java.lang.String level,
                   java.lang.String datasourceJndi,
                   java.lang.String recordType,
                   java.lang.String objectIdentification,
                   java.lang.String propertyName,
                   java.sql.Blob blob,
                   BlobLoader blobLoader)

Creates new instance.

Parameters:

modelInstance -

level -

datasourceJndi -

recordType -

objectIdentification -

propertyName -

blob -

blobLoader -

BinaryValue

public BinaryValue(ModelInstance modelInstance,
                   java.lang.String level,
                   byte[] value)

Creates new instance of BinaryValue.

Parameters:

modelInstance -

level -

value -

Throws:

java.lang.NullPointerException - if modelInstance or value is null

BinaryValue

public BinaryValue(SBinaryValue source,
                   ModelInstance modelInstance)

Creates a new instance from the serialized companion.

Parameters:

source -

modelInstance -

BinaryValue

public BinaryValue(SBinarySimpleValue source,
                   ModelInstance modelInstance)

Creates a new instance from the serialized companion. This is used for old implementation of the binary value that was not ComplexValue. Therefore there is temp id generated by the ValueContent and this instance is added to the thread local of the ValueContent so that it can be added to other deserialized ComplexValues.

Parameters:

source -

modelInstance -

Method Detail

toSerializable

public SBinaryValue 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

getValue

public byte[] getValue()

accept

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

Description copied from interface: Value

Accepts visitor.

Returns:

the result

Throws:

E

E extends java.lang.Throwable

getModelInstance

public ModelInstance getModelInstance()

Description copied from interface: ModelInstanceAware

Returns the model instance.

Specified by:

getModelInstance in interface ModelInstanceAware

Overrides:

getModelInstance in class ComplexValue

Returns:

the model instance

toValue

public Value toValue()

Description copied from interface: Value

If this is a ValueRef this method returns the referenced value, otherwise it returns this.

Specified by:

toValue in interface Value

Overrides:

toValue in class ComplexValue

Returns:

a Value

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

getType

public java.lang.String getType()

Description copied from interface: Value

Returns the type.

Specified by:

getType in interface Value

Overrides:

getType in class ComplexValue

Returns:

the type

getCompiledType

public Type getCompiledType(ModelProvider modelProvider)

Description copied from interface: Value

Returns the compiled type.

Specified by:

getCompiledType in interface Value

Overrides:

getCompiledType in class ComplexValue

Returns:

the compiled type

rebind

public void rebind(ModelInstance modelInstance)

Re-binds to a model instance.

Specified by:

rebind in interface ModelInstanceAware

Overrides:

rebind in class ComplexValue

Parameters:

modelInstance -

getDatasourceJndi

public java.lang.String getDatasourceJndi()

Returns datasource jndi.

Returns:

datasource jndi

getRecordType

public java.lang.String getRecordType()

Returns referenced record type.

Returns:

referenced record type

getObjectIdentification

public java.lang.String getObjectIdentification()

Returns referenced object identification.

Returns:

referenced object identification

getPropertyName

public java.lang.String getPropertyName()

Returns property name in which binary is stored.

Returns:

property name in which binary is stored

getEvaluationLevel

public java.lang.String getEvaluationLevel()

Returns evaluation level,

Specified by:

getEvaluationLevel in interface EvaluationLevelAware

Overrides:

getEvaluationLevel in class ComplexValue

Returns:

evaluation level

getBlob

public java.sql.Blob getBlob()

Returns blob, if fails tries to reload referencing record holder.

Returns:

blob

setBlobLoader

public void setBlobLoader(BlobLoader blobLoader)

Sets blob loader.

Parameters:

blobLoader -

getData

public byte[] getData()

Returns binary data.

Returns:

binary data

createCopy

public BinaryValue createCopy(ModelInstance targetModelInstance)

Creates a copy without references to other objects.

Returns:

creates a copy

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

getReferences

public java.util.Collection<Collectible> getReferences()

Description copied from interface: Collectible

Returns collection of all referenced collectible objects.

Returns:

collection of all referenced collectible objects

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