Building, Deploying, and Running the clientmdbentity Example Using Ant

To create and package the application using Ant, perform these steps:

1. Start the Application Server, if it is not already running.

2. Start the database server as described in Starting and Stopping the Java DB Database Server.

3. Go to the following directory:

   tut-install/javaeetutorial5/examples/jms/clientmdbentity/
   

4. To compile the source files and package the application, use the following command:

   ant

The ant command creates the following:

• An application client JAR file that contains the client class and listener class files, along with a manifest file that specifies the main class

• An EJB JAR file that contains the message-driven beans and the entity class, along with the persistence.xml file

• An application EAR file that contains the two JAR files along with an application.xml file

To deploy the application and run the client, use the following command:

ant run

Ignore the message that states that the application is deployed at a URL.

The program output in the terminal window looks something like this:

running application client container.
PUBLISHER: Setting hire ID to 25, name Gertrude Bourbon, position Senior Programmer
PUBLISHER: Setting hire ID to 26, name Jack Verdon, position Manager
PUBLISHER: Setting hire ID to 27, name Fred Tudor, position Manager
PUBLISHER: Setting hire ID to 28, name Fred Martin, position Programmer
PUBLISHER: Setting hire ID to 29, name Mary Stuart, position Manager
Waiting for 5 message(s)
New hire event processed:
  Employee ID: 25
  Name: Gertrude Bourbon
  Equipment: Laptop
  Office number: 183
Waiting for 4 message(s)
New hire event processed:
  Employee ID: 26
  Name: Jack Verdon
  Equipment: Pager
  Office number: 20
Waiting for 3 message(s)
New hire event processed:
  Employee ID: 27
  Name: Fred Tudor
  Equipment: Pager
  Office number: 51
Waiting for 2 message(s)
New hire event processed:
  Employee ID: 28
  Name: Fred Martin
  Equipment: Desktop System
  Office number: 141
Waiting for 1 message(s)
New hire event processed:
  Employee ID: 29
  Name: Mary Stuart
  Equipment: Pager
  Office number: 238

The output from the message-driven beans and the entity class appears in the server log, wrapped in logging information.

For each employee, the application first creates the entity and then finds it. You may see runtime errors in the server log, and transaction rollbacks may occur. The errors occur if both of the message-driven beans discover at the same time that the entity does not yet exist, so they both try to create it. The first attempt succeeds, but the second fails because the bean already exists. After the rollback, the second message-driven bean tries again and succeeds in finding the entity. Container-managed transactions allow the application to run correctly, in spite of these errors, with no special programming.

Undeploy the application after you finish running the client:

ant undeploy

To remove the generated files, use the following command in the clientmdbentity, clientmdbentity-app-client, and clientmdbentity-ejb directories:

ant clean