Difference between revisions of "Rest-call"

From GreenVulcano Wiki
Jump to: navigation, search
 
(8 intermediate revisions by one other user not shown)
Line 1: Line 1:
 
==Description==
 
==Description==
  
<div class="version_ge3.4">
+
The {{GVESB}} plugin '''rest-call''' defines the parameters for calling a Web Service using REST mode.
The {{GVESB}} plugin '''ws-call''' defines the parameters for calling a Web Service using REST mode.
 
</div>
 
  
 
=={{VULCON}} / {{GVCONSOLE}} Configuration==
 
=={{VULCON}} / {{GVCONSOLE}} Configuration==
Line 21: Line 19:
 
* [[Description]]
 
* [[Description]]
 
* [[rest-call#RestServiceInvoker|RestServiceInvoker]]
 
* [[rest-call#RestServiceInvoker|RestServiceInvoker]]
* [[Proxy]]
 
  
 
===RestServiceInvoker===
 
===RestServiceInvoker===
  
This element is used by [[ws-call]].
+
This element is used by [[rest-call]].
  
 
Its attributes are:
 
Its attributes are:
Line 52: Line 49:
 
| throwsFault || optional || If ''true'' throws Exception "Error invoking operation". If ''false'' returns the Fault response. Default to false.
 
| throwsFault || optional || If ''true'' throws Exception "Error invoking operation". If ''false'' returns the Fault response. Default to false.
 
The attribute's admitted values are:
 
The attribute's admitted values are:
* true
 
* false
 
|-
 
| use-saaj || optional || Defines whether to use SAAJ to invoke the WebService mode instead of the default Axis2 mode. <br/> NOTE: If you choose to use SAAJ as a way of calling the WebService, Axis2 modules are not enabled. <br/> The attribute's admitted values are:
 
 
* true
 
* true
 
* false
 
* false
Line 78: Line 71:
 
|}
 
|}
  
 
+
and has the sub-elements:
 
+
* [[Description]]
UNDER CONSTRUCTION...
+
* [[Proxy]]
 +
* [[BasicHttpAuth]]
 +
* [[NTLMHttpAuth]]

Latest revision as of 15:11, 13 May 2014

Description

The GreenVulcano® ESB plugin rest-call defines the parameters for calling a Web Service using REST mode.

VulCon / GV Console Configuration

The rest-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.ws.rest.RestCallOperation.
name required Operation name. Used in the Flow section to associate workflow nodes to VCL operations.

and its subelements:

RestServiceInvoker

This element is used by rest-call.

Its attributes are:

Attribute Type Description
type fixed This attribute must assume the value invoker.
class fixed This attribute must assume the value it.greenvulcano.gvesb.virtual.ws.rest.RestServiceInvoker.
endpoint required Endpoint exposed by the Rest Web Service to invoke. Can contain placeholders. It must be already escaped, if needed.
method required HTTP method to execute to the server.

The attribute's admitted values are:

  • GET
  • POST
  • PUT
  • DELETE
  • HEAD
  • OPTIONS
timeout optional Timeout in seconds.
ref-dp optional Name of Data Provider to use for preparing the request.
throwsFault optional If true throws Exception "Error invoking operation". If false returns the Fault response. Default to false.

The attribute's admitted values are:

  • true
  • false
returnType optional Defines how to set the response data in the object field of output GVBuffer:
  • context : the MessageContext
  • envelope : the envelope as XML serialized as string
  • body : the body as XML serialized as string
  • body-element : the first child of body as XML serialized as string
  • header : the header as XML serialized as string
  • envelope-om : the envelope as OMMessage
  • body-om : the body as OMMessage
  • body-element-om : the first child of body as OMMessage
  • header-om : the header as OMMessage

Default: context

mediaType optional This is used to specify the message format which the message needs to be serialized. See 'messageFormatters' configuration in axis2.xml file. Default value is: 'application/x-www-form-urlencoded'
contentType optional This is used to specify the message builder which the message needs to be serialized. See 'messageBuilders' configuration in axis2.xml file. Defaults to the value specified in 'mediaType' attribute.
responseMode optional This is used to specify if invoked service returns a response (OUT_IN) or not (OUT_ONLY). Default value is: OUT_IN

and has the sub-elements: