Jeff Davies

Using the sample code is easy. First, be sure that you downloaded the correct sample code for your version of Oracle Service Bus (OSB) or AquaLogic Service Bus (ALSB). The downloads page has versions for OSB 10gR3, OSB v3.0, ALSB v3.0 and ALSB v2.6.

Next, you need to run the WorkShop IDE that was installed when you installed your OSB or ALSB product. When the IDE is fullly loaded and running, select File -> Import from the main menu bar. This will launch the Import Wizard. Select the Existing Projects into Workspace inside of the General folder. Press the Next button.

Next, select the Select archive file radio button, and then browse to the source code file that you downloaded from this site. Be sure to select all projects within the archive file. After you import all of the source code, wait for several minutes to ensure that the IDE has finished rebuilding its workspace.

Once the workspace is completely rebuilt, you may see a number of error messages next to some of the projects. This is because these projects are using some additional libraries that Eclipse/Workshop cannot find. If you do not see these errors, your import is complete. If you see an error, then keep reading.

To help Workshop find the missing libraries, you need to define the BEA_HOME variable within the Workshop IDE. To do that, right-click on one of the projects and select the Properties entry from the popup menu. In the Properties dialog, select the Java Build Path entry in the list on the left side of the dialog and then be sure the Libraries tab is selected.

Press the Add Variable button. This will display the New Variable Classpath Entry dialog. Press the Configure Variables... button. This brings up yet another dialog that lists the existing classpath variables. Press the New... button and create a new variable named BEA_HOME and then press the Folder... button to enter the main directory of the OSB 10gR3 installation folder. If you used the default installation folder, then the correct path is C:\BEA on a windows machine.

That's all there is to it.

There are 2 possible errors that you will encounter when you try to deploy the projects from the Workshop IDE to the server that you created in chapter 2. Two of the errors are likely and one may not occur because I have fixed the sample code.

Error 1 - Deploying multiple configuration files

You will get an error complaining that you tried to deploy more than one Oracle Service Bus Configuration project to the server. To fix this, simply remove the Do Not Use Conf configuration project from the server. Actually, feel free to delete it completely.

Error 2 - "Potential Error" dialog on deployment

This is caused because some of the projects depend on specific configurations within the WebLogic server. There are two steps you need to do to address this. First is to run the all Ant target in the build.xml file that you will find in the BookSetup project. This will create some JMS queues that are needed by several projects that work with JMS in the book.

The second step is to remove the Security_SB project (contained in the OSB10gR3_Book_Conf configuration project) from its parent configuration project. Either delete it completely or drag and drop the Security_SB project into a different configuration project (that you will have to create first) until you need it in Chapter 11.

Verify that the correct Java machine is first in your PATH environment variable. I find that Eclipse/Workshop relies on your JAVA_HOME and PATH environmental settings/