WebLogic Server 6.0 Code Examples, BEA Systems, Inc.

Package examples.rmi_iiop.ejb.rmi_iiop

This example demonstrates connectivity between a RMI over IIOP client and an EJB.

See:
          Description

Interface Summary
Trader The methods in this interface are the public face of TraderBean.
TraderHome This interface is the home interface for the TraderBean.java, which in WebLogic is implemented by the code-generated container class TraderBeanC.
 

Class Summary
Client This class illustrates calling a stateless Session Bean and performing the following exercises: Create a Trader Buy some shares using the Trader Sell some shares using the Trader Remove the Trader
TraderBean TraderBean is a stateless Session Bean.
TradeResult This class reflects the results of a buy/sell transaction.
 

Package examples.rmi_iiop.ejb.rmi_iiop Description

This example demonstrates connectivity between a RMI over IIOP client and an EJB.

This example illustrates:

This example demonstrates connectivity between a RMI over IIOP client and an EJB. It uses VisiBroker 4.0 for Java. It uses a stateless session EJB called TraderBean and presumes some knowledge of EJB deployment. For examples pertaining stricly to EJBs, please see our EJB examples page. Included there is a stateless session bean similar to TraderBean.

To get the most out of this example, first read through the source code files to see what is happening. Start with the XML deployment files to find the general structure of the EJB, i.e. which classes are used for the different objects and interfaces, then examine the other files to see how the application works.

The following section describes how to build and run the example:

  1. Build the example
  2. Configure the server
  3. Run the example

Build the example

  1. Set up your development shell as described in Setting up your environment.

  2. Execute the build script provided for this example in the samples\examples\rmi_iiop\ejb\rmi_iiop directory of your WebLogic Server installation. The script will perform the following steps:

    1. Create the build directory, and copy the deployment descriptors into it as shown in this example for Windows NT/2000:

      $ mkdir build build\META-INF build\images

      $ copy *.xml build\META-INF

      $ copy *.gif build\images

    2. Compile ejb classes into the build directory (jar preparation) as shown in this example for Windows NT/2000:

      $ javac -d build Trader.java TraderHome.java TradeResult.java TraderBean.java

    3. Make a EJB jar file, including XML deployment descriptors as shown in this example for Windows NT/2000:

      $ cd build

      $ jar cv0f std_ejb_over_iiop.jar META-INF examples images

      $ cd ..

    4. Run ejbc on jar file as shown in this example for Windows NT/2000:

      $ java weblogic.ejbc -compiler javac -idl -idlDirectory idlSources -iiop build\std_ejb_over_iiop.jar %APPLICATIONS%\ejb_over_iiop.jar

    5. Compile EJB interfaces & client application into the clientclasses directory as shown in this example for Windows NT/2000:

      $ javac -d %CLIENT_CLASSES% Trader.java TraderHome.java TradeResult.java Client.java

  3. Note: Running the build script places the EJB in %WL_HOME%\config\examples\applications directory, where it automatically deploys once the server is started. If you are already running the server and build another EJB, it is automatically placed in this directory and instantly deployed.

    Additional information on using the build scripts is found in Building Enterprise JavaBean examples

Configure the server

  1. Start the server with the examples configuration.

  2. Make sure that the EJB has been deployed on your examplesServer.

  3. Bring up the Administration Console in your browser.

    1. Click to expand the Deployments node in the left-hand pane.
    2. Click to expand the EJB node in the left-hand pane.
    3. Select the ejb_over_iiop node.
    4. Select the Targets tab in the right-hand pane to display the Available and Chosen targets.
    5. Deploy the ejb_over_iiop on the examplesServer.

Run the example

  1. Open a new command shell.

  2. Set up your development shell as described in Setting up your environment.

  3. Set the CLASSPATH as shown in this example for Windows NT/2000:

    $ set CLASSPATH=%CLASSPATH%;%WL_HOME%\config\examples\applications\ejb_over_iiop.jar
    where WL_HOME is the installation directory for WebLogic Server.

  4. Obtain the WebLogic Server Inter-operable Object Reference (IOR) by running the host2ior utility in the command shell as shown in this example for Windows NT/2000:

    $ java utils.host2ior hostname port
    where:
    hostname
    Host name of the WebLogic Server
    port
    Port where the WebLogic Server is listening for connections (weblogic.system.ListenPort).

  5. Run the client by entering the following command as shown in this example for Windows NT/2000:

    $ java examples.rmi_iiop.ejb.rmi_iiop.Client ServerIOR
    where ServerIOR is the IOR you obtained by running the host2ior utility.

  6. You should get output similar to this from the client application:

    Beginning statelessSession.Client
    
    Creating a trader
    Buying 100 shares of BEAS.
    Buying 200 shares of MSFT.
    Buying 300 shares of AMZN.
    Buying 400 shares of HWP.
    Selling 100 shares of BEAS.
    Selling 200 shares of MSFT.
    Selling 300 shares of AMZN.
    Selling 400 shares of HWP.
    Removing the trader
    
    End statelessSession.Client...

There's more...

Read more about WebLogic RMI over IIOP in the Developer Guide, Using WebLogic RMI over IIOP.

Read more about WebLogic EJB in the Developer Guide, BEA WebLogic Server Enterprise JavaBeans.

Read more about WebLogic RMI in the Developer Guide, Using WebLogic RMI.


Documentation is available at
http://e-docs.bea.com/wls/docs60

Copyright © 2000 BEA Systems, Inc. All Rights Reserved.