pro.taskana.impl

Class TaskanaEngineImpl

java.lang.Object

pro.taskana.impl.TaskanaEngineImpl

All Implemented Interfaces:

TaskanaEngine

public class TaskanaEngineImpl
extends Object
implements TaskanaEngine

This is the implementation of TaskanaEngine.

Nested Class Summary

Nested classes/interfaces inherited from interface pro.taskana.TaskanaEngine

TaskanaEngine.ConnectionManagementMode

Field Summary

Fields

Modifier and Type	Field and Description
protected Connection	connection
protected TaskanaEngine.ConnectionManagementMode	mode
protected org.apache.ibatis.session.SqlSessionFactory	sessionFactory
protected org.apache.ibatis.session.SqlSessionManager	sessionManager
protected static ThreadLocal<Stack<org.apache.ibatis.session.SqlSessionManager>>	sessionStack
protected TaskanaEngineConfiguration	taskanaEngineConfiguration
protected org.apache.ibatis.transaction.TransactionFactory	transactionFactory

Constructor Summary

Constructors

Constructor and Description
TaskanaEngineImpl(TaskanaEngineConfiguration taskanaEngineConfiguration)

Method Summary

Modifier and Type	Method and Description
void	closeConnection() closes the connection to the database in mode EXPLICIT.
ClassificationService	getClassificationService() The ClassificationService can be used for operations on all Categories.
TaskanaEngineConfiguration	getConfiguration() The Taskana configuration.
protected static org.apache.ibatis.session.SqlSessionManager	getSessionFromStack()
protected static Stack<org.apache.ibatis.session.SqlSessionManager>	getSessionStack() With sessionStack, we maintain a Stack of SqlSessionManager objects on a per thread basis.
TaskService	getTaskService() The TaskService can be used for operations on all Tasks.
WorkbasketService	getWorkbasketService() The WorkbasketService can be used for operations on all Workbaskets.
protected static void	popSessionFromStack()
protected static void	pushSessionToStack(org.apache.ibatis.session.SqlSessionManager session)
void	setConnection(Connection connection) Set the database connection to be used by taskana.
void	setConnectionManagementMode(TaskanaEngine.ConnectionManagementMode mode) sets the connection management mode.

Methods inherited from class java.lang.Object

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

Field Detail

sessionStack

protected static ThreadLocal<Stack<org.apache.ibatis.session.SqlSessionManager>> sessionStack

taskanaEngineConfiguration

protected TaskanaEngineConfiguration taskanaEngineConfiguration

transactionFactory

protected org.apache.ibatis.transaction.TransactionFactory transactionFactory

sessionManager

protected org.apache.ibatis.session.SqlSessionManager sessionManager

sessionFactory

protected org.apache.ibatis.session.SqlSessionFactory sessionFactory

mode

protected TaskanaEngine.ConnectionManagementMode mode

connection

protected Connection connection

Constructor Detail

TaskanaEngineImpl

public TaskanaEngineImpl(TaskanaEngineConfiguration taskanaEngineConfiguration)

Method Detail

getTaskService

public TaskService getTaskService()

Description copied from interface: TaskanaEngine

The TaskService can be used for operations on all Tasks.

Specified by:

getTaskService in interface TaskanaEngine

Returns:

the TaskService

getWorkbasketService

public WorkbasketService getWorkbasketService()

Description copied from interface: TaskanaEngine

The WorkbasketService can be used for operations on all Workbaskets.

Specified by:

getWorkbasketService in interface TaskanaEngine

Returns:

the TaskService

getClassificationService

public ClassificationService getClassificationService()

Description copied from interface: TaskanaEngine

The ClassificationService can be used for operations on all Categories.

Specified by:

getClassificationService in interface TaskanaEngine

Returns:

the TaskService

getConfiguration

public TaskanaEngineConfiguration getConfiguration()

Description copied from interface: TaskanaEngine

The Taskana configuration.

Specified by:

getConfiguration in interface TaskanaEngine

Returns:

the TaskanaConfiguration

setConnectionManagementMode

public void setConnectionManagementMode(TaskanaEngine.ConnectionManagementMode mode)

sets the connection management mode.

Specified by:

setConnectionManagementMode in interface TaskanaEngine

Parameters:

mode - - the connection management mode Valid values are PARTICIPATE - taskana participates in global transaction. This is the default mode AUTOCOMMIT - taskana commits each API call separately EXPLICIT - commit processing is managed explicitly by the client

setConnection

public void setConnection(Connection connection)

Set the database connection to be used by taskana. If this Api is called, taskana uses the connection passed by the client for database access in all subsequent API calls until the client resets this connection. Control over commit and rollback is the responsibility of the client. In order to close the connection, the client can call TaskanaEngine.closeConnection() or TaskanaEngine.setConnection(null). Both calls have the same effect.

Specified by:

setConnection in interface TaskanaEngine

Parameters:

connection - TODO

closeConnection

public void closeConnection()

closes the connection to the database in mode EXPLICIT. In mode EXPLICIT, closes the client's connection, sets it to null and switches to mode PARTICIPATE Has the same effect as setConnection(null)

Specified by:

closeConnection in interface TaskanaEngine

getSessionStack

protected static Stack<org.apache.ibatis.session.SqlSessionManager> getSessionStack()

With sessionStack, we maintain a Stack of SqlSessionManager objects on a per thread basis. SqlSessionManager is the MyBatis object that wraps database connections. The purpose of this stack is to keep track of nested calls. Each external API call is wrapped into taskanaEngineImpl.openConnection(); ..... taskanaEngineImpl.returnConnection(); calls. In order to avoid duplicate opening / closing of connections, we use the sessionStack in the following way: Each time, an openConnection call is received, we push the current sessionManager onto the stack. On the first call to openConnection, we call sessionManager.startManagedSession() to open a database connection. On each call to returnConnection() we pop one instance of sessionManager from the stack. When the stack becomes empty, we close the database connection by calling sessionManager.close()

Returns:

Stack of SqlSessionManager

getSessionFromStack

protected static org.apache.ibatis.session.SqlSessionManager getSessionFromStack()

pushSessionToStack

protected static void pushSessionToStack(org.apache.ibatis.session.SqlSessionManager session)

popSessionFromStack

protected static void popSessionFromStack()