Difference between revisions of "J2ee-ejb-call"
| (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 | + | 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. | ||
| + | |} | ||
| − | + | <div class="version_ge3.3"> | |
| − | + | Attributes change in version 3.3: | |
| − | + | {|class="gvtable" | |
| − | + | ! 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 {{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 | + | and its sub-elements: |
| − | * Description | + | * [[Description]] |
| − | * [[JNDIHelper]] | + | * [[JNDIHelper]] |
| − | * WLSSubjectBuilder | + | * [[#WLSSubjectBuilder|WLSSubjectBuilder]] |
* [[ServiceAlias]] | * [[ServiceAlias]] | ||
| + | ===WLSSubjectBuilder=== | ||
| − | + | This element is the ''SubjectBuilder'' definition for the Weblogic 8 application server. | |
| − | + | It is used by: [[j2ee-ejb-call]]. | |
Its attributes are: | Its attributes are: | ||
| − | + | {|class="gvtable" | |
| − | + | ! 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 | ||
| + | |} | ||
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 |
