Difference between revisions of "Http-call"

From GreenVulcano Wiki
Jump to: navigation, search
(CustomProtocol)
(endpoint)
 
(8 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
==Description==
 
==Description==
  
This {{GVESB}} element is the HTTP VCL plugin to call HTTP methods on remote servers.
+
The {{GVESB}} http-call [[plugins | plug-in]] allows the data exchange through the [http://en.wikipedia.org/wiki/Hypertext_Transfer_Protocol HTTP protocol].  
  
 
=={{VULCON}} / {{GVCONSOLE}} Configuration==
 
=={{VULCON}} / {{GVCONSOLE}} Configuration==
 +
 +
Use the HTTP [[Plugins|VCL plugin]] if you want to call HTTP methods on remote servers.
  
 
The http-call Element is used by: [[Channel]] and [[routed-call]]. Its attributes are:
 
The http-call Element is used by: [[Channel]] and [[routed-call]]. Its attributes are:
Line 16: Line 18:
 
|}
 
|}
  
Might contain the following subelements:
+
Might contain the following sub-elements:
* Description
+
* [[Description]]
 
* [[Http-call#endpoint|endpoint]]
 
* [[Http-call#endpoint|endpoint]]
 
* [[Http-call#method|method]]
 
* [[Http-call#method|method]]
Line 35: Line 37:
 
| secure || optional || Defines if the endpoint connection is secure or not. If secure is 'true', the default connection protocol will be 'http'; otherwise, the default connection protocol will be 'https'. The default value is 'false'.
 
| secure || optional || Defines if the endpoint connection is secure or not. If secure is 'true', the default connection protocol will be 'http'; otherwise, the default connection protocol will be 'https'. The default value is 'false'.
 
|-
 
|-
| custom-protocol || optional || Can be one of those defined locally for this 'http-call', or globally in {{GVESB}} on GVSupport configuration.
+
| custom-protocol || optional || Can be one of those defined locally for this 'http-call', or globally in {{GVESB}} on [[GVSupport]] configuration.
 
|}
 
|}
 +
 +
<div class="version_ge3.4/3.3.4">
 +
{|class="gvtable"
 +
! Attribute !! Type !! Description
 +
|-
 +
| conn-timeout || optional || Defines the connection timeout, in ms. Default to 10000ms.
 +
|-
 +
| so-timeout || optional || Defines the timeout to wait for a server response, in ms. Default to 30000ms.
 +
|}
 +
</div>
 +
<div class="version_ge3.4">
 +
{|class="gvtable"
 +
! Attribute !! Type !! Description
 +
|-
 +
| context-path || optional || Optional context path to prepend to remote URI call.
 +
|}
 +
</div>
 +
  
 
It has the subelements:
 
It has the subelements:
* Description
+
* [[Description]]
* CustomProtocol
+
* [[#CustomProtocol|CustomProtocol]]
 
* [[Proxy]]
 
* [[Proxy]]
 +
<div class="version_ge3.4">
 +
* [[BasicHttpAuth]]
 +
* [[NTLMHttpAuth]]
 +
</div>
  
 
====CustomProtocol====
 
====CustomProtocol====
Line 55: Line 79:
 
| protocol-scheme || required || The URI protocol scheme (http, https, etc.).
 
| protocol-scheme || required || The URI protocol scheme (http, https, etc.).
 
|-
 
|-
| protocol-socket-factory || required || The custom socket factory class, implementation of class ''org.apache.commons.httpclient.protocol.ProtocolSocketFactory''. <br/> If this class do not have a default constructor, you can specify constructor arguments using ''constructor-args'' element.
+
| protocol-socket-factory || required || The custom socket factory class, implementation of class ''org.apache.commons.httpclient.protocol.ProtocolSocketFactory''. <br/> If this class do not have a default constructor, you can specify constructor arguments using ''[[#constructor-args|constructor-args]]'' element.
 
|-
 
|-
 
| protocol-default-port || required || The default port number for this custom protocol.
 
| protocol-default-port || required || The default port number for this custom protocol.
Line 63: Line 87:
  
 
Its subelements are:
 
Its subelements are:
* Description
+
* [[Description]]
* constructor-args: containing more '''constructor-param''' items where you can specify the constructor arguments, if your protocol socket factory class does not have a default constructor.
+
* [[#constructor-args|constructor-args]]
  
=====constructor-param=====
+
=====constructor-args=====
 +
 
 +
Contains more ''[[#constructor-param|constructor-param]]'' items where you can specify the constructor arguments, if your protocol socket factory class does not have a default constructor.
 +
 
 +
======constructor-param======
  
 
The constructor-param Element is a constructor parameter. It has the attributes:
 
The constructor-param Element is a constructor parameter. It has the attributes:
Line 90: Line 118:
 
===method===
 
===method===
  
Method to execute to the server. It is used by: http-call.
+
Method to invoke on the server.
  
 
Its attributes are:
 
Its attributes are:
Line 106: Line 134:
 
| request-uri || required || Request URI. Can contain [[placeholders]].
 
| request-uri || required || Request URI. Can contain [[placeholders]].
 
|-
 
|-
| ref-dp || optional || Name of [[Data Provider]] to use to prepare the request.
+
| ref-dp || optional || Name of [[Data provider]] to use to prepare the request.
 +
|}
 +
 
 +
<div class="version_ge3.3.3">
 +
{|class="gvtable"
 +
! Attribute !! Type !! Description
 +
|-
 +
| uri-escaped || optional || If true the request-uri is already escaped, if false (WARNING!!!) the uri is escaped by the plug-in.
 +
Default to true.
 
|}
 
|}
 +
</div>

Latest revision as of 11:04, 31 December 2014

Description

The GreenVulcano® ESB http-call plug-in allows the data exchange through the HTTP protocol.

VulCon / GV Console Configuration

Use the HTTP VCL plugin if you want to call HTTP methods on remote servers.

The http-call Element is used by: Channel and routed-call. Its attributes are:

Attribute Type Description
type fixed This attribute must assume the value call.
class fixed This attribute must assume the value it.greenvulcano.gvesb.virtual.http.HTTPCallOperation.
name required Operation name. Used in the Flow section to associate workflow nodes to VCL operations.

Might contain the following sub-elements:

endpoint

Endpoint configuration to connect to the server.

The endpoint Element is used by: http-call. Its attributes are:

Attribute Type Description
host required Host to connect to.
port optional Port where the service is exposed. Default port is '80'.
secure optional Defines if the endpoint connection is secure or not. If secure is 'true', the default connection protocol will be 'http'; otherwise, the default connection protocol will be 'https'. The default value is 'false'.
custom-protocol optional Can be one of those defined locally for this 'http-call', or globally in GreenVulcano® ESB on GVSupport configuration.
Attribute Type Description
conn-timeout optional Defines the connection timeout, in ms. Default to 10000ms.
so-timeout optional Defines the timeout to wait for a server response, in ms. Default to 30000ms.
Attribute Type Description
context-path optional Optional context path to prepend to remote URI call.


It has the subelements:

CustomProtocol

This element represents the custom protocol handler configuration. Refer to HttpClient documentation for further info: http://hc.apache.org/httpclient-3.x/sslguide.html

Its attributes are:

Attribute Type Description
name required Name identifier for this protocol.
protocol-scheme required The URI protocol scheme (http, https, etc.).
protocol-socket-factory required The custom socket factory class, implementation of class org.apache.commons.httpclient.protocol.ProtocolSocketFactory.
If this class do not have a default constructor, you can specify constructor arguments using constructor-args element.
protocol-default-port required The default port number for this custom protocol.
protocol-virtual-scheme optional You can specify this parameter to use your own custom protocol designator as well as the default protocol implementation, specified by protocol-scheme attribute.

Its subelements are:

constructor-args

Contains more constructor-param items where you can specify the constructor arguments, if your protocol socket factory class does not have a default constructor.

constructor-param

The constructor-param Element is a constructor parameter. It has the attributes:

Attribute Type Description
type required Parameter type. Only simple java types are supported. The attribute's admitted values are:
  • byte
  • boolean
  • char
  • double
  • float
  • int
  • long
  • short
  • String
value optional Parameter value. Do not specify the value of this parameter if null should be passed. #Encrypted.
The attribute's admitted values are:
  • true
  • false

method

Method to invoke on the server.

Its attributes are:

Attribute Type Description
name required Method name. The attribute's admitted values are:
  • OPTIONS
  • GET
  • HEAD
  • POST
  • PUT
  • DELETE
request-uri required Request URI. Can contain placeholders.
ref-dp optional Name of Data provider to use to prepare the request.
Attribute Type Description
uri-escaped optional If true the request-uri is already escaped, if false (WARNING!!!) the uri is escaped by the plug-in.

Default to true.