WebLogic Server 7.0 Code Examples, BEA Systems, Inc.

Package examples.ejb11.basic.containerManaged

This example is a package that demonstrates an Enterprise JavaBean.

See:
          Description

Interface Summary
Account The methods in this interface are the public face of AccountBean.
AccountHome This interface is the home interface for the EJBean AccountBean.
 

Class Summary
AccountBean AccountBean is an EntityBean.
Client This class demonstrates calling an entity EJBean, followed by two exercises:
 

Exception Summary
ProcessingErrorException This class is used with the WebLogic EJBean container-managed example package.
 

Package examples.ejb11.basic.containerManaged Description

This example is a package that demonstrates an Enterprise JavaBean. The example is an entity EJBean called AccountBean.

The example demonstrates:

Client application

The Client application performs these steps:
  1. Finds or creates 20 separate accounts
  2. Displays the balance for each account
  3. Finds all accounts with balances over $5000
  4. Finds the first account with a balance of zero
  5. Finds any accounts with a null type
  6. Removes all accounts

To get the most out of this example, first read through the source code files.

Start with the XML deployment files ejb-jar.xml, weblogic-ejb-jar.xml and weblogic-cmp-rdbms-jar.xml to find the general structure of the EJBean, which classes are used for the different objects and interfaces, then look at Client code to see how the application works.

Pre-Built Examples

This EJB 1.1 example is not shipped pre-built. Before you can run this example, you must first build it following the instructions in Build the example.

These four sections cover what to do:

  1. Set Up the Database
  2. Build the example
  3. Configure the server
  4. Run the example

Set Up the database

This example is preconfigured to work with the PointBase database, included with the WebLogic Server distribution. You'll need to set up the persistent storage of the EJBean. You'll use a database for the persistent storage of the entity EJBean. The persistent storage is completely invisible to the client; the actual storage is handled automatically by the container and not by the EJBean. All database properties, such as the login name and password, are defined in the connection pool. A preconfigured connection pool is included in the example server.

With database persistence, each instance of an EJBean is written to a row in a table. If you want or need to run this example with Oracle, see Database SetUp for instructions.

Build the example

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

We provide a build script for you to build the example:

The build script is build.xml.

Run the build script using the following Java ant command:

prompt> ant

The script will build the example and place the files in the correct locations in your WebLogic Server distribution:

Running the build script places the EJB in the %applications% directory, where it automatically deploys once the server is started. If you are already running the server and then build the 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 WebLogic Server.

  2. Start the Administration Console.

  3. Click to expand the Deployments node in the left pane and select EJB.

    A list of deployed EJBs displays.

  4. Choose the EJB that you want to deploy from the list of deployment units.
  5. On the Edit EJB Descriptor page in the right pane, select the Targets tab.

  6. Verify that the EJB is deployed on the examplesServer. The examplesServer should be listed in the Chosen column.

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

Run the example

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

  2. You should receive output similar to this:
    Beginning containerManaged.Client...
    
    Starting Part A of the example...
    
    Creating account 10020 with a balance of 3000.0 account type Savings...
    Account 10020 successfully created
    
    Part A: Depositing $2000
    Current balance is $5000.0
    Attempting to withdraw an amount greater than current balance. Expecting an exception...
    
    Received expected Processing Error:
    examples.ejb11.basic.containerManaged.ProcessingErrorException: Request to withdraw $5001.0; is more than balance $5000.0 in account 10020
    Removing account...
    
    End Part A of the example...
    
    Starting Part B of the example...
    
    Creating account ID: 0 with a balance of 0.0 account type null...
    Account ID: 0 successfully created
    Creating account ID: 1 with a balance of 1000.0 account type Savings...
    Account ID: 1 successfully created
    Creating account ID: 2 with a balance of 2000.0 account type Savings...
    Account ID: 2 successfully created
    Creating account ID: 3 with a balance of 3000.0 account type Savings...
    Account ID: 3 successfully created
    Creating account ID: 4 with a balance of 4000.0 account type Savings...
    Account ID: 4 successfully created
    Creating account ID: 5 with a balance of 5000.0 account type null...
    Account ID: 5 successfully created
    Creating account ID: 6 with a balance of 6000.0 account type Savings...
    Account ID: 6 successfully created
    Creating account ID: 7 with a balance of 7000.0 account type Savings...
    Account ID: 7 successfully created
    Creating account ID: 8 with a balance of 8000.0 account type Savings...
    Account ID: 8 successfully created
    Creating account ID: 9 with a balance of 9000.0 account type Savings...
    Account ID: 9 successfully created
    Creating account ID: 10 with a balance of 10000.0 account type null...
    Account ID: 10 successfully created
    Creating account ID: 11 with a balance of 11000.0 account type Savings...
    Account ID: 11 successfully created
    Creating account ID: 12 with a balance of 12000.0 account type Savings...
    Account ID: 12 successfully created
    Creating account ID: 13 with a balance of 13000.0 account type Savings...
    Account ID: 13 successfully created
    Creating account ID: 14 with a balance of 14000.0 account type Savings...
    Account ID: 14 successfully created
    Creating account ID: 15 with a balance of 15000.0 account type null...
    Account ID: 15 successfully created
    Creating account ID: 16 with a balance of 16000.0 account type Savings...
    Account ID: 16 successfully created
    Creating account ID: 17 with a balance of 17000.0 account type Savings...
    Account ID: 17 successfully created
    Creating account ID: 18 with a balance of 18000.0 account type Savings...
    Account ID: 18 successfully created
    Creating account ID: 19 with a balance of 19000.0 account type Savings...
    Account ID: 19 successfully created
    Account: :ID: 0 has a balance of 0.0
    Account: :ID: 1 has a balance of 1000.0
    Account: :ID: 2 has a balance of 2000.0
    Account: :ID: 3 has a balance of 3000.0
    Account: :ID: 4 has a balance of 4000.0
    Account: :ID: 5 has a balance of 5000.0
    Account: :ID: 6 has a balance of 6000.0
    Account: :ID: 7 has a balance of 7000.0
    Account: :ID: 8 has a balance of 8000.0
    Account: :ID: 9 has a balance of 9000.0
    Account: :ID: 10 has a balance of 10000.0
    Account: :ID: 11 has a balance of 11000.0
    Account: :ID: 12 has a balance of 12000.0
    Account: :ID: 13 has a balance of 13000.0
    Account: :ID: 14 has a balance of 14000.0
    Account: :ID: 15 has a balance of 15000.0
    Account: :ID: 16 has a balance of 16000.0
    Account: :ID: 17 has a balance of 17000.0
    Account: :ID: 18 has a balance of 18000.0
    Account: :ID: 19 has a balance of 19000.0
    
    Querying for accounts with a balance greater than 5000.0...
    Account ID: 6; balance is $6000.0
    Account ID: 7; balance is $7000.0
    Account ID: 8; balance is $8000.0
    Account ID: 9; balance is $9000.0
    Account ID: 10; balance is $10000.0
    Account ID: 11; balance is $11000.0
    Account ID: 12; balance is $12000.0
    Account ID: 13; balance is $13000.0
    Account ID: 14; balance is $14000.0
    Account ID: 15; balance is $15000.0
    Account ID: 16; balance is $16000.0
    Account ID: 17; balance is $17000.0
    Account ID: 18; balance is $18000.0
    Account ID: 19; balance is $19000.0
    
    Querying for an account with zero balance...
    Account ID: 0; balance is zero
    
    Querying for accounts with a null account type
    Account ID: 0; account type is null
    Account ID: 5; account type is null
    Account ID: 10; account type is null
    Account ID: 15; account type is null
    Removing beans...
    End Part B of the example...
    
    
    End containerManaged.Client...
    

There's more...

Read more about:


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

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