Package examples.ejb20.message

This example is a package that demonstrates anEnterprise Java Message Bean written to the EJB 2.0 specification.

See:
Description

Class Summary

Client	This class illustrates calling a Message-Driven bean and publishing quotes on a topic.
MessageTraderBean

Package examples.ejb20.message Description

This example is a package that demonstrates anEnterprise Java Message Bean written to the EJB 2.0 specification.

The example demonstrates:

• Usage of an entity EJBean written to the EJB 2.0 specification
• 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. Calls a Message-Driven bean
2. Publishes quotes on a topic
3. Prints the messages to the server shell after the Client example is run

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

• Client applications
  Client.java

  Deployment

  ejb-jar.xml

  weblogic-ejb-jar.xml

Start with the XML deployment files ejb-jar.xml and weblogic-ejb-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.

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 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:
$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_message.jar

Running the build script places the EJB in /config/examples/applications, 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 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-hand pane.

6. Verify that the EJB is deployed on the examplesServer.

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:

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

   where:

   WebLogicURL

   Domain address of the WebLogic Server

   Port

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

2. If you're running the Client example, you should get output similar to this from the client application in the server shell:

   In client shell:Beginning message.Client...End message.Client...In server.shell:setMessageDrivenContext calledejbCreate calledReceived new quote : BEAS 40 1/8Received new quote : BEAS 40 1/8Received new quote : SUNW 79 1/2Received new quote : SUNW 79 1/2Received new quote : IBM 82 1/4Received new quote : IBM 82 1/4End message.Client...

There's more...

Read more about EJB in BEA WebLogicServer Enterprise Java Beans.