Portlet Factory, Version 6.1.2

 

EJB Call builder inputs

This topic describes the inputs for the EJB Call builder.

 

General inputs

Table 1. General inputs
Input Name Description
Name Name for this builder call. The WebSphere Portlet Factory Designer displays this name in the builder call list.
EJB to call Select an EJB from the drop-down list.

EJBs displayed in the list result from introspecting the ejb-jar.xml files found in any available EJB jars.

Cache Home Interface Enable to turn on caching and improve performance.

This input determines whether or not the EJB Home interface is cached or looked up for each client. Disabling caching often degrades performance because a look-up is required for each client.

 

Remote JNDI Server Definitions

Table 2. Remote JNDI Server Definitions inputs
Input Name Description
JNDI Context Factory Select the appropriate Context Factory class based on the type of remote JNDI server.

This corresponds to the environment property Context.INITIAL_CONTEXT_FACTORY.

The syntax of this entry depends on the application server or JNDI server you are using. For example:

  • IBM® WebSphere Application Server: com.ibm.ws.naming.util.WsnInitCtxFactory
JNDI URL Select the URL of the remote JNDI server.

This entry corresponds to the environment property Context.PROVIDER_URL required for creating an initial naming context. For example:

  • WebSphere Application Server: iiop://host_name:9001
Principal The principal name to be used in binding to the JNDI Server that specifies the identity of the user for authentication to the remote JNDI server. This value is typically a user name or ID.

You can also type a reference to a variable, such as ${Variables/principal}.

Each EJB server has its own way of specifying which roles and users have access to certain bean methods. For more information, refer to the documentation accompanying your EJB server.

Note: Application servers handle this input in different ways. For example:

  • WebSphere Application Server – The Principal and Credentials inputs you provide in this builder will override the ones provided by the datasource on the application server.
Credentials Specifies the password of the user for authentication to the remote JNDI server. This value is typically the password associated with the user name entered in the Principal input.

 

Constructor

Table 3. Constructor inputs
Input Name Description
Constructor Source Select one of the following constructor operations:

Create

Select to generate a constructor by filling in the appropriate information and then clickingGenerate.

Specify

Select to use a method or method call in your model as the method which creates an EJB reference. The selected method must return an EJB remote interface, or a collection containing EJB remote interfaces.
Instantiate Method (Available when Constructor Source is Specify.)

Choose the method or method call in your model to use to create an EJB reference.

Note: The method must return an EJB remote interface, or a collection containing EJB remote interfaces.

Create Method Select a value from the list of create methods available in the EJB home interface.
Create Arguments Arguments used should present a list of the argument types from the selected create method.
Finder Method (Entity EJBs only) For an entity EJB, select a finder method from the EJB Home Interface.

This method is used to locate the entity bean.

Finder Method Arguments Provide values for any arguments associated with the finder method selected above.
Generate Button After filling in the appropriate information in the rest of the Constructor group inputs, click Generate to generate the constructor used to create the EJB Remote Interface.
Constructor Use the reference chooser to select a constructor.

Optionally, you can write your own EJB Constructor by entering constructor code directly into the input area.

Note: If this input is left blank, the builder tries to use a no-argument create() call on the EJB Home Interface to create the EJB Remote Interface.

 

EJB Info

Table 4. EJB Info inputs
Input Name Description
EJB name (Normally provided automatically by this builder.)

Name of the EJBs specified in ejb-jar.xml file.

JNDI Name (Normally provided automatically by this builder.)

EJB JNDI Name

Remote Interface (Normally provided automatically by this builder.)

Fully-qualified Remote Interface Name

Home Interface (Normally provided automatically by this builder.)

Fully-qualified Home Interface Name

Parent topic: EJB Call builder

Library | Support |