de.espirit.or

Interface Session

public interface Session

Since:

4.0.17

Method Summary

Methods

Modifier and Type	Method and Description
void	addSessionListener(de.espirit.or.SessionListener listener) Add the listener to this session.
void	close() Close the session and release all used resources.
void	commit() Make all changes since the last commit or rollback persistent.
void	commit(String comment) Make all changes since the last commit or rollback persistent with the given comment as revision comment.
Entity	createEntity(String type) Create a new entity of the given type
Select	createSelect(String name) Create a select for the entity type name with the actual session time as query time.
void	delete(Entity entity) Mark the entity as deleted.
EntityList	executeQuery(Select select)
de.espirit.or.DumpData	exportData(String name, long from, long to)
Schema	extractSchemaFromDB(String schemaName) Update the assigned schema with the structure of DB schema schemaName.
IdentifierList<UUID,Entity>	fetchEntities(String entityTypeName, Collection<UUID> entityGids) Fetches all entities specified by given gids.
List<KeyValue>	fetchKeys(Select select) Return a list of key values of all entities which fullfill the criterion defined by select.
Entity	find(EntityType type, String uuid) Returns the entity specififed by given EntityType and uuid string
Entity	find(EntityType type, UUID uuid) Returns the entity specififed by given EntityType and uuid
Entity	find(Identifier identifier) Return the entity with the given identifier.
Entity	find(KeyValue keyValue) Return the entity with the given keyValue.
Entity	find(String entityTypeName, Object... key) Return the entity of type entityTypeName with the id key.
Entity	findNotNull(KeyValue keyValue) Returns an entity with the given keyValue even if it doesn't exist.
Entity	findNotNull(String entityTypeName, Object... key) Returns an entity of type entityTypeName with the id key even if it doesn't exists.
Set<Entity>	getChanged() Return the set of modified but not committed entities in this session.
List<Entity>	getDeletedEntities(String entityTypeName) Get all deleted entities from type entityTypeName.
List<Entity>	getHistory(KeyValue keyValue) Return the history of the entity with the given keyValue.
List<Entity>	getInvalidEntities(KeyValue keyValue) Return a list of invalid entities of the given keyValue..
long	getLastChangeTime(Select select) Get the timestamp of the last change of the result set of the specified select.
long	getLastChangeTime(Select select, long after) Get the timestamp of the last change of the result set of the specified select after the specified timestamp.
Set<KeyValue>	getReleasedDeleted(String entityTypeName) Get the key values of all entities of the given entity type which are deleted but still released.
Schema	getSchema() Return the schema assigned with this session.
boolean	hasChangedAfter(Select select, long time) Return true if the result of the query with the given select is not empty.
boolean	hasChanges() Returns true if there are uncommitted changes, see commit and rollback.
void	importData(de.espirit.or.DumpData data) Import the data into the database connected by this session.
void	importUpdateData(de.espirit.or.DumpData data) Import or update the data into the database connected by this session.
boolean	isReadOnly() If the session is "read only" no modifications are permitted.
boolean	isRelease() Return true if this session is a release session else false.
void	release(Entity entity) Release the given entity.
void	removeSessionListener(de.espirit.or.SessionListener listener) Remove the listener from this session.
void	restore(Identifier identifier) Restore the deleted entity with the identifier.
void	rollback() Undo all changes since the last commit or rollback.
Schema	syncSchemaWithDB(Schema schema, boolean importMode) Update the DB structure with the given schema.
void	updateWorkflowData(Entity entity, Color wfColor, long taskId) Set the workflow color and the task id of entity to wfColor and taskId.
Select	xml2Select(String queryXml) Construct a select from the xml document queryXml.

Method Detail

getSchema

@NotNull
Schema getSchema()

Return the schema assigned with this session.

Since:

4.0.17

createEntity

@NotNull
Entity createEntity(@NotNull
                          String type)
                    throws de.espirit.or.ORException

Create a new entity of the given type

Throws:

de.espirit.or.ORException

Since:

4.0.17

find

@Nullable
Entity find(@NotNull
                   KeyValue keyValue)

Return the entity with the given keyValue.

Since:

4.0.17

findNotNull

@NotNull
Entity findNotNull(@NotNull
                         KeyValue keyValue)

Returns an entity with the given keyValue even if it doesn't exist. In that case the entity's state is NOT_EXISTS.

Since:

4.1.2

find

@Nullable
Entity find(@NotNull
                   String entityTypeName,
                   @NotNull
                   Object... key)

Return the entity of type entityTypeName with the id key.

Since:

4.0.17

find

Entity find(@NotNull
          EntityType type,
          String uuid)

Returns the entity specififed by given EntityType and uuid string

Since:

5.0.100

find

Entity find(@NotNull
          EntityType type,
          UUID uuid)

Returns the entity specififed by given EntityType and uuid

Since:

5.0.100

findNotNull

@NotNull
Entity findNotNull(@NotNull
                         String entityTypeName,
                         @NotNull
                         Object... key)

Returns an entity of type entityTypeName with the id key even if it doesn't exists. In that case the entity's state is NOT_EXISTS.

Since:

4.1.2

find

@NotNull
Entity find(@NotNull
                  Identifier identifier)

Return the entity with the given identifier.

Important: Keep in mind the difference between an Identifier and KeyValue, use find(KeyValue)if possible!

Since:

4.0.17

createSelect

@NotNull
Select createSelect(@NotNull
                          String name)
                    throws de.espirit.or.SchemaException

Create a select for the entity type name with the actual session time as query time.

Throws:

de.espirit.or.SchemaException

Since:

4.0.17

xml2Select

@NotNull
Select xml2Select(@NotNull
                        String queryXml)
                  throws de.espirit.or.ORException

Construct a select from the xml document queryXml.

Throws:

de.espirit.or.ORException

Since:

4.0.17

delete

void delete(@NotNull
          Entity entity)
            throws de.espirit.or.ORException

Mark the entity as deleted. The change is persistent by the next commit().

Throws:

de.espirit.or.ORException

Since:

4.0.17

executeQuery

@NotNull
EntityList executeQuery(@NotNull
                              Select select)
                        throws de.espirit.or.ORException

Throws:

de.espirit.or.ORException

Since:

4.0.17

fetchEntities

IdentifierList<UUID,Entity> fetchEntities(@NotNull
                                        String entityTypeName,
                                        @NotNull
                                        Collection<UUID> entityGids)

Fetches all entities specified by given gids.
Attention: List could contain null entries for gids no entity could be found for.

Since:

5.0.412

getDeletedEntities

@NotNull
List<Entity> getDeletedEntities(@NotNull
                                      String entityTypeName)
                                throws de.espirit.or.ORException

Get all deleted entities from type entityTypeName.

Throws:

de.espirit.or.ORException

Since:

4.0.19

getReleasedDeleted

@NotNull
Set<KeyValue> getReleasedDeleted(@NotNull
                                       String entityTypeName)
                                 throws de.espirit.or.ORException

Get the key values of all entities of the given entity type which are deleted but still released.

Throws:

de.espirit.or.ORException

Since:

4.0.91

getInvalidEntities

@NotNull
List<Entity> getInvalidEntities(@NotNull
                                      KeyValue keyValue)
                                throws de.espirit.or.ORException

Return a list of invalid entities of the given keyValue.. For non-temporal schemas this method delivers an empty list.

Throws:

de.espirit.or.ORException

Since:

4.0.22

See Also:

getHistory(de.espirit.or.schema.KeyValue)

getHistory

@NotNull
List<Entity> getHistory(@NotNull
                              KeyValue keyValue)
                        throws de.espirit.or.ORException

Return the history of the entity with the given keyValue. For non-temporal schemas this method delivers an empty list. In contrast to getInvalidEntities(de.espirit.or.schema.KeyValue) the returned list includes the also the most actual value of the entity.

Parameters:

keyValue - the key of the entity

Returns:

the history of changes for the specified entity

Throws:

ORException - in case of database problems

Since:

4.2.44

See Also:

getInvalidEntities(de.espirit.or.schema.KeyValue)

restore

void restore(@NotNull
           Identifier identifier)
             throws de.espirit.or.ORException

Restore the deleted entity with the identifier.

Throws:

de.espirit.or.ORException

Since:

4.0.20

fetchKeys

@NotNull
List<KeyValue> fetchKeys(@NotNull
                               Select select)
                         throws de.espirit.or.ORException

Return a list of key values of all entities which fullfill the criterion defined by select.

Throws:

de.espirit.or.ORException

Since:

4.0.17

importData

void importData(@NotNull
              de.espirit.or.DumpData data)
                throws de.espirit.or.ORException

Import the data into the database connected by this session.

Throws:

de.espirit.or.ORException

Since:

4.0.17

importUpdateData

void importUpdateData(@NotNull
                    de.espirit.or.DumpData data)
                      throws de.espirit.or.ORException

Import or update the data into the database connected by this session.

Throws:

de.espirit.or.ORException

Since:

4.1.16

exportData

@NotNull
de.espirit.or.DumpData exportData(@NotNull
                                        String name,
                                        long from,
                                        long to)
                                  throws de.espirit.or.ORException

Throws:

de.espirit.or.ORException

Since:

4.0.17

rollback

void rollback()

Undo all changes since the last commit or rollback.

Since:

4.0.17

commit

void commit()
            throws de.espirit.or.ORException

Make all changes since the last commit or rollback persistent.

Throws:

de.espirit.or.ORException

Since:

4.0.17

commit

void commit(String comment)
            throws de.espirit.or.ORException

Make all changes since the last commit or rollback persistent with the given comment as revision comment.

Throws:

de.espirit.or.ORException

Since:

4.0.27

close

void close()
           throws de.espirit.or.ORException

Close the session and release all used resources. If a transaction is open then this will will be committed.

Throws:

de.espirit.or.ORException

Since:

4.0.17

release

void release(@NotNull
           Entity entity)
             throws de.espirit.or.ORException

Release the given entity.

Throws:

de.espirit.or.ORException

Since:

4.0.17

isRelease

boolean isRelease()

Return true if this session is a release session else false. All entities manages by a release session must be in the release state. A release session supports only the following operations

• delete a released entity delete(Entity)
• execute a query executeQuery(Select), find an entity by key #find(String,Object) the returned entities are all in the release state

All other operations like create a new entity createEntity(String), import data importData(DumpData), create a new schema form the database extractSchemaFromDB(String) and update the database structure syncSchemaWithDB(Schema,boolean) are not supported. An UnsupportedOperationException will be thrown if these methods is called in a release session.

Since:

4.0.17

extractSchemaFromDB

Schema extractSchemaFromDB(String schemaName)

Update the assigned schema with the structure of DB schema schemaName.

Since:

4.0.17

syncSchemaWithDB

Schema syncSchemaWithDB(@NotNull
                      Schema schema,
                      boolean importMode)

Update the DB structure with the given schema. If importMode is true then no foreign key and primary key is created in the DB in other case all primary and foreign keys will be created

Since:

4.0.17

isReadOnly

boolean isReadOnly()

If the session is "read only" no modifications are permitted.

Since:

4.0.17

hasChanges

boolean hasChanges()

Returns true if there are uncommitted changes, see commit and rollback.

Since:

4.0.17

See Also:

commit, rollback

getChanged

Set<Entity> getChanged()

Return the set of modified but not committed entities in this session.

Since:

4.0.17

hasChangedAfter

boolean hasChangedAfter(@NotNull
                      Select select,
                      long time)
                        throws de.espirit.or.ORException

Return true if the result of the query with the given select is not empty.

Throws:

de.espirit.or.ORException

Since:

4.0.17

getLastChangeTime

long getLastChangeTime(@NotNull
                     Select select)
                       throws de.espirit.or.ORException

Get the timestamp of the last change of the result set of the specified select. Only changes of theresult table are considered.

Only supported for temporal schema.

Throws:

de.espirit.or.ORException

Since:

4.0.19

See Also:

getLastChangeTime(de.espirit.or.query.Select,long)

getLastChangeTime

long getLastChangeTime(@NotNull
                     Select select,
                     long after)
                       throws de.espirit.or.ORException

Get the timestamp of the last change of the result set of the specified select after the specified timestamp. Only changes of the result table are considered.

Only supported for temporal schema.

Throws:

de.espirit.or.ORException

Since:

4.2.400

See Also:

getLastChangeTime(de.espirit.or.query.Select)

addSessionListener

void addSessionListener(@NotNull
                      de.espirit.or.SessionListener listener)

Add the listener to this session.

Since:

4.0.17

removeSessionListener

void removeSessionListener(@NotNull
                         de.espirit.or.SessionListener listener)

Remove the listener from this session.

Since:

4.0.17

updateWorkflowData

void updateWorkflowData(@NotNull
                      Entity entity,
                      Color wfColor,
                      long taskId)
                        throws de.espirit.or.ORException

Set the workflow color and the task id of entity to wfColor and taskId. This update doesn't create a new version of entity in the database and is executed immediately.

Throws:

de.espirit.or.ORException

Since:

4.0.17