CORBA page of the Tools|Enterprise Setup dialog
This is a feature of JBuilder Enterprise.
Select Tools|Enterprise Setup to display the Enterprise Setup dialog. Select the CORBA tab to display the CORBA page.
This help topic explains how to set up JBuilder with an ORB (VisiBroker or OrbixWeb) so that you can create, run, and deploy CORBA applications. The tutorials in this book use the VisiBroker ORB because it is included in some editions of JBuilder. Consult the OrbixWeb documentation for information on particular features of that ORB.
Note: JBuilder writes out configuration settings for this page only if at least one of the settings has changed.
To set up these pieces on your system:
- Install the Java Development Kit (JDK) (this may be installed with JBuilder).
- Install JBuilder.
- Install an ORB, such as VisiBroker or OrbixWeb.
In some versions of JBuilder, VisiBroker, with a development license only, is included on your JBuilder CD. Refer to the VisiBroker documentation for information on installing VisiBroker.
- Run Tools|Enterprise Setup, then select the CORBA tab. Setting the parameters in this dialog enables JBuilder to see the ORB.
- Select Configuration. The initial choices are VisiBroker, OrbixWeb, and None. If you are selecting VisiBroker or OrbixWeb, continue. If you'd like to select a different ORB, go to "Adding a new ORB".
- Click the Edit button.
- Click the ellipsis button next to the Path For ORB Tools field to setup access to the ORB tools. When using VisiBroker, look for the directory that contains the
osagent.exe
file.
- Click the ellipsis next to the Selected Library For Projects field to define a library for the ORB. This is necessary for compiling the generated stubs and skeletons and for executing an application.
- Click New to define a new library.
- Click Add to add a new library. Step 1 of the New Library Wizard appears.
- Browse to the library file. When using VisiBroker, the library file is
vbjorb.jar
.
- Click OK.
- Click Next. Step 2 appears.
- Browse to the directory that contains the JAR files that make up the source code for the library. For VisiBroker, this is the directory that contains
vbjorb.jar
.
- Click Next. Step 3 appears.
- If you'd like, add the path to the directory that contains the documentation for the new library.
- Click Next. Step 4 appears.
- If any other libraries are required for this library to be used, add them here. No additional libraries are required for VisiBroker.
- Click Next. Step 5 appears.
- Enter a name for the library, for example VisiBroker. Select the location for the library file that will be used to store the library specifications.
- Click Finish.
- Click OK to return to the Setup dialog.
- Leave the Apply This Configuration To The Current Project selected if the current project should be set to the same ORB configuration as the default project.
- Leave the Make This Configuration's ORB The Default For The Java VM option selected to use this ORB as the default ORB for the Java VM. If you receive an error message, you may not have sufficient rights to modify the orb.properties file, located in the jdk/jre/lib/ directory. You can manually create and/or edit this file, specifying the following information. This sample file references the VisiBroker ORB.
# Make VisiBroker for Java the default ORB
org.omg.CORBA.ORBClass=com.inprise.vbroker.orb.ORB
org.omg.CORBA.ORBSingletonClass=com.inprise.vbroker.orb.ORB
- Select Add A VisiBroker SmartAgent Item To The Tools Menu to enable the SmartAgent to run as a JBuilder service during development. This option will be disabled if the SmartAgent is not necessary.
- Set the SmartAgent Port to the address where the SmartAgent should be run on the local machine. By default, this is 14000.
- Click OK. These settings will be written to the orb.properties file of the /jdk/jre/lib/ directory.
You've now completed setting up your system to use the JBuilder CORBAExpress features. For a tutorial that uses these features to create a CORBA application, see Exploring CORBA-based distributed applications in JBuilder.
When NONE is selected in the Select Configuration field, the New button is enabled, allowing you to create a custom configuration, for instance, in order to use Sun tools.