|
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310 |
- <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>
|