Difference between revisions of "GVConnectorConfiguration"

From GreenVulcano Wiki
Jump to: navigation, search
(DecompressExtension)
(NameValueParam)
 
(22 intermediate revisions by the same user not shown)
Line 1: Line 1:
 +
[[File:GVConnectorConfiguration.jpg|thumb|GVConnectorConfiguration with {{VULCON}}]]
 
==Description==
 
==Description==
  
Line 7: Line 8:
 
Configuration is made up of three sections:
 
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]]. <br/> 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.
+
* ''[[#ConnectorServices|ConnectorServices]]'': Contains information to identify the communication channel, according to the couple [[service]]/[[system]] or only to the [[service]]. <br/> 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 {{GVESB}} and/or immediately before returning the result to the caller.
+
* ''[[#Extensions|Extensions]]'': Extensions are pre/post processing data that can be made by the connector immediately before invoking {{GVESB}} and/or immediately before returning the result to the caller.
  
* ''Channels'': This section defines the connection parameters to {{GVESB}}. Typically there is a single channel of communication to all {{GVESB}} services required by the client.  However, for special needs, you can define several channels for different services.
+
* ''[[#Channels|Channels]]'': This section defines the connection parameters to {{GVESB}}. Typically there is a single channel of communication to all {{GVESB}} services required by the client.  However, for special needs, you can define several channels for different services.
  
  
Line 25: Line 26:
  
 
The GVConnectorConfiguration adapter allows the following subelements:
 
The GVConnectorConfiguration adapter allows the following subelements:
* Description
+
* [[Description]]
* ConnectorServices
+
* [[#ConnectorServices|ConnectorServices]]
 
* [[GVConnectorConfiguration#Extensions|Extensions]]
 
* [[GVConnectorConfiguration#Extensions|Extensions]]
* [[Channels]]
+
* [[GVConnectorConfiguration#Channels|Channels]]
* [[Transactions]]
+
* [[GVConnectorConfiguration#Transactions|Transactions]]
* [[ExternalComponents]]
+
* [[GVConnectorConfiguration#ExternalComponents|ExternalComponents]]
  
 
===ConnectorServices===
 
===ConnectorServices===
Line 39: Line 40:
  
 
It has the subelements:
 
It has the subelements:
* Description
+
* [[Description]]
* ConnectorService
+
* [[#ConnectorService|ConnectorService]]
* Call
+
* [[#Call|Call]]
  
 
====ConnectorService====
 
====ConnectorService====
Line 49: Line 50:
 
The ConnectorService Element is used by: ConnectorServices.
 
The ConnectorService Element is used by: ConnectorServices.
  
The following table show the element's attributes ConnectorService:
+
The following table shows the element's attributes ConnectorService:
 
{|class="gvtable"
 
{|class="gvtable"
 
! Attribute !! Type !! Description
 
! Attribute !! Type !! Description
Line 61: Line 62:
  
 
It has the subelements:
 
It has the subelements:
* Description
+
* [[Description]]
* OperationDetails
+
* [[#OperationDetails|OperationDetails]]
  
 
=====OperationDetails=====
 
=====OperationDetails=====
Line 70: Line 71:
 
The OperationDetails Element is used by '''ConnectorService'''.
 
The OperationDetails Element is used by '''ConnectorService'''.
  
The following table show the element's attributes OperationDetails:
+
The following table shows the element's attributes OperationDetails:
 
{|class="gvtable"
 
{|class="gvtable"
 
! Attribute !! Type !! Description
 
! Attribute !! Type !! Description
Line 85: Line 86:
 
| id-extension || optional || Extension applied to the invocation of the operation.
 
| id-extension || optional || Extension applied to the invocation of the operation.
 
|}
 
|}
 +
 +
====Call====
 +
 +
Call configuration details.
 +
 +
The following table shows the Call element's attributes:
 +
{|class="gvtable"
 +
! Attribute !! Type !! Description
 +
|-
 +
| id-service || required || Service identifier.
 +
The attribute's value can't be null.
 +
|-
 +
| 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.
 +
|-
 +
| target-service || optional ||  If defined it is the real service to be invoked on {{GVESB}}.
 +
In this way you can configure multiple "Call" with different names and behaviors (use or not of the transaction and primitive to be invoked) to the same {{GVESB}} service.
 +
As Output you will still have the id-service given in input.
 +
|-
 +
| id-operation || required || Id of the primitive to invoke
 +
The attribute's admitted values are:
 +
* Request
 +
* RequestReply
 +
* GetReply
 +
* GetRequest
 +
* SendReply
 +
* ReceiveMessage
 +
* SendMessage
 +
* Request-GetReply
 +
* SendMessage-ReceiveMessage
 +
The attribute's value can't be null.
 +
|-
 +
| use-transaction || required || Specifies whether the Call is to be made in transaction.
 +
The attribute's admitted values are:
 +
* FALSE
 +
* TRUE
 +
The attribute's value can't be null.
 +
|-
 +
| id-transaction || optional || Transaction id.
 +
If the attribute 'use-transaction' is 'TRUE' and it is not evaluated the transaction-id, it will use the default transaction.
 +
The attribute's value can't be null.
 +
|}
 +
 +
Might contain the sub-element [[Description]].
  
 
===Extensions===
 
===Extensions===
Line 90: Line 134:
 
Definition of Extensions.
 
Definition of Extensions.
  
Extensions are pre / post processing of data that can be made automatically from the connector
+
Extensions are pre/post processing of data that can be made automatically from the connector
 
before invoking {{GVESB}} and/or before returning the result to the caller.
 
before invoking {{GVESB}} and/or before returning the result to the caller.
  
Line 97: Line 141:
 
It has the subelements:
 
It has the subelements:
 
* Description
 
* Description
* [[GVConnectorConfiguration#ComplexExtension|ComplexExtension]] | [[GVConnectorConfiguration#TestExtension|TestExtension]] | [[CompressExtension]] | [[DecompressExtension]] | [[DecryptExtension]] | [[EncryptExtension]] | [[DTEExtension]]
+
* [[GVConnectorConfiguration#ComplexExtension|ComplexExtension]] | [[GVConnectorConfiguration#TestExtension|TestExtension]] | [[GVConnectorConfiguration#CompressExtension|CompressExtension]] | [[GVConnectorConfiguration#DecompressExtension|DecompressExtension]] | [[GVConnectorConfiguration#DecryptExtension|DecryptExtension]] | [[GVConnectorConfiguration#EncryptExtension|EncryptExtension]] | [[GVConnectorConfiguration#DTEExtension|DTEExtension]]
  
 
====ComplexExtension====
 
====ComplexExtension====
Line 107: Line 151:
 
The ComplexExtension Element is used by '''Extensions'''.
 
The ComplexExtension Element is used by '''Extensions'''.
  
The following table show the element's attributes ComplexExtension:
+
The following table shows the element's attributes ComplexExtension:
 
{|class="gvtable"
 
{|class="gvtable"
 
! Attribute !! Type !! Description
 
! Attribute !! Type !! Description
Line 119: Line 163:
  
 
It has the subelements:
 
It has the subelements:
* Description
+
* [[Description]]
* [[Extension]]
+
* [[#Extension|Extension]]
 +
 
 +
=====Extension=====
 +
 
 +
Extension to apply.
 +
 
 +
The Extension Element is used by: ComplexExtension.
 +
 
 +
The following table shows the element's attributes Extension:
 +
{|class="gvtable"
 +
! Attribute !! Type !! Description
 +
|-
 +
| id-ext || required || Extension to apply.
 +
|-
 +
| apply || required || Indicates when an extension has to be applied.
 +
* IN: The extension is applied before invoking {{GVESB}}
 +
* OUT: The extension is applied before returning the result to the caller
 +
* INOUT: The extension is applied before invoking {{GVESB}} and before returning the result to the caller.
 +
The output extensions are applied inversely to the declaration order.
 +
|}
  
 
====TestExtension====
 
====TestExtension====
Line 128: Line 191:
 
The TestExtension Element is used by '''Extensions'''.
 
The TestExtension Element is used by '''Extensions'''.
  
The following table show the element's attributes TestExtension:
+
The following table shows the element's attributes TestExtension:
 
{|class="gvtable"
 
{|class="gvtable"
 
! Attribute !! Type !! Description
 
! Attribute !! Type !! Description
Line 155: Line 218:
 
The CompressExtension Element is used by: '''Extensions'''.
 
The CompressExtension Element is used by: '''Extensions'''.
  
The following table show the element's attributes CompressExtension:
+
The following table shows the element's attributes CompressExtension:
 
{|class="gvtable"
 
{|class="gvtable"
 
! Attribute !! Type !! Description
 
! Attribute !! Type !! Description
Line 179: Line 242:
 
The DecompressExtension Element is used by: '''Extensions'''.
 
The DecompressExtension Element is used by: '''Extensions'''.
  
The following table show the element's attributes DecompressExtension:
+
The following table shows the element's attributes DecompressExtension:
 
{|class="gvtable"
 
{|class="gvtable"
 
! Attribute !! Type !! Description
 
! Attribute !! Type !! Description
Line 201: Line 264:
 
The DecryptExtension Element is used by: '''Extensions'''.
 
The DecryptExtension Element is used by: '''Extensions'''.
  
The following table show the element's attributes DecryptExtension:
+
The following table shows the element's attributes DecryptExtension:
 
{|class="gvtable"
 
{|class="gvtable"
 
! Attribute !! Type !! Description
 
! Attribute !! Type !! Description
Line 217: Line 280:
 
|-
 
|-
 
| key-id || optional || Sets the key to use for decryption.
 
| 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 shows the element's attributes EncryptExtension:
 +
{|class="gvtable"
 +
! 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 shows the element's attributes DTEExtension:
 +
{|class="gvtable"
 +
! 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]]
 +
 +
=====Property-Field=====
 +
 +
The elements Property-Field represent the parameters to be added to '''DTEExtension'''.
 +
 +
The following table shows the element's attributes Property-Field:
 +
{|class="gvtable"
 +
! Attribute !! Type !! Description
 +
|-
 +
| name || required || The attribute's value can't be null.
 +
|-
 +
| value || required ||
 +
|}
 +
 +
===Channels===
 +
 +
Communication channels.
 +
 +
Typically you define a single [[channel]] for all [[Service | services]] and set this channel as the default. However, you can define more than one channel for special needs.
 +
 +
The Channels Element is used by: '''GVConnectorConfiguration'''.
 +
 +
The following table shows the element's attributes Channels:
 +
{|class="gvtable"
 +
! Attribute !! Type !! Description
 +
|-
 +
| default-channel-id || optional || If not defined, sets to "default"
 +
|}
 +
 +
Its subelements are:
 +
* [[Description]]
 +
* [[#VCLChannel|VCLChannel]] | [[#GreenVulcanoCoreChannel|GreenVulcanoCoreChannel]]
 +
 +
====VCLChannel====
 +
 +
Communication Channel based on {{GVESB}} Virtual Communication Layer.
 +
 +
The VCLChannel Element is used by: '''Channels'''.
 +
 +
The following table shows the VCLChannel element's attributes:
 +
{|class="gvtable"
 +
! Attribute !! Type !! Description
 +
|-
 +
| type || fixed || This attribute must assume the value '''channel'''.
 +
|-
 +
| class || fixed || it.greenvulcano.gvesb.connector.channels.gvvcl.VCLChannel.
 +
|-
 +
| id-channel || required || Unique identifier of the channel.
 +
|-
 +
| connection-policy || required || Defines the connection policy of the channel:
 +
* Lazy: The channel is created and connected the first time that it needs.
 +
* Startup: The channel is created and connected at startup of the connector.
 +
* Everytime: The channel is connected every time you use it, and disconnected immediately after use.
 +
|}
 +
 +
It has the following subelements:
 +
* [[Description]]
 +
* [[#VCLOperation|VCLOperation]]
 +
 +
=====VCLOperation=====
 +
 +
Defines the Virtual Communication Layer plug-in used for a specific communication primitive.
 +
 +
The VCLOperation Element is used by: VCLChannel.
 +
 +
The following table shows the element's attributes VCLOperation:
 +
{|class="gvtable"
 +
! Attribute !! Type !! Description
 +
|-
 +
| id-operation || required || Communication primitive. The attribute's admitted values are:
 +
* Request
 +
* RequestReply
 +
* GetReply
 +
* GetRequest
 +
* SendReply
 +
* ReceiveMessage
 +
* SendMessage
 +
|}
 +
 +
Might contain the following sub-elements:
 +
* [[Description]]
 +
* ([[j2ee-ejb-call]] | [[j2ee-jca-call]] | [[jmx-call]] | [[smtp-call]] | [[pop-call]] |[[ ws-call]] | [[http-call]] | [[hl7-call]] | [[jbpm-call]] | [[jbpm-task-call]] | [[openspcoop-call]] | [[db-call]] | [[dh-call]] | [[ldap-search-call]] | [[ldap-update-call]] | [[extract-data-call]] | [[routed-call]] | [[excel-call]] | [[excelreader-call]] | [[birt-report-call]] | [[rules-call]] | [[test-service-call]] | [[generic-call]] | [[shell-call]] | [[filereader-call]] | [[filewriter-call]] | [[filemanager-call]] | [[fsmonitor-call]] | [[remotemanager-call]] | [[rsh-call]] | [[rsh-filereader-call]] | [[rsh-filewriter-call]] | [[mm7-decode-call]] | [[mm7-submit-call]] | [[jms-dequeue]] | [[routed-dequeue]] | [[jms-enqueue]] | [[routed-enqueue]])
 +
 +
====GreenVulcanoCoreChannel====
 +
 +
Communication Channel based on the {{GVESB}} Core.
 +
 +
The GreenVulcanoCoreChannel Element is used by: '''Channels'''.
 +
 +
The following table shows the element's attributes GreenVulcanoCoreChannel:
 +
{|class="gvtable"
 +
! Attribute !! Type !! Description
 +
|-
 +
| type || fixed || This attribute must assume the value '''channel'''.
 +
|-
 +
| class || fixed || it.greenvulcano.gvesb.connector.channels.gvcore.GreenVulcanoCoreChannel.
 +
|-
 +
| id-channel || required || Unique identifier of the channel.
 +
|-
 +
| connection-policy || required || Defines the connection policy of the channel:
 +
* Lazy: The channel is created and connected the first time that it needs.
 +
* Startup: The channel is created and connected at startup of the connector.
 +
* Everytime: The channel is connected every time you use it, and disconnected immediately after use.
 +
|}
 +
 +
===Transactions===
 +
 +
The connector is able to explicitly manage transactions. It will use the User Transactions defined in this section.
 +
 +
The Transactions Element is used by: '''GVConnectorConfiguration'''.
 +
 +
The following table shows the element's attributes Transactions:
 +
{|class="gvtable"
 +
! Attribute !! Type !! Description
 +
|-
 +
| default-transaction-id || optional  If not defined, sets the value to "default"
 +
|}
 +
 +
Its subelements are:
 +
* [[Description]]
 +
* [[#UserTransaction|UserTransaction]] | [[#GenericTransaction|GenericTransaction]]
 +
 +
====UserTransaction====
 +
 +
Performs transaction management using the UserTransaction according to the JTA specification.
 +
 +
The UserTransaction Element is used by: '''Transactions'''.
 +
 +
The following table shows the element's attributes UserTransaction:
 +
{|class="gvtable"
 +
! Attribute !! Type !! Description
 +
|-
 +
| type || fixed || This attribute must assume the value transaction.
 +
|-
 +
| class || fixed || This attribute must assume the value '''it.greenvulcano.gvesb.connector.transaction.GVCUserTransaction'''.
 +
|-
 +
| id-transaction || required || Unique id of the UserTransaction.
 +
|}
 +
 +
Its subelements are:
 +
* [[Description]]
 +
* [[JNDIHelper]]
 +
 +
====GenericTransaction====
 +
 +
This element performs transaction management using a user defined Transaction implementation.
 +
 +
The GenericTransaction Element is used by: '''Transactions'''.
 +
 +
The following table shows the element's attributes GenericTransaction:
 +
{|class="gvtable"
 +
! Attribute !! Type !! Description
 +
|-
 +
| type || fixed || This attribute must assume the value '''transaction'''.
 +
|-
 +
| class || required || The Java class that implements the UserTransaction.
 +
|-
 +
| id-transaction || required || Unique id of the GenericTransaction.
 +
|}
 +
 +
Its subelements are:
 +
* [[Description]]
 +
* [[#NameValueParam|NameValueParam]]
 +
 +
=====NameValueParam=====
 +
This element allows parameter initialization.
 +
 +
The NameValueParam Element is used by: '''GenericTransaction'''.
 +
 +
The following table shows the element's attributes NameValueParam:
 +
{|class="gvtable"
 +
! Attribute !! Type !! Description
 +
|-
 +
| name || required || Parameter name.
 +
The attribute's value cannot be null.
 +
|-
 +
| value || required || Parameter value.
 +
The attribute's value cannot be null.
 +
|}
 +
 +
===ExternalComponents===
 +
 +
This section contains information relating to components outside of the Connector.
 +
 +
The ExternalComponents Element is used by: '''GVConnectorConfiguration'''.
 +
 +
Contains the following subelements:
 +
* [[Description]]
 +
* [[#External-Component|External-Component]]
 +
 +
====External-Component====
 +
 +
The External-Component Element is used by: ExternalComponents.
 +
 +
The following table shows the element's attributes External-Component:
 +
{|class="gvtable"
 +
! Attribute !! Type !! Description
 +
|-
 +
| type || fixed || This attribute must assume the value '''externalcomponent'''.
 +
|-
 +
| id-extcomponent || required || Unique identifier of the external component.
 +
|}
 +
 +
Contains the subelements:
 +
* [[Description]]
 +
* [[#External-Params|External-Params]]
 +
 +
=====External-Params=====
 +
 +
This element defines additional parameters.
 +
 +
The External-Params Element is used by: '''External-Component'''.
 +
 +
The following table shows the element's attributes External-Params:
 +
{|class="gvtable"
 +
! Attribute !! Type !! Description
 +
|-
 +
| name || required || The attribute's value can't be null.
 +
|-
 +
| value || required ||
 
|}
 
|}

Latest revision as of 14:15, 12 November 2012

GVConnectorConfiguration with VulCon

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:

ConnectorService

Service configuration details.

The ConnectorService Element is used by: ConnectorServices.

The following table shows 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:

OperationDetails

Specific operation detail.

The OperationDetails Element is used by ConnectorService.

The following table shows 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.

Call

Call configuration details.

The following table shows the Call element's attributes:

Attribute Type Description
id-service required Service identifier.

The attribute's value can't be null.

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.
target-service optional If defined it is the real service to be invoked on GreenVulcano® ESB.

In this way you can configure multiple "Call" with different names and behaviors (use or not of the transaction and primitive to be invoked) to the same GreenVulcano® ESB service. As Output you will still have the id-service given in input.

id-operation required Id of the primitive to invoke

The attribute's admitted values are:

  • Request
  • RequestReply
  • GetReply
  • GetRequest
  • SendReply
  • ReceiveMessage
  • SendMessage
  • Request-GetReply
  • SendMessage-ReceiveMessage

The attribute's value can't be null.

use-transaction required Specifies whether the Call is to be made in transaction.

The attribute's admitted values are:

  • FALSE
  • TRUE

The attribute's value can't be null.

id-transaction optional Transaction id.

If the attribute 'use-transaction' is 'TRUE' and it is not evaluated the transaction-id, it will use the default transaction. The attribute's value can't be null.

Might contain the sub-element Description.

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 shows 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:

Extension

Extension to apply.

The Extension Element is used by: ComplexExtension.

The following table shows the element's attributes Extension:

Attribute Type Description
id-ext required Extension to apply.
apply required Indicates when an extension has to be applied.
  • IN: The extension is applied before invoking GreenVulcano® ESB
  • OUT: The extension is applied before returning the result to the caller
  • INOUT: The extension is applied before invoking GreenVulcano® ESB and before returning the result to the caller.

The output extensions are applied inversely to the declaration order.

TestExtension

Test extension used only to debug the connector

The TestExtension Element is used by Extensions.

The following table shows 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 shows 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 shows 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 shows 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 shows 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 shows 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:

Property-Field

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

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

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

Channels

Communication channels.

Typically you define a single channel for all services and set this channel as the default. However, you can define more than one channel for special needs.

The Channels Element is used by: GVConnectorConfiguration.

The following table shows the element's attributes Channels:

Attribute Type Description
default-channel-id optional If not defined, sets to "default"

Its subelements are:

VCLChannel

Communication Channel based on GreenVulcano® ESB Virtual Communication Layer.

The VCLChannel Element is used by: Channels.

The following table shows the VCLChannel element's attributes:

Attribute Type Description
type fixed This attribute must assume the value channel.
class fixed it.greenvulcano.gvesb.connector.channels.gvvcl.VCLChannel.
id-channel required Unique identifier of the channel.
connection-policy required Defines the connection policy of the channel:
  • Lazy: The channel is created and connected the first time that it needs.
  • Startup: The channel is created and connected at startup of the connector.
  • Everytime: The channel is connected every time you use it, and disconnected immediately after use.

It has the following subelements:

VCLOperation

Defines the Virtual Communication Layer plug-in used for a specific communication primitive.

The VCLOperation Element is used by: VCLChannel.

The following table shows the element's attributes VCLOperation:

Attribute Type Description
id-operation required Communication primitive. The attribute's admitted values are:
  • Request
  • RequestReply
  • GetReply
  • GetRequest
  • SendReply
  • ReceiveMessage
  • SendMessage

Might contain the following sub-elements:

GreenVulcanoCoreChannel

Communication Channel based on the GreenVulcano® ESB Core.

The GreenVulcanoCoreChannel Element is used by: Channels.

The following table shows the element's attributes GreenVulcanoCoreChannel:

Attribute Type Description
type fixed This attribute must assume the value channel.
class fixed it.greenvulcano.gvesb.connector.channels.gvcore.GreenVulcanoCoreChannel.
id-channel required Unique identifier of the channel.
connection-policy required Defines the connection policy of the channel:
  • Lazy: The channel is created and connected the first time that it needs.
  • Startup: The channel is created and connected at startup of the connector.
  • Everytime: The channel is connected every time you use it, and disconnected immediately after use.

Transactions

The connector is able to explicitly manage transactions. It will use the User Transactions defined in this section.

The Transactions Element is used by: GVConnectorConfiguration.

The following table shows the element's attributes Transactions:

Attribute Type Description
default-transaction-id optional If not defined, sets the value to "default"

Its subelements are:

UserTransaction

Performs transaction management using the UserTransaction according to the JTA specification.

The UserTransaction Element is used by: Transactions.

The following table shows the element's attributes UserTransaction:

Attribute Type Description
type fixed This attribute must assume the value transaction.
class fixed This attribute must assume the value it.greenvulcano.gvesb.connector.transaction.GVCUserTransaction.
id-transaction required Unique id of the UserTransaction.

Its subelements are:

GenericTransaction

This element performs transaction management using a user defined Transaction implementation.

The GenericTransaction Element is used by: Transactions.

The following table shows the element's attributes GenericTransaction:

Attribute Type Description
type fixed This attribute must assume the value transaction.
class required The Java class that implements the UserTransaction.
id-transaction required Unique id of the GenericTransaction.

Its subelements are:

NameValueParam

This element allows parameter initialization.

The NameValueParam Element is used by: GenericTransaction.

The following table shows the element's attributes NameValueParam:

Attribute Type Description
name required Parameter name.

The attribute's value cannot be null.

value required Parameter value.

The attribute's value cannot be null.

ExternalComponents

This section contains information relating to components outside of the Connector.

The ExternalComponents Element is used by: GVConnectorConfiguration.

Contains the following subelements:

External-Component

The External-Component Element is used by: ExternalComponents.

The following table shows the element's attributes External-Component:

Attribute Type Description
type fixed This attribute must assume the value externalcomponent.
id-extcomponent required Unique identifier of the external component.

Contains the subelements:

External-Params

This element defines additional parameters.

The External-Params Element is used by: External-Component.

The following table shows the element's attributes External-Params:

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