org.bonitasoft.engine.connector

Class ConnectorServiceDecorator

java.lang.Object

org.bonitasoft.engine.connector.ConnectorServiceDecorator

All Implemented Interfaces:

ConnectorService

public class ConnectorServiceDecorator
extends Object
implements ConnectorService

This service wraps the connector service and add engine variables like apiAccessor, engineExecutionContext.

Author:

Matthieu Chaffotte, Elias Ricken de Medeiros, Celine Souchet

Field Summary

Fields inherited from interface org.bonitasoft.engine.core.connector.ConnectorService

DONE, FAILED, SKIPPED, TO_BE_EXECUTED, TO_RE_EXECUTE

Constructor Summary

Constructors

Constructor and Description
ConnectorServiceDecorator(ConnectorService connectorService)

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 connectorOutput)
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.

Methods inherited from class java.lang.Object

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

Constructor Detail

ConnectorServiceDecorator

public ConnectorServiceDecorator(ConnectorService connectorService)

Method Detail

executeMultipleEvaluation

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

Description copied from interface: ConnectorService

Execute a connector instance by given connectorDefinitionId and connectorDefinitionVersion

Specified by:

executeMultipleEvaluation in interface ConnectorService

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

public boolean loadConnectors(SProcessDefinition sDefinition)
                       throws SConnectorException

Description copied from interface: ConnectorService

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

Specified by:

loadConnectors in interface ConnectorService

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

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

Description copied from interface: ConnectorService

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.

Specified by:

setConnectorImplementation in interface ConnectorService

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

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

Description copied from interface: ConnectorService

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

Specified by:

getConnectorImplementations in interface ConnectorService

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

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

Description copied from interface: ConnectorService

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

Specified by:

getConnectorImplementation in interface ConnectorService

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

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

Specified by:

evaluateInputParameters in interface ConnectorService

Returns:

Throws:

SExpressionTypeUnknownException

SExpressionEvaluationException

SExpressionDependencyMissingException

SInvalidExpressionException

executeOutputOperation

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

Specified by:

executeOutputOperation in interface ConnectorService

Throws:

SConnectorException

executeConnector

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

Specified by:

executeConnector in interface ConnectorService

Returns:

the result of the connector execution

Throws:

SConnectorException

disconnect

public void disconnect(ConnectorResult result)
                throws SConnectorException

Specified by:

disconnect in interface ConnectorService

Throws:

SConnectorException

getNumberOfConnectorImplementations

public Long getNumberOfConnectorImplementations(long processDefinitionId)
                                         throws SConnectorException

Specified by:

getNumberOfConnectorImplementations in interface ConnectorService

Parameters:

processDefinitionId - the id of the process definition

Returns:

the number of connector implementation for this process definition

Throws:

SConnectorException

getConnectorImplementations

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

Specified by:

getConnectorImplementations in interface ConnectorService

Throws:

SBonitaReadException

addConnectorImplementation

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

Specified by:

addConnectorImplementation in interface ConnectorService

Throws:

SRecorderException

removeConnectorImplementations

public void removeConnectorImplementations(long processDefinitionId)
                                    throws SBonitaReadException,
                                           SRecorderException

Specified by:

removeConnectorImplementations in interface ConnectorService

Throws:

SBonitaReadException

SRecorderException

getConnectorImplementationDescriptor

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

Specified by:

getConnectorImplementationDescriptor in interface ConnectorService

Throws:

SConnectorException