io.spine.server.entity

Class TransactionalEntity<I,S extends com.google.protobuf.Message,B extends io.spine.validate.ValidatingBuilder<S,? extends com.google.protobuf.Message.Builder>>

java.lang.Object

io.spine.server.entity.AbstractEntity<I,S>

io.spine.server.entity.AbstractVersionableEntity<I,S>

io.spine.server.entity.TransactionalEntity<I,S,B>

All Implemented Interfaces:

Entity<I,S>, EntityWithLifecycle<I,S>, VersionableEntity<I,S>, WithLifecycle

Direct Known Subclasses:

CommandHandlingEntity, Projection

public abstract class TransactionalEntity<I,S extends com.google.protobuf.Message,B extends io.spine.validate.ValidatingBuilder<S,? extends com.google.protobuf.Message.Builder>>
extends AbstractVersionableEntity<I,S>

A base for entities, perform transactions events.

Defines a transaction-based mechanism for state, version and lifecycle flags update.

Exposes TransactionalEntity.getBuilder() validating builder} for the state as the only way to modify the state from the descendants.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	TransactionalEntity(I id) Creates a new instance.

Method Summary

Modifier and Type	Method and Description
protected void	clearRecentHistory() Clears recent history.
protected B	getBuilder() Obtains the instance of the state builder.
io.spine.server.entity.LifecycleFlags	getLifecycleFlags() Obtains the current state of the entity lifecycle flags.
protected java.lang.String	getMissingTxMessage() Provides error message text for the case of not having an active transaction when a state modification call is made.
protected RecentHistory	recentHistory() Obtains recent history of events of this entity.
protected void	remember(java.lang.Iterable<io.spine.core.Event> events) Adds events to the recent history.
protected void	setArchived(boolean archived) Sets archived status flag to the passed value.
protected void	setDeleted(boolean deleted) Sets deleted status flag to the passed value.
protected void	setInitialState(S initialState, io.spine.core.Version version) Sets an initial state for the entity.
protected Transaction<I,? extends TransactionalEntity<I,S,B>,S,B>	tx()

Methods inherited from class io.spine.server.entity.AbstractVersionableEntity

checkNotArchived, checkNotDeleted, equals, getVersion, hashCode, isArchived, isDeleted, lifecycleFlagsChanged, versionNumber, whenModified

Methods inherited from class io.spine.server.entity.AbstractEntity

checkEntityState, getDefaultState, getId, getState, idAsString, thisClass, toString, updateState

Methods inherited from class java.lang.Object

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

Methods inherited from interface io.spine.server.entity.Entity

getId, getState, idAsString

Methods inherited from interface io.spine.server.entity.WithLifecycle

isActive

Constructor Detail

TransactionalEntity

protected TransactionalEntity(I id)

Creates a new instance.

Parameters:

id - the ID for the new instance

Throws:

java.lang.IllegalArgumentException - if the ID is not of one of the supported types

Method Detail

recentHistory

protected RecentHistory recentHistory()

Obtains recent history of events of this entity.

remember

protected void remember(java.lang.Iterable<io.spine.core.Event> events)

Adds events to the recent history.

clearRecentHistory

protected void clearRecentHistory()

Clears recent history.

getBuilder

protected B getBuilder()

Obtains the instance of the state builder.

This method must be called only from within an active transaction.

Returns:

the instance of the new state builder

Throws:

java.lang.IllegalStateException - if the method is called not within a transaction

getMissingTxMessage

protected java.lang.String getMissingTxMessage()

Provides error message text for the case of not having an active transaction when a state modification call is made.

tx

protected Transaction<I,? extends TransactionalEntity<I,S,B>,S,B> tx()

setInitialState

protected void setInitialState(S initialState,
                               io.spine.core.Version version)

Sets an initial state for the entity.

The execution of this method requires a presence of active transaction.

getLifecycleFlags

public io.spine.server.entity.LifecycleFlags getLifecycleFlags()

Obtains the current state of the entity lifecycle flags.

If the transaction is in progress, returns the lifecycle flags value for the transaction.

Specified by:

getLifecycleFlags in interface WithLifecycle

Overrides:

getLifecycleFlags in class AbstractVersionableEntity<I,S extends com.google.protobuf.Message>

setArchived

protected void setArchived(boolean archived)

Sets archived status flag to the passed value.

The execution of this method requires a presence of active transaction.

Overrides:

setArchived in class AbstractVersionableEntity<I,S extends com.google.protobuf.Message>

setDeleted

protected void setDeleted(boolean deleted)

Sets deleted status flag to the passed value.

The execution of this method requires a presence of active transaction.

Overrides:

setDeleted in class AbstractVersionableEntity<I,S extends com.google.protobuf.Message>