AspectJ Development Environment Support for Borland® JBuilder^TM

Contents

1. Overview
2. IDE Window and AspectJ Structure View
3. AspectJ Console (JBuilder 3.5)
4. Setting up, compiling, and running Spacewar in JBuilder 4
5. Setting up, compiling, and running Spacewar in JBuilder 3.5

AspectJ Development Environment (AJDE) support for JBuilder is an extension to Borland's JBuilder.  AJDE for JBuilder will allow you to

• compile AspectJ and Java files within the IDE
• set up a compile configuration that determine which files will be passed to the compiler
• browse the structure of your AspectJ program

The following figure demonstrates a typical view of AspectJ Support for JBuilder running:

1. The AspectJ Support for JBuilder buttons
   1. The "AJ" button opens the Structure View
   2. This button launches the AspectJ Support for AspectJ Console
   3. The "compile with ajc" button
   4. The "run" button
2. The Structure View showing the structure for the currently selected class
   • The Structure View displays the structure of the AspectJ program; here we see that the "static around(Ship)" advice action affects 4 different methods on the "Ship" class.  To navigate to these methods simply double click their entries in the tree.
3. The structure view navigation and auto-arrange buttons
   • Since navigating the Structure View can cause you to jump between files internet browser style "forward" and "back" buttons are provided
   • The auto-arrange button will tile the JBuilder window with the Structure View window

1. Configuration tab
   • This pane allows you to select the files that will be passed to the compiler
2. Messages tab
   • This pane displays the compile command passed to ajc as well as the corresponding output
3. "Debug.java" removed from the files passed to ajc
   • the "Debug.java" has been removed from the current configuration.  Once "OK" is clicked that file will no longer be passed to the compiler.

To set up the examples/spacewar example (available for download at the bottom of the  Download Page) you can use the following steps as a guideline:

Step 1: set up Spacewar as a JBuilder project

• Launch JBuilder 4
• In the "File" menu select "New Project..."
• Fill out the fields according to the following screenshot and then click "Next >"

Step 2: adding "aspectjrt.jar" as a project library

• In the "Project wizard - Step 2 of 3" window under "Required Libraries" select "Add".
• When the "Select One or More Libraries" dialog comes up click "New...".
• In the "New Library Wizard" create the "AspectJ Runtime" library using your corresponding "jbuilder4/lib/ext/aspectjrt.jar" path by clicking the "Add" button.

• Click "OK" out of both dialog boxes, and then click "Finish":

Step 3: adding sources to your project

• In the "Project Explorer (left and uppermost pane in the IDE) right click on "Spacewar.jpr" and select "Add Files / Packages...".
• Click the "Packages" tab.
• Select both "spacewar" and "coordination" by cntrl-clicking them and click "OK".

Step 4: setting up the build configuration and compiling

• AJDE currently only supports one build configuration is taken from a file called "Default.lst" in your project's root directory.  If you try to compile without this file AJDE will create it for you and you can modify it accordingly.

• Before running please see the Note for java.awt Users.
• When the compile finishes, click "AspectJ Run" in the "Tools" menu.
• If you have not selected a class to run, you will be prompted to do so: click "OK" in the prompt dialog.
• In the "Project Properties" dialog that pops up select the "Run" tab.
• In the "Main class: " selection click "..."
• open up the "spacewar" package, select "Game" and click "OK".
• Click "AspectJ Run" again to run Spacewar.

To set up the examples/spacewar example (available for download at the bottom of the  Download Page) you can use the following steps as a guideline:

1. launch JBuilder 3.5
2. in the "File" menu select "New project"
   1. click "Browse" and locate the "aspectj/examples" directory
   2. type "Spacewar.jpr" into the dialog box to save the project file in that directory (note, since the Spacewar example uses both the "spacewar" and "coordination" packages the project is set up in the root examples directory) and click "Save" to close the "New Project File" dialog box
   3. click "Finish"
3. in the "Project" menu select "Project properties..."
   1. set the "Output path" entry to be the directory where you want your classes to go
   2. in the "Source" tab select the entry and click "Edit" (by default JBuilder will set this directory to be "examples/src" which does not exist)
   3. once the "Select a path" dialog appears simply click "OK" since this will select the "examples" directory
   4. click "OK" to close the "Project Properties" dialog
4. in the leftmost pane you will notice "Spacewar.jpr", right click this and select "Add to project" in the popup, then "Add class/package..." in the next popup
5. <cntrl> click "spacewar" and "coordination" and then click "OK"; this will add the two packages to your project
6. open the AspectJ Support for JBuilder Console
7. you can remove "Debug.java" (this aspect adds considerable overhead to the compile) by clicking it, then click "OK" to save the build configuration and close the console
8. click the "Compile" button to compile the project
9. open the Structure View to browse the structure of the program
10. click the "Run" button to play Spacewar
    1. if you have not selected a class to run, you will be prompted to do so: click "OK" in the prompt dialog, then 
    2. in the "Project Properties" dialog that pops up select the "Run" tab
    3. under "Application" click "Set..."
    4. open up the "spacewar" package, select "Game" and click "OK"