123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215 |
- <refentry>
- <refnamediv>
- <refname>
- AspectJ Development Environment (AJDE) support for Forte
- </refname>
- <refpurpose>
- Module extension to Sun's <ulink url="http://www.sun.com/forte/ffj">Forte
- for Java</ulink> and
- <ulink url="http://netbeans.org">NetBeans</ulink> IDEs.
- </refpurpose>
- </refnamediv>
-
- <refsect1>
- <title>Overview</title>
- <para>
- For release-specific documentation refer to the <ulink
- url="http://aspectj.org/doc/dist/changes.html"> changes file</ulink>.
- </para>
-
- <para>
- AJDE for Forte will allow you to:
- <itemizedlist>
-
- <listitem><para>compile AspectJ and Java files within the
- IDE</para></listitem>
-
- <listitem><para>browse the structure of your AspectJ
- program</para></listitem>
-
- <listitem><para>set up a compile configuration that determine which
- files will be passed to the compiler</para></listitem>
-
- </itemizedlist>
- </para>
- </refsect1>
-
- <refsect1>
- <title>Installation</title>
- <para>
-
- <itemizedlist>
- <listitem><para>use the installer to place the "ajdeForForte.jar" and
- "aspectjrt.jar" into the modules directory. This will also install
- the two html files "LICENCE-AJDEFORTE.html" and
- "README-AJDEFORTE.html".</para></listitem>
-
- <listitem><para>start up, and in the "Tools" menu select "Global
- Options" </para></listitem>
-
- <listitem><para>right-click the "Modules" item and select "New Module
- from File..." </para></listitem>
-
- <listitem><para>find the ajdeForForte.jar in the directory that you
- installed into (e.g. c:/forte4j/modules) and select it
- </para></listitem>
- </itemizedlist>
-
- </para>
- <para>
- To uninstall follow Forte's documentation on un-installing modules, or
- simply remove the file modules/aspectjForForte.jar from Forte's
- install directory.
- </para>
- </refsect1>
-
- <refsect1>
- <title>Running AJDE for Forte</title>
- <para>
- <emphasis role="strong">3.1 Setting up the AspectJ Examples (in
- NetBeans 3.3.1)</emphasis>
-
- <imageobject>
- <imagedata fileref="netbeans-building.gif"/>
- </imageobject>
-
- <itemizedlist>
-
- <listitem><para>in the "Project" menu select "Project Manager"
- </para></listitem>
-
- <listitem><para>Click "New..." and enter "AspectJ Examples" as the
- projects' name and click "OK". </para></listitem>
-
- <listitem><para>In the "Filesystems" Explorer tab right click
- "Filesystems", then select "Mount -> Local Directory".
- </para></listitem>
-
- <listitem><para>browse into the AspectJ install directory (e.g.
- "C:/apps/aspectj1.0") </para></listitem>
-
- <listitem><para>select "examples" and click "Finish"
- </para></listitem>
-
-
- <listitem><para>In the "Tools" menu select "AspectJ -> Start AJDE"
- or just click on the "AJDE"
- (<inlinemediaobject>
- <imageobject>
- <imagedata fileref="startAjde.gif"/>
- </imageobject>
- </inlinemediaobject>)
- button (shown as label 1 of the screenshot).
- </para></listitem>
-
- </itemizedlist>
- </para>
- <para>
- <emphasis role="strong">3.2 Compiling the Spacewar Example</emphasis>
-
- <itemizedlist>
-
- <listitem><para>After AJDE is started, a new "AspectJ" tab is added
- to the explorer window. Click it. The next thing to do is to choose
- a particular build, since there are many in the examples
- distribution. To the right of the "Build" button
- (<inlinemediaobject>
- <imageobject>
- <imagedata fileref="build.gif"/>
- </imageobject>
- </inlinemediaobject>)
- there is a downward arrow. Click it, and select "spacewar/demo.lst"
- (as in label 2 of the screenshot). This will start a build of the
- demo configuration of spacewar. Clicking the "Build" button will
- rebuild. </para></listitem>
-
- <listitem><para>When the compile is finished and the "AspectJ
- Explorer" structure is present navigate the structure by clicking
- nodes (as shown in label 3 of the screenshot). Note that
- associations between nodes appear with UML-style arrow icons and
- italicized names and reperesent how a particular node in the
- structure relates to others. In order to navigate these associations
- expand the notes and click the corresponding links (in blue). These
- links represent structure nodes elsewhere in the tree.
- </para></listitem>
-
- <listitem><para>If there are compilation errors, clickable messages
- will appear (as in label 4 of the screenshot).
- </para></listitem>
-
- </itemizedlist>
-
- </para>
- <para>
-
- <emphasis role="strong">3.3 Running the Spacewar Example</emphasis>
- <itemizedlist>
- <listitem><para>
- In the "Filesystems" Explorer tab open the "spacewar"
- directory, right click "spacewar/Game.java", and the select
- "Execute".
- </para></listitem>
-
- <listitem><para>When finished executing switch back to the "Editing"
- mode.</para></listitem>
-
- <listitem><para>Select and build the "debug.lst" configuration as
- described in 3.2 and execute again--you will notice that the debug
- configuration adds a debug window used for tracing by including the
- "Debug.java" aspect in the compile.</para></listitem>
- </itemizedlist>
-
- </para>
-
- <emphasis role="strong">3.4 Debugging the Spacewar Example</emphasis>
-
- <itemizedlist>
- <listitem><para>
- You must first add the filesystem to the project so
- that the debugger can see the main class. Do this in
- the "Project AspectJ Examples" tab in the explorer by
- right clicking the root node and selecting "Add
- Existing...".
- </para></listitem>
-
- <listitem><para>You may now need to add the AspectJ Runtime to the
- project so that the debugger can see it. In the same way as described
- in 3.1 select "Mount -> Archive (JAR, Zip)". </para></listitem>
-
- <listitem><para>Browse to the your lib/ext/aspectjrt.jar file within
- your NetBeans install directory and click "Finish".</para></listitem>
-
- <listitem><para>
- Select "Project -> Set Project Main Class..." in the
- menu bar, browse to "spacewar/Game.java" in the
- examples directory that you created and click "OK".
- </para></listitem>
-
- <listitem><para>
- In the "Filesystems" Explorer tab open the "spacewar"
- directory, click "Game.java", and the select "Debug
- -> Strat" from the menu bar.
- </para></listitem>
- </itemizedlist>
-
- <para>
- AspectJ-related options can be modified in the AJDE settings window.
- </para>
- <imageobject>
- <imagedata fileref="netbeans-buildOptions.gif"/>
- </imageobject>
-
-
-
-
-
-
- </refsect1>
- </refentry>
-
- <!-- Local variables: -->
- <!-- fill-column: 79 -->
- <!-- compile-command: "ant -quiet dev-html" -->
- <!-- sgml-local-ecat-files: devguide.ced -->
- <!-- sgml-parent-document:("devguide.sgml" "book" "refentry") -->
- <!-- End: -->
|