Difference between revisions of "GVThrowException"

From GreenVulcano Wiki
Jump to: navigation, search
({{GVESB}} Configuration)
 
Line 9: Line 9:
 
Exceptions are allowed only of type '''it.greenvulcano.gvesb.buffer.GVException''' and its subclasses.
 
Exceptions are allowed only of type '''it.greenvulcano.gvesb.buffer.GVException''' and its subclasses.
  
The exception-id attribute or value can contain [[placeholders|metadata]] to be replaced with fields of any [[GVBuffer]] in the execution environment. The parameters are always written in ${param} format.
+
The GVThrowException@exception-id or ExceptionParam@value attributes can contain placeholders to be replaced with fields of the [[GVBuffer]] extracted from the execution environment. The parameters are always written in ${param} format.
  
The possible parameters are:  
+
The possible placeholders are:  
 +
for [[GVBuffer]] fields:
 +
* ${system}
 +
* ${service}
 +
* ${id}
 +
* ${retCode}
 +
for [[GVBuffer]] properties:
 +
* ${property[<name>]}
  
For a [[GVBuffer]] object
+
All placeholders are written in accordance with the above format.
* for standard fields, the field name
+
If an error occurs the placeholders will not be replaced.
* ${GVBuffer.system}
 
* ${GVBuffer.service}
 
* ${GVBuffer.id}
 
* ${GVBuffer.retCode}
 
 
 
For properties:
 
* ${GVBuffer.property:}
 
* ${GVBuffer.properties} (return all the properties, in the form name: 'filedName' value: 'fieldValue')
 
 
 
All [[placeholders|metadata]]  are written in accordance with the above format.
 
 
 
If an error occurs the [[placeholders|metadata]]  will not be replaced.
 
  
 
The GVThrowException Element is used by: [[GVEndNode]].
 
The GVThrowException Element is used by: [[GVEndNode]].

Latest revision as of 14:35, 11 September 2013

Description

GVThrowException element stops the Flow with an exception.

GreenVulcano® ESB Configuration

The element GVThrowException is used in a GVEndNode and allows to stop the workflow of GreenVulcano® ESB with exception.

Exceptions are allowed only of type it.greenvulcano.gvesb.buffer.GVException and its subclasses.

The GVThrowException@exception-id or ExceptionParam@value attributes can contain placeholders to be replaced with fields of the GVBuffer extracted from the execution environment. The parameters are always written in ${param} format.

The possible placeholders are: for GVBuffer fields:

  • ${system}
  • ${service}
  • ${id}
  • ${retCode}

for GVBuffer properties:

  • ${property[<name>]}

All placeholders are written in accordance with the above format. If an error occurs the placeholders will not be replaced.

The GVThrowException Element is used by: GVEndNode.

The following table shows the GVThrowException element's attributes:

Attribute Type Description
exception-id required ID of the exception.
class optional Exception class.

Exceptions are allowed only of type it.greenvulcano.gvesb.buffer.GVException and its subclass.
The attribute's default value is: it.greenvulcano.gvesb.core.exc.GVCoreException.

Might contain the sub-elements:

ExceptionParam

This element specifies parameters to pass to the exception message.

The following table shows the ExceptionParam element's attributes:

Attribute Type Description
name required Parameter name.
value required Parameter value.

Might contain the sub-element Description.