<html>
<head>
<meta http-equiv="Content-Language" content="en-us">
<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
<meta name="GENERATOR" content="Microsoft FrontPage 4.0">
<meta name="ProgId" content="FrontPage.Editor.Document">
<title>AspectJ Installation Note</title>
<STYLE TYPE="text/css">
<!--
/* FOR THE SDA PAGE */
/*
BODY {margin-top: 15px; margin-left: 15px; margin-right: 15px;}
*/
A:link {
color:#4756AC;
}
A:visited {
color:#60657B;
}
A:hover {
color:red
}
INPUT {font:12px "Courier New", sans-serif;}
H2 {
font:18px/18px Verdana, Arial, Helvetica, sans-serif;
color:black;
font-weight:bold;
margin-left: 10px;
line-height:110%;
}
H3 {
font:18px/18px Verdana, Arial, Helvetica, sans-serif;
color:black;
font-weight:bold;
margin-left: 10px;
line-height:110%;
}
H4 {
font:15px/16px Verdana, Arial, Helvetica, sans-serif;
color:black;
font-weight:bold;
margin-left: 10px;
line-height:140%;
}
P {
font:13px/13px Verdana, Arial, Helvetica, sans-serif;
margin-right: 10px;
margin-left: 10px;
line-height:130%;
}
.paragraph {
font:13px/13px Verdana, Arial, Helvetica, sans-serif;
margin-right: 10px;
margin-left: 10px;
line-height:130%;
}
.smallParagraph {
font:11px/11px Verdana, Arial, Helvetica, sans-serif;
margin-right: 10px;
margin-left: 10px;
line-height:130%;
}
LI {
font:13px/13px Verdana, Arial, Helvetica, sans-serif;
text-align:justify;
margin-right: 10px;
margin-left: 15px;
line-height:120%;
}
/*
UL {
font:13px/13px Verdana, Arial, Helvetica, sans-serif;
text-align:justify;
margin-right: 10px;
margin-left: 15px;
line-height:120%;
}*/
DL {
font:13px/13px Verdana, Arial, Helvetica, sans-serif;
text-align:justify;
margin-right: 10px;
margin-left: 15px;
line-height:120%;
}
B { font:13px/13px Verdana, Arial, Helvetica, sans-serif;
font-weight:bold;
line-height:140%;
}
.footer {
font:10px/10px Verdana, Arial, Helvetica, sans-serif;
color:#888888;
text-align:left
}
.figureTitle {
font:13px/13px Verdana, Arial, Helvetica, sans-serif;
text-align:justify;
text-align:center
}
.copyrightNotice {
font:10px/10px Verdana, Arial, Helvetica, sans-serif;
color:#999999;
line-height:110%;
}
.smallHeading {
font:13px/13px Verdana, Arial, Helvetica, sans-serif;
font-weight:bold;
line-height:110%;
}
.tinyHeading {
font:11px/11px Verdana, Arial, Helvetica, sans-serif;
font-weight:bold;
line-height:120%;
}
.newsText {
font:11px/11px Verdana, Arial, Helvetica, sans-serif;
line-height:130%;
}
.smallParagraph {
font:11px/11px Verdana, Arial, Helvetica, sans-serif;
line-height:130%;
}
.fancyHeading {
font:20px/20px Chantilly, Arial, Helvetica, sans-serif;
margin-right: 10px;
color:#6f7a92;
margin-left: 10px;
line-height:130%;
}
-->
</STYLE>
</head>
<BODY BGCOLOR="white">
<h3 align="center">AspectJ Demo</h3>
<h4>1. Installing the Demo</h4>
<ul>
<li>Extract the contents of "aspectj-demo.zip" to
"C:\aspectj-demo", resulting in the following directory structure:
<ul>
<li>C:\aspectj-demo
<ul>
<li>apps</li>
<li>bin</li>
<li>examples</li>
<li>slides</li>
</ul>
</li>
</ul>
</li>
<li>Verify that JBuilder 4 is using the correct project by opening it, closing
all of the current projects
<ul>
<li>Under the "File" menu select "Close Projects...",
select all of the open projects and close them</li>
<li>Under the "File" menu select "Open Project...",
and open "C:\aspectj-demo\examples\jbuilder\Spacewar.jpr"</li>
<li>You should now be able to compile "Spacewar". If
ajdeForJBuilder reports any problems refer to
"C:\aspectj-demo\apps\aspectj0.8\doc\primer\tools\ajdeForJBuilder.html"</li>
</ul>
</li>
<li>Set up your "Windows Taskbar" to be permanently visible by
right-clicking the bar, selecting "Properties", and un-checking
"Auto hide"</li>
<li>From your "Windows Explorer" drag the
"C:\aspectj-demo\bin\Demo" folder to the "Windows
Taskbar". This will have the effect of placing the demo buttons
on the taskbar. To remove the buttons drag off the "Demo"
toolbar and close the resulting floating toolbar window.</li>
<li>It is useful to have the "Task Manager" running in the
"System Tray" during the demo in order to see when the debugger is
loading since it is slow. To launch it right-click the "Windows
Taskbar" and select "Task Manager", then minimize the window.
</li>
</ul>
<h4>2. Initial Setup</h4>
<ul>
<li>Emacs Setup
<ul>
<li>Click "Emacs", and move the cursor to the beginning of the
"spacewar.Ship.fire" method</li>
</ul>
</li>
<li>JBuilder Setup
<ul>
<li>Click "JBuilder", open the "AspectJ Structure
View", and bring the editor to the "spacewar.Ship.fire"
method</li>
<li>under the "Spacewar.jpr" node in the "Project
Explorer" (left pane of main window) expand the "spacewar"
package to see its classes</li>
<li>ensure that the last compile was done without "Debug.java"
in the build configuration</li>
</ul>
</li>
<li>Forte Setup
<ul>
<li>Click "Forte", click the "AspectJ Structure View"
button, and navigate the editor to the "spacewar.EnsureShipIsAlive"
class </li>
</ul>
</li>
<li>AJDoc Setup
<ul>
<li>click "AJDoc", browse to the "spacewar/Ship.java"
class</li>
</ul>
</li>
</ul>
<h4>3. Running the Demo</h4>
<ul>
<li>Emacs
<ul>
<li>At the declaration of the "spacewar.Ship.fire" method hit
"<cntrl>x, <cntrl>j"</li>
<li>Follow the resulting popup menu to the "EnsureShipIsAlive"
advice</li>
<li>Navigate back to "spacewar.Ship.fire" using the same method</li>
</ul>
</li>
<li>JBuilder
<ul>
<li>Navigation
<ul>
<li>In the "Structure View" select the "fire"
method and expand it's children to reveal "EnsureShipIsAlive:
around..."</li>
<li>Double-click "EnsureShipIsAlive: around..." to navigate
to that advice declaration</li>
<li>Navigate back using the same method, or using the
"Back", then "Forward" method in conjuntion with
the structure tree (this navigation can also be done by
right-clicking the inline advice icons in the editor's gutter)</li>
</ul>
</li>
<li>Compilation
<ul>
<li>In "EnsureShipIsAlive" remove "ship" from the
"proceed(ship)" call and recompile.</li>
<li>When the error message pops up fix it by replacing
"ship"</li>
</ul>
</li>
<li>Build Configuration
<ul>
<li>Double-click "Default.lst" and select the "lst
Designer" tab at the bottom of the editor pane</li>
<li>Expand the "spacewar" node</li>
<li>Click "Debug.java" in order to add it to the
configuration</li>
<li>Navigate to the "Ship.java" class so that the effects of
the new compilation are visible in the "Structure View"
when the compilation completes</li>
<li>Compile "Default.lst"</li>
<li>Run the project (top the execution of the project by clicking the
red stop button in the run messages pane)</li>
</ul>
</li>
<li>Debugging
<ul>
<li>Start the debugger</li>
<li>When the "Please select launch parameters..." dialog
pops up click "OK"</li>
<li>Select the "Classes" tab (4th tab from the top)</li>
<li>When the game starts, expand "spacewar", expand "Ship.java"</li>
<li>Browse to the "fire" method and expand it</li>
<li>Right-click on the "fire" method and select "stop
in spaceawar.Ship.fire"</li>
<li>Wait for the breakpoint to be hit</li>
<li>Use the "Step Into" button (5th button on the bottom
from the left) to single step the file until you step through the
advice and into the body of the fire method</li>
<li>Click the red stop button (1st button) in order to stop the
debugging</li>
</ul>
</li>
</ul>
</li>
<li>Forte
<ul>
<li>Currently no Forte demo (fyi: navigate the structure the same way as
in JBuilder, and right-click the LST files to compile them, right click
"Game.java" to execute it)</li>
</ul>
</li>
<li>AJDoc
<ul>
<li>Scroll down to the "fire" method, and follow it's
"Advised by: " link to get to the "EnsureShipIsAlive"
aspect</li>
</ul>
</li>
</ul>
<p> </p>
</body>
</html>