J2ee-ejb-call

From GreenVulcano Wiki
Jump to: navigation, search

Description

Use this service to invoke an Enterprise Java Bean v2.x or v3.x.

VulCon / GV Console Configuration

The j2ee-ejb-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.j2ee.J2EECallOperation.
name required Operation name. Used in the 'Flow' section to associate workflow nodes to VCL operations.
jndi-name required EJB JNDI name.
method required Method name to invoke. The method must have the following signature:
it.greenvulcano.gvesb.buffer.GVBuffer
method(it.greenvulcano.gvesb.buffer.GVBuffer gvbuffer)
parameterTypes required Method parameter types list. Comma separated class names or data types:

- it.greenvulcano.gvesb.buffer.GVBuffer - java.lang.String,int,int - java.lang.String[]

input-ref-dp optional Name of Data Provider to be used to preaprate the EJB method actual parameters. This Data Provider will receive in input a GVBuffer and must return an array of object compatible with the parameterTypes list. If not defined is assumed that the method signature is: it.greenvulcano.gvesb.buffer.GVBuffer method(it.greenvulcano.gvesb.buffer.GVBuffer gvbuffer)
output-ref-dp optional Name of Data Provider to use for output manipulation. This Data Provider will receive in input a GVBuffer and the EJB method output object and must return an enriched GVBuffer object. Ex. a GVBufferChangeDataProvider instance.
home-interface required Java class that defines the EJB home interface. Note that if the EJB is installed on the same application server of GreenVulcano® ESB, then you can also specify the local home interface.
remote-or-local-interface required Java class that defines the EJB home remote. Note that if the EJB is installed on the same application server of GreenVulcano® ESB, then you can also specify the local interface.

Attributes change in version 3.3:

Attribute Type Description
version optional EJB version, can be 2 or 3. Default to 3.
home-interface optional Java class that defines the EJB home interface. Note that if the EJB is installed on the same application server of GreenVulcano® ESB, then you can also specify the local home interface. Is mandatory if version = 2 and must not be defined if version = 3.

and its sub-elements:

WLSSubjectBuilder

This element is the SubjectBuilder definition for the Weblogic 8 application server.

It is used by: j2ee-ejb-call.

Its attributes are:

Attribute Type Description
type fixed This attribute must assume the value subject-builder.
class fixed This attribute must assume the value it.greenvulcano.gvesb.jaas.WLSSubjectBuilder.
provider-url required URL for the application server connection. See the application server documentation for the format of this parameter.
security-principal required User name to connect the application server.
security-credentials required Password to connect the application server. #Encrypted