All Examples  All EJB Examples

Package examples.ejb.basic.beanManaged

Enterprise JavaBean bean-managed persistence
example package and classes

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 an entity EJBean called AccountBean.

The example demonstrates:

The Client application performs these steps:
  1. Contacts the Account home ("AccountHome") through JNDI to find the EJBean
  2. Searches for a specific Account ('10020'), and creates it if it can't be found
  3. Part A
    1. Deposits an amount
    2. Attempts to withdraw more than the current balance from the account
    3. Triggers an exception
    4. Automatically rolls back the transaction
  4. Part B
    1. Creates a group of new accounts with different initial balances
    2. Finds all the accounts with a balance greater than a specific value
    3. When finished, removes the new accounts

The Servlet runs in a similar fashion to the Client example. It looks up and calls an EJB and executes similar code to the Client example but as a servlet.

Call this servlet using an appropriate URL as described in the servlet directions. View the changes taking place in the bean by reloading the servlet (use the Reload button).

The MultiClient application demonstrates multiple clients in separate threads calling the EJBean.

how to use this example

To get the most out of this example, first read through the source code files. Start with DeploymentDescriptor.txt 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.

As you'll use a database for the persistent storage of the entity EJBean, you'll need to set it up. Note that the persistent storage is completly invisible to the client; the actual storage is handled by the EJBean directly and not the container.

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:

The "build" scripts build individual examples, such as this entry for Windows:

$ build basic beanManaged
To build under Microsoft's JDK for Java, use
$ build basic beanManaged -ms
These scripts will build the example and place the files in the correct locations:

Set your environment

  1. Set the database persistence

    With database persistence, each instance of an EJBean is written to a row in a table. The table (ejbAccounts) must be created and exist in the database before the example is run. If you are using the evaluation copy of Cloudscape that is included with WebLogic, this table has already been created in the "demo" database.

    You'll need to:

    1. If you're using a database other than Cloudscape, you'll need to create the table in your database using an appropriate SQL statement such as
      "create table ejbAccounts (id varchar(15), bal float, type varchar(15))"

    2. For all databases, setup a connection pool in the weblogic.properties file. For your convenience, a template is included in the file; search for "weblogic.jdbc.connectionPool.demoPool", and uncomment and edit the appropriate lines:
        # You can use this connection pool with any of the EJBean examples.
        # Uncomment to use:
        weblogic.jdbc.connectionPool.demoPool=\
               url=jdbc:cloudscape:demo,\
               driver=COM.cloudscape.core.JDBCDriver,\
               initialCapacity=1,\
               maxCapacity=2,\
               capacityIncrement=1,\
               props=user=none;password=none;server=none
      You can use this pool for Cloudscape. For other databases, you'll need to set an appropriate url and driver, such as
      	  url=jdbc:weblogic:oracle,\
      	  driver=weblogic.jdbc.oci.Driver,\

    3. You'll need to add an access control list (ACL) for users of the pool:
        # Add an ACL for the connection pool:
        weblogic.allow.reserve.weblogic.jdbc.connectionPool.demoPool=everyone

      If you need more information about how to use connection pools, read Using WebLogic JDBC: Using connection pools.

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

    If you're starting the Server from the command line, you'll need to add an entry such as c:/weblogic/eval/cloudscape/lib/cloudscape.jar to the Java system classpath before starting the server, as described in the Administrators Guide Setting up and starting 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 beanManaged.AccountHome 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.beanManaged.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.beanManaged.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
    accountID - String Account ID to test, default "10020"

  3. If you're running the Client example, you should get output similar to this from the client application:
    Beginning beanManaged.client...
    
    Looking up account 10020...
    
    Account 10020 found; balance is $3000.0
    
    Part A: Depositing $100.0
    Current balance is $3100.0
    
    Withdrawing amount greater than current balance. Expecting an exception...
    
    Received expected Processing Error:
    examples.ejb.beanManaged.ProcessingErrorException:
    Request to withdraw $3110.0 more than balance 3100.0 in account 10020
    
    Part B: Creating 5 new accounts...
    Created account: 8952729910070; balance is $0.0
    Created account: 8952729910071; balance is $100.0
    Created account: 8952729910072; balance is $200.0
    Created account: 8952729910073; balance is $300.0
    Created account: 8952729910074; balance is $400.0
    
    5 accounts successfully created
    
    Querying for accounts with a balance greater than 700.0...
    Account 10020; balance is $3100.0
    
    Removing accounts just created...
    Removed account: 8952729910070
    Removed account: 8952729910071
    Removed account: 8952729910072
    Removed account: 8952729910073
    Removed account: 8952729910074
    
    End beanManaged.client...
  4. You can also run the MultiClient (multiple client application):
    $ java examples.ejb.basic.beanManaged.MultiClient
    and the Servlet examples.

    Note: you can only run one instance of the MultiClient at a time; it creates the multiple clients as separate threads, and is dependent on there being only one instance of the MultiClient to monitor the outcome of the example.

there's more

Read more about EJB in the Developers Guide, Using WebLogic Enterprise JavaBeans.

Copyright © 1998-1999 BEA Systems, Inc. All rights reserved.

Last updated 09/09/1999