Difference between revisions of "Http-call"
(→CustomProtocol) |
(→CustomProtocol) |
||
Line 45: | Line 45: | ||
====CustomProtocol==== | ====CustomProtocol==== | ||
− | This element represents the custom protocol handler configuration. Referes to HttpClient documentation for further info: [http://hc.apache.org/httpclient-3.x/sslguide.html | http://hc.apache.org/httpclient-3.x/sslguide.html] | + | This element represents the custom protocol handler configuration. Referes to HttpClient documentation for further info: [http://hc.apache.org/httpclient-3.x/sslguide.html|http://hc.apache.org/httpclient-3.x/sslguide.html] |
The CustomProtocol Element is used by: endpoint. | The CustomProtocol Element is used by: endpoint. | ||
Line 56: | Line 56: | ||
| 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 | + | | 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. |
− | specify constructor arguments using ''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. |
Revision as of 10:37, 9 February 2012
Contents
Description
This GreenVulcano® ESB element is the HTTP VCL plugin to call HTTP methods on remote servers.
VulCon / GV Console Configuration
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 subelements:
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. |
It has the subelements:
- Description
- CustomProtocol
- Proxy
CustomProtocol
This element represents the custom protocol handler configuration. Referes to HttpClient documentation for further info: [1]
The CustomProtocol Element is used by: endpoint. 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:
- 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-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:
|
value | optional | Parameter value. Do not specify the value of this parameter if null should be passed. #Encrypted. The attribute's admitted values are:
|
method
Method to execute to the server. It is used by: http-call.
Its attributes are:
Attribute | Type | Description |
---|---|---|
name | required | Method name. The attribute's admitted values are:
|
request-uri | required | Request URI. Can contain placeholders. |
ref-dp | optional | Name of Data Provider to use to prepare the request. |