org.bonitasoft.engine.core.connector

Interface ConnectorService

All Known Implementing Classes:

ConnectorServiceDecorator, ConnectorServiceImpl

public interface ConnectorService

Since:

6.0

Author:

Baptiste Mesta, Matthieu Chaffotte, Elias Ricken de Medeiros

Field Summary

Fields

Modifier and Type	Field and Description
static String	DONE
static String	FAILED
static String	SKIPPED
static String	TO_BE_EXECUTED
static String	TO_RE_EXECUTE

Method Summary

Modifier and Type	Method and Description
void	addConnectorImplementation(Long processDefinitionId, String name, byte[] content)
void	disconnect(ConnectorResult result)
Map<String,Object>	evaluateInputParameters(String connectorId, Map<String,SExpression> parameters, SExpressionContext sExpressionContext, Map<String,Map<String,Serializable>> inputValues)
ConnectorResult	executeConnector(long processDefinitionId, SConnectorInstance sConnectorInstance, SConnectorImplementationDescriptor connectorImplementationDescriptor, ClassLoader classLoader, Map<String,Object> inputParameters)
ConnectorResult	executeMultipleEvaluation(long processDefinitionId, String connectorDefinitionId, String connectorDefinitionVersion, Map<String,SExpression> connectorInputParameters, Map<String,Map<String,Serializable>> inputValues, ClassLoader classLoader, SExpressionContext sexpContext) Execute a connector instance by given connectorDefinitionId and connectorDefinitionVersion
void	executeOutputOperation(List<SOperation> outputs, SExpressionContext expressionContext, ConnectorResult result)
SConnectorImplementationDescriptor	getConnectorImplementation(long processDefinitionId, String connectorId, String connectorVersion) Get connector implementation descriptor for specified connector in a process definition.
SConnectorImplementationDescriptor	getConnectorImplementationDescriptor(long processDefinitionId, String connectorId, String version)
List<org.bonitasoft.engine.resources.SBARResource>	getConnectorImplementations(long processDefinitionId, int from, int numberOfElements)
List<SConnectorImplementationDescriptor>	getConnectorImplementations(long processDefinitionId, int fromIndex, int numberPerPage, String field, OrderByType order) Get a list of connector implementation descriptors for id specified process definition, the returned list is paginated
Long	getNumberOfConnectorImplementations(long processDefinitionId)
boolean	loadConnectors(SProcessDefinition sDefinition) Load connectors for given process definition and tenant, connectors will be stored in cache after loading
void	removeConnectorImplementations(long processDefinitionId)
void	setConnectorImplementation(SProcessDefinition sProcessDefinition, String connectorId, String connectorVersion, byte[] connectorImplementationArchive) Set connector implementation for id and version specified connector.

Field Detail

TO_BE_EXECUTED

static final String TO_BE_EXECUTED

See Also:

Constant Field Values

DONE

static final String DONE

See Also:

Constant Field Values

FAILED

static final String FAILED

See Also:

Constant Field Values

SKIPPED

static final String SKIPPED

See Also:

Constant Field Values

TO_RE_EXECUTE

static final String TO_RE_EXECUTE

See Also:

Constant Field Values

Method Detail

executeMultipleEvaluation

ConnectorResult executeMultipleEvaluation(long processDefinitionId,
                                          String connectorDefinitionId,
                                          String connectorDefinitionVersion,
                                          Map<String,SExpression> connectorInputParameters,
                                          Map<String,Map<String,Serializable>> inputValues,
                                          ClassLoader classLoader,
                                          SExpressionContext sexpContext)
                                   throws SConnectorException

Execute a connector instance by given connectorDefinitionId and connectorDefinitionVersion

Parameters:

processDefinitionId - The identifier of process definition

connectorDefinitionId - The identifier of connector definition

connectorDefinitionVersion - The version of connector definition

connectorInputParameters - The input of connector

inputValues - The input values of connector

classLoader - The class loader used to load and run connector

sexpContext - The expression context

Returns:

The output after connector executing

Throws:

SConnectorException - Error thrown if has exceptions during the connector executing

loadConnectors

boolean loadConnectors(SProcessDefinition sDefinition)
                throws SConnectorException

Load connectors for given process definition and tenant, connectors will be stored in cache after loading

Parameters:

sDefinition - The process definition

Returns:

true if all connectors found have all them dependencies resolved and are correctly loaded

Throws:

SConnectorException - Error thrown if has exceptions during the connector loading

setConnectorImplementation

void setConnectorImplementation(SProcessDefinition sProcessDefinition,
                                String connectorId,
                                String connectorVersion,
                                byte[] connectorImplementationArchive)
                         throws SConnectorException,
                                SInvalidConnectorImplementationException

Set connector implementation for id and version specified connector. Store all connector related files if they are not existed and replace the old implementation with the new one in file system. Delete former and load current connectors in cache.

Parameters:

sProcessDefinition - The process definition which the connector belongs to

connectorId - Id of connector definition.

connectorVersion - Version of connector definition

connectorImplementationArchive - zip byte array containing the connector implementation information

Throws:

SConnectorException - Error thrown if has exceptions during the connector implementation setting

SInvalidConnectorImplementationException

getConnectorImplementations

List<SConnectorImplementationDescriptor> getConnectorImplementations(long processDefinitionId,
                                                                     int fromIndex,
                                                                     int numberPerPage,
                                                                     String field,
                                                                     OrderByType order)
                                                              throws SConnectorException

Get a list of connector implementation descriptors for id specified process definition, the returned list is paginated

Parameters:

processDefinitionId - Identifier of process definition

fromIndex - Start index of connector record

numberPerPage - Number of connectors we want to get. Maximum number of connectors returned.

field - The field that the result ordered by

order - The order, ACS or DESC

Returns:

A list of all satisfied connector implementation descriptor objects

Throws:

SConnectorException - Error thrown if has exceptions during the connector implementations retrieve

getConnectorImplementation

SConnectorImplementationDescriptor getConnectorImplementation(long processDefinitionId,
                                                              String connectorId,
                                                              String connectorVersion)
                                                       throws SConnectorException

Get connector implementation descriptor for specified connector in a process definition.

Parameters:

processDefinitionId - Identifier of process definition

connectorId - id of connector definition

connectorVersion - version of connector definition

Returns:

connector implementation descriptor object

Throws:

SConnectorException - Error thrown if has exceptions during the connector implementation get

evaluateInputParameters

Map<String,Object> evaluateInputParameters(String connectorId,
                                           Map<String,SExpression> parameters,
                                           SExpressionContext sExpressionContext,
                                           Map<String,Map<String,Serializable>> inputValues)
                                    throws SExpressionTypeUnknownException,
                                           SExpressionEvaluationException,
                                           SExpressionDependencyMissingException,
                                           SInvalidExpressionException

Parameters:

parameters -

sExpressionContext -

inputValues -

Returns:

Throws:

SExpressionTypeUnknownException

SExpressionEvaluationException

SExpressionDependencyMissingException

SInvalidExpressionException

getConnectorImplementationDescriptor

SConnectorImplementationDescriptor getConnectorImplementationDescriptor(long processDefinitionId,
                                                                        String connectorId,
                                                                        String version)
                                                                 throws SConnectorException

Throws:

SConnectorException

executeOutputOperation

void executeOutputOperation(List<SOperation> outputs,
                            SExpressionContext expressionContext,
                            ConnectorResult result)
                     throws SConnectorException

Parameters:

outputs -

expressionContext -

result -

Throws:

SConnectorException

executeConnector

ConnectorResult executeConnector(long processDefinitionId,
                                 SConnectorInstance sConnectorInstance,
                                 SConnectorImplementationDescriptor connectorImplementationDescriptor,
                                 ClassLoader classLoader,
                                 Map<String,Object> inputParameters)
                          throws SConnectorException

Parameters:

processDefinitionId -

sConnectorInstance -

connectorImplementationDescriptor -

classLoader -

inputParameters -

Returns:

the result of the connector execution

Throws:

SConnectorException

disconnect

void disconnect(ConnectorResult result)
         throws SConnectorException

Parameters:

result -

Throws:

SConnectorException

getNumberOfConnectorImplementations

Long getNumberOfConnectorImplementations(long processDefinitionId)
                                  throws SConnectorException

Parameters:

processDefinitionId - the id of the process definition

Returns:

the number of connector implementation for this process definition

Throws:

SConnectorException

getConnectorImplementations

List<org.bonitasoft.engine.resources.SBARResource> getConnectorImplementations(long processDefinitionId,
                                                                               int from,
                                                                               int numberOfElements)
                                                                        throws SBonitaReadException

Throws:

SBonitaReadException

addConnectorImplementation

void addConnectorImplementation(Long processDefinitionId,
                                String name,
                                byte[] content)
                         throws SRecorderException

Throws:

SRecorderException

removeConnectorImplementations

void removeConnectorImplementations(long processDefinitionId)
                             throws SBonitaReadException,
                                    SRecorderException

Throws:

SBonitaReadException

SRecorderException