Using an EJB Proxy project – PB Docs 2017

• EJB Client Proxy
  icon

• EJB Client Proxy
  Wizard icon

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.

Proxy generation requires javap.exe

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 Oracle 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.