Package org.bonitasoft.engine.parameter

Interface ParameterService

All Known Implementing Classes:

ParameterServiceImpl

public interface ParameterService

Since:

6.0

Author:

Matthieu Chaffotte

Method Summary

Modifier and Type	Method	Description
void	addAll(long processDefinitionId, Map<String,String> parameters)	Store all parameters provided to the specific process in file system
boolean	containsNullValues(long processDefinitionId)	Check if the specific process contains null-valued parameter or not.
void	deleteAll(long processDefinitionId)	Delete all parameters for a specific processDefinition
List<SParameter>	get(long processDefinitionId, int fromIndex, int numberOfResult, OrderBy order)	Get parameters in a specific interval for specific process, this is used for pagination
SParameter	get(long processDefinitionId, String parameterName)	Get parameter by name in specific process
Map<String,String>	getAll(long processDefinitionId)	return all parameters in a map
List<SParameter>	getNullValues(long processDefinitionId, int fromIndex, int numberOfResult, OrderBy order)	Get a list of parameters will null values in order in specific process
void	merge(long processDefinitionId, Map<String,String> parameters)	Merge given parameters with existing ones.
void	update(long processDefinitionId, String parameterName, String parameterValue)	Update specific parameter value in a process

Method Details

update

void update(long processDefinitionId,
 String parameterName,
 String parameterValue)
     throws SParameterNameNotFoundException,
SBonitaReadException,
SObjectModificationException

Update specific parameter value in a process

Parameters:

processDefinitionId - identifier of processDefinition

parameterName - name of the parameter will be updated

parameterValue - new value of the parameter

Throws:

SParameterNameNotFoundException - error thrown if no parameter found for the specific parameterName

SBonitaReadException

SObjectModificationException

merge

void merge(long processDefinitionId,
 Map<String,String> parameters)
    throws SBonitaReadException,
SObjectModificationException

Merge given parameters with existing ones. Unknown parameters are ignored.

Parameters:

processDefinitionId - identifier of processDefinition

parameters - parameters to merge

Throws:

SBonitaReadException - error thrown if an error occurred while retrieving the process definition

SObjectModificationException - error thrown if an error occurred while updating the parameter value

addAll

void addAll(long processDefinitionId,
 Map<String,String> parameters)
     throws SParameterProcessNotFoundException,
SObjectCreationException,
SBonitaReadException,
SObjectModificationException

Store all parameters provided to the specific process in file system

Parameters:

processDefinitionId - identifier of processDefinition

parameters - parameters will be stored in file system

Throws:

SParameterProcessNotFoundException - error thrown if no parameters configuration file found in file system

SObjectCreationException

SBonitaReadException

SObjectModificationException

getAll

Map<String,String> getAll(long processDefinitionId)
                   throws SParameterProcessNotFoundException,
SBonitaReadException

return all parameters in a map

Parameters:

processDefinitionId -

Throws:

SParameterProcessNotFoundException

SBonitaReadException

deleteAll

void deleteAll(long processDefinitionId)
        throws SParameterProcessNotFoundException,
SBonitaReadException,
SObjectModificationException

Delete all parameters for a specific processDefinition

Parameters:

processDefinitionId - ID of processDefinition

Throws:

SParameterProcessNotFoundException - error thrown if no parameters configuration file found in file system

SBonitaReadException

SObjectModificationException

get

List<SParameter> get(long processDefinitionId,
 int fromIndex,
 int numberOfResult,
 OrderBy order)
              throws SOutOfBoundException,
SBonitaReadException

Get parameters in a specific interval for specific process, this is used for pagination

Parameters:

processDefinitionId - identifier of processDefinition

fromIndex - index of the record to be retrieved from. First record has index 0

numberOfResult - number of result we want to get. Maximum number of result returned.

order - OrderBy object, contains information to do order

Returns:

a list of SParameter objects

Throws:

SOutOfBoundException - error throw if fromIndex >= total size of parameters

SBonitaReadException

get

SParameter get(long processDefinitionId,
 String parameterName)
        throws SBonitaReadException

Get parameter by name in specific process

Parameters:

processDefinitionId - identifier of processDefinition

parameterName - name of parameter

Returns:

the parameter or null if it does not exists

Throws:

SBonitaReadException

getNullValues

List<SParameter> getNullValues(long processDefinitionId,
 int fromIndex,
 int numberOfResult,
 OrderBy order)
                        throws SParameterProcessNotFoundException,
SOutOfBoundException,
SBonitaReadException

Get a list of parameters will null values in order in specific process

Parameters:

processDefinitionId - identifier of processDefinition

fromIndex - index of the record to be retrieved from. First record has index 0

numberOfResult - number of result we want to get. Maximum number of result returned.

order - OrderBy object, contains information to do order

Returns:

a list of parameters

Throws:

SParameterProcessNotFoundException - error thrown if no parameters configuration file found in file system

SOutOfBoundException - error throw if fromIndex >= total size of parameters

SBonitaReadException

containsNullValues

boolean containsNullValues(long processDefinitionId)
                    throws SBonitaReadException

Check if the specific process contains null-valued parameter or not.

Parameters:

processDefinitionId - The ID of the process definition

Returns:

true if at least one parameter contains a null value, false otherwise.

Throws:

SParameterProcessNotFoundException

SBonitaReadException