ExtendedInboundParamHandlerFormatter

Description

This sub-element formatter is used into the decoding of client request's parameters in order to create the input for a GreenVulcano^® ESB service and to convert the service's output into a HTTP response.

GreenVulcano^® ESB Configuration

The GVAdapterHttpConfiguration Element is used by: GVAdapters.

The following table shows the ExtendedInboundParamHandlerFormatter attributes:

Attribute	Type	Description
type	fixed	Set to FormatterPlugin.
class	fixed	Set to it.greenvulcano.gvesb.adapter.http.formatters.handlers.ExtendedInboundParamHandlerFormatter.
ID	required	Formatter identifier
read-request-header	optional	If 'true' reads the request HTTP headers and provide them with the request parameters. Default value is false.
ReqCharacterEncoding	optional	CharacterEncoding to be used to handle requests from external system. Default to UTF-8.
RespCharacterEncoding	optional	CharacterEncoding to handle responses to the external system. Default to UTF-8.
RespContentType	optional	ContentType to be declared while handling HTTP responses to the external system. Default to text/html.
HandlePostBodyAsParams	optional	If true force the POST body to be handled as application/x-www-form-urlencoded content type. Default is false.
ResponseOnError-HTTPCode	optional	If != -1 force the adapter to respond with the given http code on case of error. Default is -1 (disabled).

Contains the sub-elements:

• RequestParams
• RequestContent
• GVBufferDefaultValues
• OpTypeDefaultValue
• ResponseParams
• Description

RequestParams

This element contains configuration informations about conversion of the parameters of an inbound http request into a valid GVBuffer object and determination of the communication paradigm to be used by GreenVulcano.

Contains the sub-elements:

• RequestParam

The following table shows the RequestParams attributes:

Attribute	Type	Description
ParamNameValueSeparator	optional	Parameters name-value separator string within input querystring.
ParamEntrySeparator	optional	Parameters entry separator string within input querystring.

RequestParam

This element specifies the rules to follow to convert a single parameter of an inbound http request into a partially populated GVBuffer object.

Contains the sub-elements:

• RequestXMLParamHandler
• RequestFlatParamHandler
• RequestStringParamHandler

The following table shows the RequestParam attributes:

Attribute	Type	Description
Name	required	The name of an inbound request parameter.
Required	optional	If true the request parameter is mandatory. Default is True.
Type	optional	Not used

RequestContent

This element contains configuration informations about conversion of the content of an inbound http request into a valid GVBuffer object and determination of the communication paradigm to be used by GreenVulcano.

Contains the sub-elements:

• RequestXMLParamHandler
• RequestFlatParamHandler
• RequestStringParamHandler

ResponseParams

This element contains configuration informations about conversion of a response GVBuffer object (received from GreenVulcano) into an inbound http response to be sent to the invoking external http system.

Contains the sub-elements:

• ResponseParam

The following table shows the ResponseParams attributes:

Attribute	Type	Description
ParamNameValueSeparator	optional	Parameters name-value separator string within ouput querystring. Default is '='
ParamEntrySeparator	optional	Parameters entry separator string within ouput querystring. Default is '&'

ResponseParam

This element specifies the rules to follow to generate a single parameter of an inbound http response. It's possible to use values read from the fields of the response GVBuffer object received from GreenVulcano, or configure a default value for each handler mapping.

Contains the sub-elements:

• ResponseXMLParamHandler
• ResponseFlatParamHandler
• ResponseStringParamHandler
• XMLParamErrorHandler
• FlatParamErrorHandler
• StringParamErrorHandler

The following table shows the ResponseParam attributes:

Attribute	Type	Description
Name	required	The name of an inbound request parameter.
SendParameterName	required	True if the parameter's name must appear within inbound response, false otherwise.
PutInHeader	required	If true must appear in the HTTP header.
Type	optional	Not used

Request Parameter Handlers

RequestXMLParamHandler

This element contains configuration informations about an inbound request XML parameter Handler: a Java object used to extract informations from a single parameter of an inbound http request (in the case that this parameter contains an XML string) and use them to populate one or more fields of a GVBuffer request object to be sent to GreenVulcano.

Contains the sub-elements:

• RequestXMLParamMapping

The following table shows the RequestXMLParamHandler attributes:

Attribute	Type	Description
ItemType	fixed	Set to Handler.
Class	fixed	Set to it.greenvulcano.gvesb.adapter.http.formatters.handlers.XMLParameterHandler.
OutputType	required	The output type of this inbound request parameter handler (GVBuffer object or communication paradigm string). Possible values are: GVBuffer OpType

RequestXMLParamMapping

This element contains a mapping between a value extracted by an element or attribute (within XML content of an inbound request parameter) matching a given XPath, and a field of a request GVBuffer object. If mapping target is indicated with the "OpType" keyword, the value is a string indicating the requested communication paradigm (RequestReply, Request, SendReply, GetRequest, GetReply)

Contains the sub-elements:

• GVBufferField
• GVBufferProperty
• OpType

The following table shows the RequestXMLParamMapping attributes:

Attribute	Type	Description
ItemType	fixed	Set to Mapping.
XPath	required	XPath of an element or attribute (within XML content of an inbound request parameter).

RequestFlatParamHandler

This element contains configuration informations about an inbound request Flat parameter Handler: a Java object used to extract informations from a single parameter of an inbound http request (in the case that this parameter contains a Flat string) and use them to populate one or more fields of a GVBuffer request object to be sent to GreenVulcano.

Contains the sub-elements:

• RequestFlatParamMapping

The following table shows the RequestFlatParamHandler attributes:

Attribute	Type	Description
ItemType	fixed	Set to Handler.
Class	fixed	Set to it.greenvulcano.gvesb.adapter.http.formatters.handlers.FlatParameterHandler
OutputType	required	The output type of this inbound request parameter handler (GVBuffer object or communication paradigm string). Possible values are: GVBuffer OpType
SeparatorChar	optional	The separator character between fields within the flat string value of this inbound request parameter.

RequestFlatParamMapping

This element contains a mapping between a value extracted from a flat string (the content of an inbound request parameter), and a field of a request GVBuffer object. If mapping target is indicated with the "OpType" keyword, the value is a string indicating the requested communication paradigm (RequestReply, Request, SendReply, GetRequest, GetReply).

Contains the sub-elements:

• GVBufferField
• GVBufferProperty
• OpType

The following table shows the RequestFlatParamMapping attributes:

Attribute	Type	Description
ItemType	fixed	Set to Mapping.
Offset	required	The offset of a field within the flat string value of this inbound request parameter.
Length	optional	The length of a field within the flat string value of this inbound request parameter. Not needed if a field separator char has already been specified.
Trim	optional	The place where unneeded filling white spaces can be present. Possible values are: left, to trim leading white spaces right, to trim trailing white spaces both, to trim both leading and trailing spaces If it is specified a value different from these above, no trimming will be performed

RequestStringParamHandler

This element contains configuration informations about an inbound request Flat parameter Handler: a Java object used to extract informations from a single parameter of an inbound http request (in the case that this parameter contains a plain text string) and use them to populate one or more fields of a GVBuffer request object to be sent to GreenVulcano.

Contains the sub-elements:

• RequestStringParamMapping

The following table shows the RequestStringParamHandler attributes:

Attribute	Type	Description
ItemType	fixed	Set to Handler.
Class	fixed	Set to it.greenvulcano.gvesb.adapter.http.formatters.handlers.StringParameterHandler
OutputType	required	The output type of this inbound request parameter handler (GVBuffer object or communication paradigm string). Possible values are: GVBuffer OpType

RequestStringParamMapping

This element contains a mapping between a value extracted from a plain text string (the value of an inbound request parameter), and a field of a request GVBuffer object. If mapping target is indicated with the "OpType" keyword, the value is a string indicating the requested communication paradigm (RequestReply, Request, SendReply, GetRequest, GetReply).

Contains the sub-elements:

• GVBufferField
• GVBufferProperty
• OpType

The following table shows the RequestStringParamMapping attributes:

Attribute	Type	Description
ItemType	fixed	Set to Mapping.

Default Value Handlers

GVBufferDefaultValues

This element contains the configuration of default values for some of all the fields of a inbound request GVBuffer object.

Contains the sub-elements:

• GVBufferFieldDefaultValue
• GVBufferPropertyDefaultValue

GVBufferFieldDefaultValue

A configured default value for a field of a GVBuffer object. The following table shows the GVBufferFieldDefaultValue attributes:

Attribute	Type	Description
FieldName	required	The GVBuffer field name. The possible values are: GVBuffer.system GVBuffer.service GVBuffer.id GVBuffer.retCode GVBuffer.object
FieldValue	required	The configured default value of a GVBuffer field.

GVBufferPropertyDefaultValue

A configured default value for a property of a GVBuffer object. The following table shows the GVBufferPropertyDefaultValue attributes:

Attribute	Type	Description
FieldName	required	The GVBuffer property name.
FieldValue	required	A configured default value for a property field of a GVBuffer object.

OpTypeDefaultValue

A configured default value for the communication paradigm to be used.

The following table shows the OpTypeDefaultValue attributes:

Attribute	Type	Description
Value	required	The configured default value for the communication paradigm. Possible values are: RequestReply Request SendReply GetRequest GetReply

Common Elements

GVBufferField

This element represents a mapping target from/to a field of a GVBuffer object. The following table shows the GVBufferField attributes:

Attribute	Type	Description
FieldName	required	The GVBuffer field name. The possible values are: GVBuffer.system GVBuffer.service GVBuffer.id GVBuffer.retCode GVBuffer.object

GVBufferProperty

This element represents a mapping target from/to a property of a GVBuffer object. The following table shows the GVBufferProperty attributes:

Attribute	Type	Description
FieldName	required	The GVBuffer property name.

GVBufferPropertyList

This element represents a mapping target from/to a list of properties of a GVBuffer object. The following table shows the GVBufferPropertyList attributes:

Attribute	Type	Description
URLEncoding	required	True if outbound request parameters must be URLEncoded, false otherwise. Possible values are : True False
FieldNameValueSeparator	optional	Parameters name-value separator string. Default is '='
FieldEntrySeparator	optional	Parameters entry separator string within list. Default is ';'
ExcludeFields	optional	The comma separated list of property names to ignore.

DefaultValue

This element represents a plain text value to be assigned as source/target of an handler mapping.