Using JWAVE Beans with BeanBox

This section is a step-by-step exercise that explains how to use JWAVE Beans with JavaBeans Development Kit from Sun Microsystems, Inc. (You must use BDK version 1.0 July 98, or a later version). The latest version of the BDK can be downloaded from the JavaSoft web site:

This exercise uses one invisible Bean, JWAVE Bean tester (which generates some data), and two visible Beans, JWAVE Surface Tool and OrangeButton, to produce a surface plot.

You must add the following files to your CLASSPATH variable:

(UNIX) RW_DIR/classes/JWaveConnectInfo.jar
RW_DIR/classes/JWave.jar
SWINGDIR/swing.jar

(WIN) RW_DIR\classes\JWaveConnectInfo.jar
RW_DIR\classes\JWave.jar
SWINGDIR\swing.jar

where RW_DIR is the main Rogue Wave installation directory, and SWINGDIR is the directory where Swing version 1.1 or later is installed (see the Glossary).

where RW_DIR is the main Rogue Wave installation directory.

where BDKDIR is the directory in which the BeanBox is installed.

When the BeanBox starts, this JAR file is automatically opened and inspected.

Normally, the following script is used to start the BeanBox:

where BDKDIR is the directory where the BeanBox is installed.

note	You can make the CLASSPATH modifications described in Step 1 directly in this script, so that CLASSPATH includes $CLASSPATH (UNIX) or %classpath% (Windows).

Before you start the BeanBox, make sure the JWAVE Manager is running and properly configured (see "Testing to See If the JWAVE Manager is Running").

note	You must CD to the BDKDIR/beanbox directory to run run.sh or run.bat. where BDKDIR is the directory in which the BeanBox is installed.

When you run the BeanBox, the graphical JWAVE Beans and the “invisible” JWAVE Bean tester Bean are listed in the ToolBox along with other Beans that came with the BDK or that you added ( Figure 7-1: JWAVE BeanBox ToolBox on page 92).

Step 4: Try Out the JWAVE Bean Tester and Surface Tool

Remember, the JWAVE Manager must be running to use JWAVE Beans.

1. From the ToolBox, select JWAVE Bean tester, then click in an open area of the BeanBox window to place it as an object in the BeanBox.

2. Select a button (such as OrangeButton) from the ToolBox and place it near the bottom of the BeanBox window.

3. Select the button object in the BeanBox, and then select Edit=>Events=>button push=>actionPerformed.

4. Click over the JWAVE Bean tester object in the BeanBox. This links the button object to the JWAVE Bean tester object.

5. In the EventTargetDialog dialog box, select the start2d target method (this method will form the connection between the JWAVE Bean tester and the push button), then click OK. Now, every time you click the button, the tester Bean will generate new 2D data.

6. In the ToolBox, select JWAVE Surface Tool and place it above the button object in the BeanBox.

7. Resize the Surface Tool Bean until it is big enough to hold a surface plot.

8. Select the JWAVE Bean tester object in the BeanBox, then from the Edit menu, select Events=>propertyChange=>propertyChange.

9. Click over the Surface Tool in the BeanBox. This links the Bean tester to the Surface Tool.

10. In the EventTargetDialog dialog box, select the propertyChange target method as the event, then click OK.

The Bean tester generates 2D data and sends that data to the Surface Tool. Next, the Surface Tool instructs JWAVE to generate a plot. Then the surface plot displays in the BeanBox (see Figure 7-2: JWAVE Surface Tool on page 93).

Each visible JWAVE Bean has a Customizer interface for changing the values of parameters that affect the appearance of the plot.

note	The customizable parameters for JWAVE Beans are described in JWAVE Bean Tools Reference.

1. Select the surface object in the BeanBox, then from the Edit menu, select Events=>Customize. The Customizer window for the JWAVE Surface Tool Bean appears.

2. Change the settings for some of the surface plot’s parameters, then click Done.

3. Click the button in the BeanBox. The surface plot is re-generated and then displayed with the new parameter values applied.