org.activiti.engine
Interface ManagementService

public interface ManagementService

Service for admin and maintenance operations on the process engine. These operations will typically not be used in a workflow driven application, but are used in for example the operational console.

Author:

Tom Baeyens, Joram Barrez, Falko Menge

Method Summary

JobQuery	createJobQuery() Returns a new JobQuery implementation, that can be used to dynamically query the jobs.
TablePageQuery	createTablePageQuery() Creates a TablePageQuery that can be used to fetch TablePage containing specific sections of table row data.
String	databaseSchemaUpgrade(Connection connection, String catalog, String schema) programmatic schema update on a given connection returning feedback about what happened
void	executeJob(String jobId) Forced synchronous execution of a job for testing purposes.
String	getJobExceptionStacktrace(String jobId) Returns the full stacktrace of the exception that occurs when the job with the given id was last executed.
Map<String,String>	getProperties() get the list of properties.
Map<String,Long>	getTableCount() Get the mapping containing {table name, row count} entries of the Activiti database schema.
TableMetaData	getTableMetaData(String tableName) Gets the metadata (column names, column types, etc.) of a certain table.
void	setJobRetries(String jobId, int retries) Sets the number of retries that a job has left.

Method Detail

getTableCount

Map<String,Long> getTableCount()

Get the mapping containing {table name, row count} entries of the Activiti database schema.

getTableMetaData

TableMetaData getTableMetaData(String tableName)

Gets the metadata (column names, column types, etc.) of a certain table. Returns null when no table exists with the given name.

createTablePageQuery

TablePageQuery createTablePageQuery()

Creates a TablePageQuery that can be used to fetch TablePage containing specific sections of table row data.

createJobQuery

JobQuery createJobQuery()

Returns a new JobQuery implementation, that can be used to dynamically query the jobs.

executeJob

void executeJob(String jobId)

Forced synchronous execution of a job for testing purposes.

Parameters:

jobId - id of the job to execute, cannot be null.

Throws:

ActivitiException - when there is no job with the given id.

setJobRetries

void setJobRetries(String jobId,
                   int retries)

Sets the number of retries that a job has left. Whenever the JobExecutor fails to execute a job, this value is decremented. When it hits zero, the job is supposed to be dead and not retried again. In that case, this method can be used to increase the number of retries.

Parameters:

jobId - id of the job to modify, cannot be null.

retries - number of retries.

getJobExceptionStacktrace

String getJobExceptionStacktrace(String jobId)

Returns the full stacktrace of the exception that occurs when the job with the given id was last executed. Returns null when the job has no exception stacktrace.

Parameters:

jobId - id of the job, cannot be null.

Throws:

ActivitiException - when no job exists with the given id.

getProperties

Map<String,String> getProperties()

get the list of properties.

databaseSchemaUpgrade

String databaseSchemaUpgrade(Connection connection,
                             String catalog,
                             String schema)

programmatic schema update on a given connection returning feedback about what happened