Difference between revisions of "J2ee-ejb-call"

From GreenVulcano Wiki
Jump to: navigation, search
 
(4 intermediate revisions by one other user not shown)
Line 1: Line 1:
 
==Description==
 
==Description==
  
Use this service to invoke an Enterprise Java Bean.
+
Use this service to invoke an Enterprise Java Bean v2.x or v3.x.
  
 
=={{VULCON}} / {{GVCONSOLE}} Configuration==
 
=={{VULCON}} / {{GVCONSOLE}} Configuration==
  
The ''j2ee-ejb-call'' Element is used by [[Channel]] and [[routed-call]].
+
The [[j2ee-ejb-call]] Element is used by [[Channel]] and [[routed-call]].
  
 
Its attributes are:  
 
Its attributes are:  
 +
{|class="gvtable"
 +
! 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: <br/>it.greenvulcano.gvesb.buffer.GVBuffer <br/> 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 {{GVESB}}, 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 {{GVESB}}, then you can also specify the local interface.
 +
|}
  
* ''type'': call.
+
<div class="version_ge3.3">
* ''class'': it.greenvulcano.gvesb.virtual.j2ee.J2EECallOperation.
+
Attributes change in version 3.3:
* ''name'': Operation name. Used in the 'Flow' section to associate workflow nodes to VCL operations.
+
{|class="gvtable"
* ''jndi-name'': EJB JNDI name.
+
! Attribute !! Type !! Description
* ''method'': Method name to invoke. The method must have the following signature: <br/>it.greenvulcano.gvesb.buffer.GVBuffer <br/> method(it.greenvulcano.gvesb.buffer.GVBuffer gvbuffer)
+
|-
* ''home-interface'': Java class that defines the EJB home interface. Note that if the EJB is installed on the same application {{GVESB}} server, then you can also specify the local home interface.
+
| version || optional || EJB version, can be 2 or 3. Default to 3.
* ''remote-or-local-interface'': Java class that defines the EJB home remote. Note that if the EJB is installed on the same application {{GVESB}} server, then you can also specify the local interface.
+
|-
 +
| home-interface || optional || Java class that defines the EJB home interface. Note that if the EJB is installed on the same application server of {{GVESB}}, then you can also specify the local home interface. Is mandatory if version = 2 and must not be defined if version = 3.
 +
|}
 +
</div>
  
and its subelements:
+
and its sub-elements:
  
* Description,
+
* [[Description]]
* [[JNDIHelper]],
+
* [[JNDIHelper]]
* WLSSubjectBuilder (see bellow),
+
* [[#WLSSubjectBuilder|WLSSubjectBuilder]]
 
* [[ServiceAlias]]
 
* [[ServiceAlias]]
  
 +
===WLSSubjectBuilder===
  
==WLSSubjectBuilder==
+
This element is the ''SubjectBuilder'' definition for the Weblogic 8 application server.
  
This element is the SubjectBuilder definition for the Weblogic 8 application server It is used only by ''j2ee-ejb-call''.
+
It is used by: [[j2ee-ejb-call]].
  
 
Its attributes are:
 
Its attributes are:
 
+
{|class="gvtable"
* ''type'': subject-builder.
+
! Attribute !! Type !! Description
* ''class'': it.greenvulcano.gvesb.jaas.WLSSubjectBuilder.
+
|-
* ''provider-url'': URL for the application server connection. See the application server documentation for the format of this parameter.
+
| type || fixed || This attribute must assume the value '''subject-builder'''.
* ''security-principal'': User name to connect the application server.
+
|-
* ''security-credentials'': Password to connect the application server. #Encrypted
+
| 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
 +
|}

Latest revision as of 15:48, 4 March 2013

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