Package examples.ejb20.message

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

See:

 

Class Summary

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

Package examples.ejb20.message Description

This example is a package that demonstrates an Enterprise 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

This EJB 2.0 example is shipped pre-built. However, if you want to re-run this example, you can build it following the instructions in Build the example and then re-run it following the instructions in Run the example.

Client application

The Client application 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 source code files.

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. Start the Examples 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: 

prompt> ant

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

  • Client.jar file: in SAMPLES_HOME\server\examples\build\clientclasses
  • EJB (in EAR file): in SAMPLES_HOME\domains\examples\applications\ejb20_message.ear

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 build another EJB, it is automatically placed in this directory and instantly deployed.

Additional information on using the build scripts is found in More About Building Examples.

Start the Examples server

  1. Start the Examples server.

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

Received new quote : BEAS 40 1/8
Received new quote : BEAS 40 1/8
Received new quote : SUNW 79 1/2
Received new quote : SUNW 79 1/2
Received new quote : IBM 82 1/4
Received new quote : IBM 82 1/4

End message.Client...

There's more...

Read more about EJB in BEA WebLogic Server Enterprise Java Beans.