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.

DA COMPLETARE

GreenVulcano^® ESB Configuration

The GVAdapterHttpConfiguration Element is used by: GVAdapters.

The following table shows the ExtendedInboundParamHandlerFormatter attributes:

Attribute	Type	Description
type	fixed	This attribute must keep the value 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 GVBufferFieldDefaultValue and GVBufferPropertyDefaultValue.

Contains the sub-elements GVBufferField.

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.

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.

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	required	Parameters name-value separator string within input querystring.
ParamEntrySeparator	optional	Parameters entry separator string within input querystring.

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

RequestParam

This element specifies the rules to follow to convert a single parameter of an inbound http request into a partially populated GVBuffer object. The following table shows the RequestParam attributes:

Attribute	Type	Description
Name	required	If true the request parameter is mandatory. Possible values are : True, False. Default is True.
Type	optional	Not used

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 an 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	Element type.
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
• GVBufferPropertyList
• OpType

The following table shows the RequestXMLParamMapping attributes:

Attribute	Type	Description
ItemType	fixed	Element type.
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 an 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	Element type.
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	Element type.
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 an 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	Inbound request parameter/content format.
Class	fixed	The output type of this inbound request parameter handler (GVBuffer object or communication paradigm string).
OutputType	required	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). Possible values are: GVBuffer, OpType. This is the template used: <xsl:template match="RequestStringParamMapping"> <table cellpadding="0" cellspacing="0"> <xsl:choose> <xsl:when test="../../@Name"> <tr> <td>Inbound request parameter handled:</td> <td width="20"></td> <td><b><xsl:value-of select="../../@Name"/></b></td> </tr> </xsl:when> <xsl:otherwise> <tr> <td>Inbound request content handler mapping.</td> </tr> </xsl:otherwise> </xsl:choose> <tr> <td>Mapping target: <xsl:if test="GVBufferField"> field <b><xsl:value-of select="substring-after(GVBufferField/@FieldName, 'GVBuffer.')"/></b> of GVBuffer </xsl:if> <xsl:if test="GVBufferProperty"> extended field <b><xsl:value-of select="GVBufferProperty/@FieldName"/></b> of GVBuffer </xsl:if> <xsl:if test="OpType"> <i>OperationType</i> variable (GreenVulcano communication paradigm) </xsl:if> </td> </tr> </table> </xsl:template>