Package examples.ejb20.sequence.mssqlserver

This example is a package that demonstrates the automatic primary key generation feature with a Microsoft SQL Server database.The example is an entity EJBean calledAccountBean.

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 illustrates how to set up a CMP EJBean to automatically generate the primary key upon insert.

Exception Summary

ProcessingErrorException

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

Package examples.ejb20.sequence.mssqlserver Description

This example is a package that demonstrates the automatic primary key generation feature with a Microsoft SQL Server database.The example is an entity EJBean calledAccountBean.

The example demonstrates:

• Use of an entity EJBean written to the EJB 2.0 specification
• Container-managed JDBC persistence; the code in the EJBeannever directly accesses the data storage
• Using WebLogic's automatic primary key generation feature
• Using application-defined exceptions
• Client application

Pre-Built Examples

The EJB 2.0 examples included in the WebLogic Server 6.1 distribution are not shipped pre-built. To run these examples, you must build the example following the specific examples instructions.

Client application

TheClientapplication performs these steps:

1. Creates two accounts with auto-generated primary keys.
2. Displays the primary key after each account is created.

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

• Client applications
  Client.java

  Interfaces

  Account.java

  AccountHome.java

  Deployment

  ejb-jar.xml

  weblogic-ejb-jar.xml

  weblogic-cmp-rdbms-jar.xml

  Exception

  ProcessingErrorException.java

  Server (EJBean)

  AccountBean.java

Take a look at the XML deployment files ejb-jar.xml, weblogic-ejb-jar.xml and weblogic-cmp-rdbms-jar.xml to find the generalstructure of the EJBean, which classes are used for the differentobjects and interfaces, then look at Client code to see how the application works.

Set up the example

You'll need to set up the persistent storage of theEJBean. You'll use a Microsoft SQL Server database for the persistent storage of the entity EJBean. Each instance ofan EJBean is written to a row in a table. The table (ejbAccounts) must be created and exist in the databasebefore the example is run. A mssqlserver.ddl is included for your convenience.

You'll need to create the a table in Microsoft SQL Server with the Primary Key set as IDENTITY.

Note that the persistent storage is completely invisible to theclient; the actual storage is handled automatically by the containerand not by the EJBean. All database properties, such as the loginname and password, are defined in the connection pool. A preconfigured connection pool is included in the example server.

These three sections cover what to do:

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

Build the example

Set up your development shell as described inSetting 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:
$ant

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

• Client files: in /config/examples/clientclasses
• EJBean: in /config/examples/applications/ejb20_sequence_mssqlserver.jar

Running the build script places the EJB in /config/examples/applications, where it automaticallydeploys once the server is started. If you are already running the server and buildanother EJB, it is automatically placed in this directory and instantly deployed.

Additional information on using the build scriptsis 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 Deployments.

   A list of deployed EJBs displays.

4. Choose the appropriate deployment unit from the list.

5. Select the Target tab in the right pane.

6. Verify that the examplesServer is choosen as the target for the EJB.

7. Setup a connection pool in the Administration Console .

   Although a sample connection pool is provided for many of the EJB 2.0 examples, for this example, you must make sure that your sample connection pool, called demoPool points to the mssqlserverPool.

   You'll need to:

   • Make sure that the connection is available for use.

     # In the left pane, expand the Services node and choose JDBC.

     # Click demoPool to display the configuration information in the right pane.

     # Click the Connections tab and revise the attribute settings, as necessary, to make sure that they are correct.

   Also, make sure that the URL and Driver Classname attributes are set for the correctdatabase. For example, jdriver for Microsoft SQL Server.

   In this example, the fileRealm for the access control list (ACL) is preconfigured to allowaccess for everyone.

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

Run the example

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

   $ java examples.ejb20.sequence.mssqlserver.Client

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

   $ java examples.ejb20.sequence.mssqlserver.Client "t3://WebLogicURL:Port"

   where:

   WebLogicURL

   Domain address of the WebLogic Server

   Port

   Port that is listening for connections(weblogic.system.ListenPort)

2. You should receive output similar to this:

   Beginning sequence.mssqlserver.Client...Starting example...Creating account with a balance of 30000.0 account type Savings...Account successfully createdjust created Account with auto-generated primary key 1Creating account with a balance of 1000.0 account type Checking...Account successfully createdjust created Account with auto-generated primary key 2End example...End sequence.mssqlserver.Client...

There's more...Read more about:

• EJB in theBEA WebLogic Server Enterprise Java Beans