Using an EJB Proxy project – PB Docs 125

To create an EJB Client Proxy project in the Project
painter:

1. Double-click the EJB Client Proxy icon
   on the Projects page of the New dialog box.

2. To specify the EJB, select Edit>Select
   Objects and enter the fully qualified name of the component’s
   remote interface in the text box, for example com.sybase.jaguar.sample.svu.SVULogin or portfolio.MarketMaker.

3. Enter the path of the directory or JAR file that
   contains the EJB’s stubs in the Classpath box and click
   OK.

   If the stub files are in a directory and the fully qualified
   name of the EJB is packagename.beanname,
   enter the directory that contains packagename.

4. To specify the PBL where the proxy objects should
   be stored, select Edit>Properties and browse to the location
   of a library in the target’s library list.

   You can specify an optional prefix that is added to the beginning
   of each generated proxy name. Adding a prefix makes it easier to
   identify the proxies associated with a specific EJB and can be used
   to avoid conflicts between class names and PowerBuilder reserved
   words. The prefix is not added to the name of proxies that are not
   specific to this EJB, such as the proxies for exceptions, stream
   objects, and ejbhome, ejbobject, ejbmetadata, handle, and homehandle.

5. Close the dialog box and select File>Save
   to save the project.

To create an EJB Client Proxy project using the
wizard:

1. Double-click the EJB Client Proxy Wizard
   icon on the Projects page of the New dialog box and click Next on
   the first page of the wizard.

2. Select a library in which to store the project
   object and click Next.

3. Specify a name and optional description for the
   project and click Next.

4. As shown, enter the fully qualified name of the
   component’s remote interface in the text box, for example cocoPortfolio.Portfolio:

   

   The component’s home interface name is entered automatically
   using the standard naming convention, although the wizard lets you
   modify this name if necessary.

5. Browse to select the JAR file that contains the
   EJB’s stubs or the directory that contains the stub package.

   If the stub files are in a directory and the fully qualified
   name of the EJB is packagename.beanname,
   enter the directory that contains packagename.

6. Specify an optional prefix that is added to the
   beginning of each generated proxy name and click Next.

   Adding a prefix makes it easier to identify the proxies associated
   with a specific EJB and can be used to avoid conflicts between class
   names and PowerBuilder reserved words. The prefix is not added to
   the name of proxies that are not specific to this EJB, such as the
   proxies for exceptions, supporting classes, and EJBHome, EJBObject,
   EJBMetaData, Handle, and HomeHandle.

7. Browse to select an existing library and click
   Next and Finish.

   The proxy objects are generated and stored in this library,
   which must be added to the target’s library list.

PowerBuilder uses the javap.exe utility
to generate proxy objects. This executable must be in your system
path. By default, EJB client development uses the Sun JDK 1.4 installed
with PowerBuilder. The path and classpath required by the Java VM
are added to the path and classpath used in the current session
automatically.

If you want to use a different JDK installation, select Tools>System
Options, then click Set JDK Location on the Java page of the System
Options dialog box. For WebSphere, the path to the IBM JDK installation
can be used instead.