Building, Deploying, and Running the clientmdbentity Example Using NetBeans IDE

To build, deploy, and run the application using NetBeans IDE, do the following:

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, if it is not already running.

3. In NetBeans IDE, choose Open Project from the File menu.

4. In the Open Project dialog, navigate to tut-install/javaeetutorial5/examples/jms/.

5. Select the clientmdbentity folder.

6. Select the Open as Main Project check box and the Open Required Projects check box.

7. Click Open Project.

8. Right-click the clientmdbentity project and choose Build.

   This task 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

9. Right-click the project and choose Undeploy and Deploy.

10. Right-click the project and choose Run.

    This command returns a JAR file named clientmdbentityClient.jar and then executes it.

The output of the application client in the Output pane looks something like this:

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.

You can run the application client repeatedly.

Undeploy the application after you finish running the client. To undeploy the application, follow these steps:

1. Click the Services tab.

2. Expand the Servers node.

3. Expand the Sun Java System Application Server node.

4. Expand the Applications node.

5. Expand the Enterprise Applications node.

6. Right-click clientmdbentity and choose Undeploy.

To remove the generated files, right-click the clientmdbentity project and choose Clean.