    All Examples  All EJB Examples

# Package examples.ejb.basic statelessSession

## Enterprise JavaBean stateless session
example package and classes

- Client application
    Client (client application documentation and source)

- Deployment
    ejb-jar.xml
    weblogic-ejb-jar.xml

- Interfaces
    Trader (remote interface documentation and source)
    TraderHome (home interface documentation and source)
    TradeResult (application-specific utility documentation and source)

- Server (EJBean)
    TraderBean (EJBean documentation and source)

# about this example

This example is a package that demonstrates an Enterprise JavaBean. Please run this example before attempting to create your own Enterprise JavaBeans, as it will show you the different steps involved. The example is a stateless session EJBean called TraderBean.

The example demonstrates:

- Usage of a session EJBean
- Stateless; client must maintain any state across calls to the EJBean
- Using application-defined exceptions and utilities
- Client Application

The Client application performs these steps:

1. Creates a Trader
2. Buys and sells shares of "BEAS", "MSFT", "AMZN", and "HWP"
   (The EJB does not actually "buy" or "sell"; it simulates the actions of accessing a database.)
3. Removes the Trader

The application demonstrates how the client must maintain any persistent state -- such as the change in the cash account -- across repeated calls to the session EJBean. All the logic for the balance is encapsulated in the Client, unlike the stateful session example, where all the persistence is provided by the container and the logic is maintained in the EJBean.

# how to use this example

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 EJBean, which classes are used for the different objects and interfaces, then look at Client.java to see how the application works.

In general, you'll need to adjust certain properties to match your setup. You'll need to edit the entry for the property that begins with "weblogic.ejb.deploy" in the weblogic.properties file to deploy the EJBean. The property is commented out in the default properties file; make sure that you uncomment out all the lines of the property.

This example is shipped "pre-built"; you can either run it as shipped, or build the example and run it to test that you are able to successfully build and run EJBeans.

These three sections cover what to do:

1. Build the example
2. Set your environment
3. Run the example

## Build the example

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

We provide separate build scripts for Windows NT and UNIX:

- build.cmd for Windows NT

- build.sh for UNIX

These scripts will build the example and place the files in the correct locations:

- Client files: in /myserver/clientclasses
- EJBean: in /myserver/ejb_basic_statelessSession.jar

## Set your environment

Deploy the EJBean by adding the path to the .jar file to the "weblogic.ejb.deploy" property.

We provide a commented-out version in the property that begins with "weblogic.ejb.deploy" that you can use. You'll need to adjust the property depending on which EJBeans you're building and are deploying, or if the location of the files differs from the installed location.

Note: If you're running under the Microsoft SDK for Java, you'll also need to add the path to the .jar to the CLASSPATH for your WebLogic Server.

## Run the example

1. Start the WebLogic Server. You can check that the EJBean has been deployed correctly either by checking the server command line window, or by opening the Console and examining "EJB" under the "Distributed objects"; you should see statelessSession.TraderHome deployed, and can monitor its activity.

2. Run the client in a separate command line window. Set up your client as described in Setting your development environment, and then run the client by entering:

       $ java examples.ejb.basic.statelessSession.Client

   If you're not running the WebLogic Server with its default settings, you will have to run the client using:

       $ java examples.ejb.basic.statelessSession.Client "t3://WebLogicURL:Port"

   where:

   WebLogicURL
     Domain address of the WebLogic Server
   Port
     Port that is listening for connections (weblogic.system.ListenPort)

   Parameters are optional, but if any are supplied, they are interpreted in this order:

     Parameters:
       url - URL such as "t3://localhost:7001" of Server
       user - User name, default null
       password - User password, default null

3. If you're running the Client example, 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 EJB in BEA WebLogic Server Enterprise Java Beans.

Copyright © 1997-2000 BEA Systems, Inc. All rights reserved.

Last updated 03/28/2000