GVConnectorConfiguration

From GreenVulcano Wiki
Revision as of 10:05, 7 February 2012 by Anonymous (talk) (EncryptExtension)
Jump to: navigation, search

Description

This Adapter represents the GreenVulcano® ESB client API configuration.

VulCon / GV Console Configuration

Configuration is made up of three sections:

  • ConnectorServices: Contains information to identify the communication channel, according to the couple service/system or only to the service.
    Moreover, for each primitive (request, request/reply, etc.), this section declares also the extensions to invoke. For services not covered by the parameters defined in this section is used the default channel, without applying any extension.
  • Extensions: Extensions are pre/post processing data that can be made by the connector immediately before invoking GreenVulcano® ESB and/or immediately before returning the result to the caller.
  • Channels: This section defines the connection parameters to GreenVulcano® ESB. Typically there is a single channel of communication to all GreenVulcano® ESB services required by the client. However, for special needs, you can define several channels for different services.


The following table shows the GVConnectorConfiguration's attributes:

Attribute Type Description
type fixed This attribute must assume the value module
name fixed This attribute must assume the value GV_CONNECTOR_J


The GVConnectorConfiguration adapter allows the following subelements:

ConnectorServices

Configuration details for services and calls.

The ConnectorServices Element is used by GVConnectorConfiguration.

It has the subelements:

  • Description
  • ConnectorService
  • Call

ConnectorService

Service configuration details.

The ConnectorService Element is used by: ConnectorServices.

The following table show the element's attributes ConnectorService:

Attribute Type Description
id-service required Service identifier. The attribute's value can't be null.
id-channel optional Channel for this service. If not defined a default channel is used.
id-system optional System identifier. If defined, you apply the parameters to the couple system/service, otherwise the parameters apply to service, independently from the value of the field System.

It has the subelements:

  • Description
  • OperationDetails
OperationDetails

Specific operation detail.

The OperationDetails Element is used by ConnectorService.

The following table show the element's attributes OperationDetails:

Attribute Type Description
id-operation required Operation id. The attribute's admitted values are:
  • Request
  • RequestReply
  • GetReply
  • GetRequest
  • SendReply
  • ReceiveMessage
  • SendMessage
id-extension optional Extension applied to the invocation of the operation.

Extensions

Definition of Extensions.

Extensions are pre / post processing of data that can be made automatically from the connector before invoking GreenVulcano® ESB and/or before returning the result to the caller.

The Extensions Element is used by GVConnectorConfiguration.

It has the subelements:

ComplexExtension

Allows you to combine with several extensions.

Moreover for any extension you can define when it has to be applied (IN, OUT or INOUT). The output extensions are applied inversely to the declaration order.

The ComplexExtension Element is used by Extensions.

The following table show the element's attributes ComplexExtension:

Attribute Type Description
type fixed Unmodifiable. Used by GreenVulcano® ESB factory framework.
This attribute must assume the value extension.
class fixed This attribute must assume the value it.greenvulcano.gvesb.connector.extensions.ComplexExtension.
id-ext required The attribute's value can't be null.

It has the subelements:

TestExtension

Test extension used only to debug the connector

The TestExtension Element is used by Extensions.

The following table show the element's attributes TestExtension:

Attribute Type Description
type fixed Unmodifiable. Used by GreenVulcano® ESB factory framework.
This attribute must assume the value extension.
class fixed This attribute must assume the value tests.unit.gvconnector.ExtensionTestClass.
id-ext required The attribute's value can't be null.
when optional The attribute's default value is: inout. The attribute's admitted values are:
  • in
  • out
  • inout
prefix optional
suffix optional


CompressExtension

Extension for the "GVBuffer object" data compression

The CompressExtension Element is used by: Extensions.

The following table show the element's attributes CompressExtension:

Attribute Type Description
type fixed This attribute must assume the value extension.
class fixed This attribute must assume the value it.greenvulcano.gvesb.connector.extensions.CompressExtension.
id-ext required Unique identifier of the extension.
when optional Defines when you must apply the extension. Only input, only output or both input and output. The attribute's admitted values are:
  • in
  • out
  • inout (Default value)
compress-level required Defines the compression level to be applied: best-compression, best-speed (fastest compression), default-compression (default), no-compression.

DecompressExtension

Extension decompressing data in GVBuffer object.

The DecompressExtension Element is used by: Extensions.

The following table show the element's attributes DecompressExtension:

Attribute Type Description
type fixed This attribute must assume the value extension.
class fixed This attribute must assume the value it.greenvulcano.gvesb.connector.extensions.DecompressExtension.
id-ext required Unique identifier of the extension.
when optional Defines when you must apply the extension. Only input, only output or both input and output. The attribute's admitted values are:
  • in
  • out
  • inout (Default value)

DecryptExtension

Extension that carries out the decryption of data in GVBuffer object.

The DecryptExtension Element is used by: Extensions.

The following table show the element's attributes DecryptExtension:

Attribute Type Description
type fixed This attribute must assume the value extension.
class fixed This attribute must assume the value it.greenvulcano.gvesb.connector.extensions.DecryptExtension.
id-ext required Unique identifier of the extension.
when optional Defines when you must apply the extension. Only input, only output or both input and output. The attribute's admitted values are:
  • in
  • out
  • inout (Default value)
key-id optional Sets the key to use for decryption.

EncryptExtension

Extension that makes the encryption of data in GVBuffer object.

The EncryptExtension Element is used by: Extensions.

The following table show the element's attributes EncryptExtension:

Attribute Type Description
type fixed This attribute must assume the value extension.
class fixed This attribute must assume the value it.greenvulcano.gvesb.connector.extensions.EncryptExtension.
id-ext required Unique identifier of the extension.
when optional Defines when you must apply the extension. Only input, only output or both input and output. The attribute's admitted values are:
  • in
  • out
  • inout (Default value)
key-id optional Sets the key to use for decryption.

DTEExtension

Extension that performs the data transformation through the DTE.

The DTEExtension Element is used by: Extensions.

The following table show the element's attributes DTEExtension:

Attribute Type Description
type fixed This attribute must assume the value extension.
class fixed This attribute must assume the value it.greenvulcano.gvesb.connector.extensions.DTEExtension.
id-ext required Unique identifier of the extension.
when optional Defines when you must apply the extension. Only input, only output or both input and output. The attribute's admitted values are:
  • in
  • out
  • inout (Default value)
trasformationName optional Name of the transformation to be invoked. If this parameter is not valued, the following algorithm is used to create the name of the transformation: SISTEM:SERVICE::Input or :Output

Can contain the following subelements:

  • Description
  • Property-Field
Property-Field

The elements Property-Field represent the parameters to be added to DTEExtension.

The following table show the element's attributes Property-Field:

Attribute Type Description
name required The attribute's value can't be null.
value required