org.camunda.bpm.engine.impl.persistence.entity
Class VariableInstanceEntity

java.lang.Object
  org.camunda.bpm.engine.impl.persistence.entity.VariableInstanceEntity

All Implemented Interfaces:

Serializable, CoreVariableInstance, DbEntity, DbEntityLifecycleAware, HasDbRevision, TypedValueUpdateListener, ValueFields, VariableInstance

public class VariableInstanceEntity
extends Object
implements VariableInstance, CoreVariableInstance, ValueFields, DbEntity, DbEntityLifecycleAware, TypedValueUpdateListener, HasDbRevision, Serializable

Author:

Tom Baeyens

See Also:

Serialized Form

Field Summary

protected String	activityInstanceId
protected ByteArrayField	byteArrayField
protected String	caseExecutionId
protected String	caseInstanceId
protected String	configuration
protected Double	doubleValue
protected String	executionId
protected String	id
protected boolean	isConcurrentLocal Determines whether this variable is supposed to be a local variable in case of concurrency in its scope.
protected boolean	isTransient Determines whether this variable is stored in the data base.
protected static EnginePersistenceLogger	LOG
protected Long	longValue
protected String	name
protected String	processInstanceId
protected int	revision
protected long	sequenceCounter
protected String	taskId
protected String	textValue
protected String	textValue2
protected TypedValueField	typedValueField

Constructor Summary

VariableInstanceEntity()

Method Summary

void	clearValueFields()
static VariableInstanceEntity	create(String name, org.camunda.bpm.engine.variable.value.TypedValue value)
static VariableInstanceEntity	createAndInsert(String name, org.camunda.bpm.engine.variable.value.TypedValue value)
void	delete()
protected void	deleteByteArrayValue()
boolean	equals(Object obj)
String	getActivityInstanceId() Returns the corresponding activity instance id.
byte[]	getByteArrayValue()
String	getByteArrayValueId()
CaseExecutionEntity	getCaseExecution()
String	getCaseExecutionId() Returns the corresponding case execution id.
String	getCaseInstanceId() Returns the corresponding case instance id.
protected ProcessApplicationReference	getContextProcessApplication()
Double	getDoubleValue()
String	getErrorMessage() If the variable value could not be loaded, this returns the error message.
ExecutionEntity	getExecution()
String	getExecutionId() Returns the corresponding execution id.
String	getId()
Long	getLongValue()
String	getName() Returns the name of this variable instance.
Object	getPersistentState() Returns a representation of the object, as would be stored in the database.
String	getProcessInstanceId() Returns the corresponding process instance id.
int	getRevision()
int	getRevisionNext()
long	getSequenceCounter()
TypedValueSerializer<?>	getSerializer()
String	getSerializerName()
protected TaskEntity	getTask()
String	getTaskId() Returns the corresponding task id.
String	getTextValue()
String	getTextValue2()
org.camunda.bpm.engine.variable.value.TypedValue	getTypedValue() Returns the TypedValue of this variable instance.
org.camunda.bpm.engine.variable.value.TypedValue	getTypedValue(boolean deserializeValue)
String	getTypeName() Returns the name of the type of this variable instance
Object	getValue() Returns the value of this variable instance.
protected VariableScope	getVariableScope()
String	getVariableScopeId()
int	hashCode()
void	incrementSequenceCounter()
static void	insert(VariableInstanceEntity variableInstance)
boolean	isConcurrentLocal()
boolean	isTransient()
void	onImplicitValueUpdate(org.camunda.bpm.engine.variable.value.TypedValue updatedValue) Called when an implicit update to a typed value is detected
void	postLoad()
void	setActivityInstanceId(String activityInstanceId)
void	setByteArrayValue(byte[] bytes)
void	setByteArrayValueId(String byteArrayValueId)
void	setCaseExecutionId(String caseExecutionId)
void	setCaseInstanceId(String caseInstanceId)
void	setConcurrentLocal(boolean isConcurrentLocal)
void	setDoubleValue(Double doubleValue)
void	setExecution(ExecutionEntity execution)
void	setExecutionId(String executionId)
void	setId(String id)
void	setLongValue(Long longValue)
void	setName(String name)
void	setProcessInstanceId(String processInstanceId)
void	setRevision(int revision)
void	setSequenceCounter(long sequenceCounter)
void	setSerializer(TypedValueSerializer<?> serializer)
void	setSerializerName(String type)
void	setTaskId(String taskId)
void	setTextValue(String textValue)
void	setTextValue2(String textValue2)
void	setTransient(boolean isTransient)
org.camunda.bpm.engine.variable.value.TypedValue	setValue(org.camunda.bpm.engine.variable.value.TypedValue value)
String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

LOG

protected static final EnginePersistenceLogger LOG

id

protected String id

revision

protected int revision

name

protected String name

processInstanceId

protected String processInstanceId

executionId

protected String executionId

taskId

protected String taskId

caseInstanceId

protected String caseInstanceId

caseExecutionId

protected String caseExecutionId

activityInstanceId

protected String activityInstanceId

longValue

protected Long longValue

doubleValue

protected Double doubleValue

textValue

protected String textValue

textValue2

protected String textValue2

byteArrayField

protected ByteArrayField byteArrayField

typedValueField

protected TypedValueField typedValueField

configuration

protected String configuration

sequenceCounter

protected long sequenceCounter

isConcurrentLocal

protected boolean isConcurrentLocal

Determines whether this variable is supposed to be a local variable in case of concurrency in its scope. This affects

• tree expansion (not evaluated yet by the engine)
• activity instance IDs of variable instances: concurrentLocal variables always receive the activity instance id of their execution (which may not be the scope execution), while non-concurrentLocal variables always receive the activity instance id of their scope (which is set in the parent execution)

In the future, this field could be used for restoring the variable distribution when the tree is expanded/compacted multiple times. On expansion, the goal would be to keep concurrentLocal variables always with their concurrent replacing executions while non-concurrentLocal variables stay in the scope execution

isTransient

protected boolean isTransient

Determines whether this variable is stored in the data base.

Constructor Detail

VariableInstanceEntity

public VariableInstanceEntity()

Method Detail

createAndInsert

public static VariableInstanceEntity createAndInsert(String name,
                                                     org.camunda.bpm.engine.variable.value.TypedValue value)

insert

public static void insert(VariableInstanceEntity variableInstance)

create

public static VariableInstanceEntity create(String name,
                                            org.camunda.bpm.engine.variable.value.TypedValue value)

delete

public void delete()

getPersistentState

public Object getPersistentState()

Description copied from interface: DbEntity

Returns a representation of the object, as would be stored in the database. Used when deciding if updates have occurred to the object or not since it was last loaded.

Specified by:

getPersistentState in interface DbEntity

getRevisionNext

public int getRevisionNext()

Specified by:

getRevisionNext in interface HasDbRevision

setProcessInstanceId

public void setProcessInstanceId(String processInstanceId)

setExecutionId

public void setExecutionId(String executionId)

setCaseInstanceId

public void setCaseInstanceId(String caseInstanceId)

setCaseExecutionId

public void setCaseExecutionId(String caseExecutionId)

getByteArrayValueId

public String getByteArrayValueId()

setByteArrayValueId

public void setByteArrayValueId(String byteArrayValueId)

getByteArrayValue

public byte[] getByteArrayValue()

Specified by:

getByteArrayValue in interface ValueFields

setByteArrayValue

public void setByteArrayValue(byte[] bytes)

Specified by:

setByteArrayValue in interface ValueFields

deleteByteArrayValue

protected void deleteByteArrayValue()

getValue

public Object getValue()

Description copied from interface: VariableInstance

Returns the value of this variable instance.

Specified by:

getValue in interface VariableInstance

getTypedValue

public org.camunda.bpm.engine.variable.value.TypedValue getTypedValue()

Description copied from interface: VariableInstance

Returns the TypedValue of this variable instance.

Specified by:

getTypedValue in interface VariableInstance

getTypedValue

public org.camunda.bpm.engine.variable.value.TypedValue getTypedValue(boolean deserializeValue)

Specified by:

getTypedValue in interface CoreVariableInstance

setValue

public org.camunda.bpm.engine.variable.value.TypedValue setValue(org.camunda.bpm.engine.variable.value.TypedValue value)

clearValueFields

public void clearValueFields()

getTypeName

public String getTypeName()

Description copied from interface: VariableInstance

Returns the name of the type of this variable instance

Specified by:

getTypeName in interface VariableInstance

Returns:

the type name of the variable

postLoad

public void postLoad()

Specified by:

postLoad in interface DbEntityLifecycleAware

getExecution

public ExecutionEntity getExecution()

setExecution

public void setExecution(ExecutionEntity execution)

getCaseExecution

public CaseExecutionEntity getCaseExecution()

getId

public String getId()

Specified by:

getId in interface DbEntity

Specified by:

getId in interface VariableInstance

Returns:

the Id of this variable instance

setId

public void setId(String id)

Specified by:

setId in interface DbEntity

getTextValue

public String getTextValue()

Specified by:

getTextValue in interface ValueFields

getProcessInstanceId

public String getProcessInstanceId()

Description copied from interface: VariableInstance

Returns the corresponding process instance id.

Specified by:

getProcessInstanceId in interface VariableInstance

getExecutionId

public String getExecutionId()

Description copied from interface: VariableInstance

Returns the corresponding execution id.

Specified by:

getExecutionId in interface VariableInstance

getCaseInstanceId

public String getCaseInstanceId()

Description copied from interface: VariableInstance

Returns the corresponding case instance id.

Specified by:

getCaseInstanceId in interface VariableInstance

getCaseExecutionId

public String getCaseExecutionId()

Description copied from interface: VariableInstance

Returns the corresponding case execution id.

Specified by:

getCaseExecutionId in interface VariableInstance

getLongValue

public Long getLongValue()

Specified by:

getLongValue in interface ValueFields

setLongValue

public void setLongValue(Long longValue)

Specified by:

setLongValue in interface ValueFields

getDoubleValue

public Double getDoubleValue()

Specified by:

getDoubleValue in interface ValueFields

setDoubleValue

public void setDoubleValue(Double doubleValue)

Specified by:

setDoubleValue in interface ValueFields

setName

public void setName(String name)

setTextValue

public void setTextValue(String textValue)

Specified by:

setTextValue in interface ValueFields

getName

public String getName()

Description copied from interface: VariableInstance

Returns the name of this variable instance.

Specified by:

getName in interface CoreVariableInstance

Specified by:

getName in interface ValueFields

Specified by:

getName in interface VariableInstance

getRevision

public int getRevision()

Specified by:

getRevision in interface HasDbRevision

setRevision

public void setRevision(int revision)

Specified by:

setRevision in interface HasDbRevision

setSerializer

public void setSerializer(TypedValueSerializer<?> serializer)

setSerializerName

public void setSerializerName(String type)

getSerializer

public TypedValueSerializer<?> getSerializer()

getTextValue2

public String getTextValue2()

Specified by:

getTextValue2 in interface ValueFields

setTextValue2

public void setTextValue2(String textValue2)

Specified by:

setTextValue2 in interface ValueFields

getTaskId

public String getTaskId()

Description copied from interface: VariableInstance

Returns the corresponding task id.

Specified by:

getTaskId in interface VariableInstance

setTaskId

public void setTaskId(String taskId)

getActivityInstanceId

public String getActivityInstanceId()

Description copied from interface: VariableInstance

Returns the corresponding activity instance id.

Specified by:

getActivityInstanceId in interface VariableInstance

setActivityInstanceId

public void setActivityInstanceId(String activityInstanceId)

getSerializerName

public String getSerializerName()

getErrorMessage

public String getErrorMessage()

Description copied from interface: VariableInstance

If the variable value could not be loaded, this returns the error message.

Specified by:

getErrorMessage in interface VariableInstance

Returns:

an error message indicating why the variable value could not be loaded.

getVariableScopeId

public String getVariableScopeId()

getVariableScope

protected VariableScope getVariableScope()

getTask

protected TaskEntity getTask()

getSequenceCounter

public long getSequenceCounter()

setSequenceCounter

public void setSequenceCounter(long sequenceCounter)

incrementSequenceCounter

public void incrementSequenceCounter()

isConcurrentLocal

public boolean isConcurrentLocal()

setConcurrentLocal

public void setConcurrentLocal(boolean isConcurrentLocal)

onImplicitValueUpdate

public void onImplicitValueUpdate(org.camunda.bpm.engine.variable.value.TypedValue updatedValue)

Description copied from interface: TypedValueUpdateListener

Called when an implicit update to a typed value is detected

Specified by:

onImplicitValueUpdate in interface TypedValueUpdateListener

getContextProcessApplication

protected ProcessApplicationReference getContextProcessApplication()

toString

public String toString()

Overrides:

toString in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

setTransient

public void setTransient(boolean isTransient)

Parameters:

isTransient - true, if the variable is not stored in the data base. Default is false.

isTransient

public boolean isTransient()

Returns:

true, if the variable is transient. A transient variable is not stored in the data base.