blob: ae4c32b184585dd01ad8bc889deb657a7a5ec1a3 [file] [log] [blame]
<html><head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>The AspectJtm Development Environment Guide</title><link rel="stylesheet" href="aspectj-docs.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.44"><link rel="home" href="index.html" title="The AspectJtm Development Environment Guide"><link rel="next" href="tools-intro.html" title="Chapter 1. Introduction to the AspectJ tools"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">The AspectJ<sup>tm</sup> Development Environment Guide</th></tr><tr><td width="20%" align="left">&nbsp;</td><th width="60%" align="center">&nbsp;</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="tools-intro.html">Next</a></td></tr></table><hr></div><div class="book" id="d0e1"><div class="titlepage"><div><h1 class="title"><a name="d0e1"></a>The AspectJ<sup>tm</sup> Development Environment Guide</h1></div><div><h3 class="author">the AspectJ Team</h3></div><div><div class="legalnotice"><p>Copyright (c) 1998-2001 Xerox Corporation,
2002 Palo Alto Research Center, Incorporated,
2003-2005 Contributors.
All rights reserved.
</p></div></div><div><div class="abstract"><p><a name="d0e15"></a><b>Abstract</b></p><p>
This guide describes how to build and deploy AspectJ programs
using the AspectJ tools and facilities. See also
<a href="../progguide/index.html" target="_top">The
AspectJ Programming Guide</a>,
the documentation available with the AspectJ support available for
various integrated development environments (e.g.,
<a href="http://eclipse.org/ajdt" target="_top">Eclipse AJDT</a>),
and the most-recent documentation available from
the AspectJ project page, at
<a href="http://eclipse.org/aspectj" target="_top">
http://eclipse.org/aspectj</a>.
</p></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt>1. <a href="tools-intro.html">Introduction to the AspectJ tools</a></dt><dd><dl><dt><a href="tools-intro.html#eclipse-aspectj">The Eclipse AspectJ implementation</a></dt><dt><a href="bytecode-concepts.html">Bytecode weaving, incremental compilation, and memory usage</a></dt><dd><dl><dt><a href="bytecode-concepts.html#classpathInpathAndAspectpath">Classpath, inpath, and aspectpath</a></dt></dl></dd></dl></dd><dt>2. <a href="command-line-tools.html">AspectJ command-line tools</a></dt><dd><dl><dt><a href="command-line-tools.html#ajc-ref-top"><tt>ajc</tt>, the AspectJ compiler/weaver</a></dt><dt><a href="ajdoc-ref-top.html"><tt>ajdoc</tt>, the AspectJ documentation tool</a></dt><dt><a href="aj-ref-top.html"><tt>aj</tt>, the AspectJ load-time weaving script</a></dt></dl></dd><dt>3. <a href="ajbrowser.html">AspectJ Browser</a></dt><dd><dl><dt><a href="ajbrowser.html#ajbrowser-intro">Introduction</a></dt><dt><a href="ajbrowser-building.html">Building Programs</a></dt><dd><dl><dt><a href="ajbrowser-building.html#build-configurations">Build Configurations</a></dt><dt><a href="ajbrowser-building.html#compiling-a-program-build-configuration">Compiling a Program Build Configuration</a></dt></dl></dd><dt><a href="ajbrowser-navigating.html">Navigating Program Structure</a></dt><dd><dl><dt><a href="ajbrowser-navigating.html#example">Example: Exploring the "Spacewar" sample code </a></dt></dl></dd><dt><a href="ajbrowser-running.html">Running Programs</a></dt><dt><a href="ajbrowser-problems.html">Isolating problems running the AspectJ browser</a></dt><dd><dl><dt><a href="ajbrowser-problems.html#ajbrowser-knownProblems">Known issues with the AspectJ browser</a></dt><dt><a href="ajbrowser-problems.html#ajbrowser-limitations">Limitations</a></dt><dt><a href="ajbrowser-problems.html#ajbrowser-feedback">AspectJ Browser questions and bugs</a></dt></dl></dd></dl></dd><dt>4. <a href="antTasks.html">AspectJ Ant Tasks</a></dt><dd><dl><dt><a href="antTasks.html#antTasks-intro">Introduction</a></dt><dt><a href="antTasks-install.html">Installing Ant Tasks</a></dt><dt><a href="antTasks-iajc.html">AjcTask (iajc)</a></dt><dd><dl><dt><a href="antTasks-iajc.html#antTasks-iajc-options">AjcTask (iajc) Options</a></dt><dt><a href="antTasks-iajc.html#antTasks-nested-includes">AjcTask matching parameters specified as nested elements</a></dt><dt><a href="antTasks-iajc.html#antTasks-iajc-paths">AjcTask Path-like Structures</a></dt><dt><a href="antTasks-iajc.html#antTasks-iajc-sample">Sample of iajc task</a></dt><dt><a href="antTasks-iajc.html#antTasks-iajc-uptodate">Avoiding clean compiles</a></dt><dt><a href="antTasks-iajc.html#programmatically-handling-compiler-messages">Programmatically handling compiler messages</a></dt></dl></dd><dt><a href="antTasks-adapter.html">Ajc11CompilerAdapter (javac)</a></dt><dd><dl><dt><a href="antTasks-adapter.html#antTasks-adapter-sample">Sample of compiler adapter</a></dt><dt><a href="antTasks-adapter.html#antTasks-adapter-options">Compiler adapter compilerarg options</a></dt></dl></dd><dt><a href="antTasks-ajc.html">Ajc10 (ajc)</a></dt><dd><dl><dt><a href="antTasks-ajc.html#antTasks-ajc-options">Ajc10 (ajc) Options</a></dt><dt><a href="antTasks-ajc.html#antTasks-ajc-nested">Ajc10 parameters specified as nested elements</a></dt><dt><a href="antTasks-ajc.html#antTasks-ajc-sample">Sample of ajc task</a></dt></dl></dd><dt><a href="antTasks-problems.html">Isolating problems running the Ant tasks</a></dt><dd><dl><dt><a href="antTasks-problems.html#antTasks-knownProblems">Known issues with the Ant tasks</a></dt><dt><a href="antTasks-problems.html#antTasks-feedback">Ant task questions and bugs</a></dt></dl></dd></dl></dd><dt>5. <a href="ltw.html">Load-Time Weaving</a></dt><dd><dl><dt><a href="ltw.html#ltw-introduction">Introduction</a></dt><dd><dl><dt><a href="ltw.html#weaving-class-files-more-than-once">Weaving class files more than once</a></dt></dl></dd><dt><a href="ltw-rules.html">Load-time Weaving Requirements</a></dt><dt><a href="ltw-configuration.html">Configuration</a></dt><dd><dl><dt><a href="ltw-configuration.html#enabling-load-time-weaving">Enabling Load-time Weaving</a></dt><dt><a href="ltw-configuration.html#configuring-load-time-weaving-with-aopxml-files">Configuring Load-time Weaving with aop.xml files</a></dt><dt><a href="ltw-configuration.html#concrete-aspect">Using Concrete Aspects</a></dt><dt><a href="ltw-configuration.html#concrete-aspect-precedence">Using Concrete Aspects to define precedence</a></dt><dt><a href="ltw-configuration.html#weaver-options">Weaver Options</a></dt></dl></dd><dt><a href="ltw-specialcases.html">Special cases</a></dt><dt><a href="ltw-packaging.html">Runtime Requirements for Load-time Weaving</a></dt><dt><a href="ltw-agents.html">Supported Agents</a></dt><dd><dl><dt><a href="ltw-agents.html#jvmti">JVMTI</a></dt><dt><a href="ltw-agents.html#jrockit">JRockit with Java 1.3/1.4 (use JVMTI on Java 5)</a></dt></dl></dd></dl></dd><dt>6. <a href="compatibility.html">AspectJ version compatibility</a></dt><dd><dl><dt><a href="compatibility.html#versionCompatibility">Version Compatibility</a></dt><dd><dl><dt><a href="compatibility.html#javaCompatibility">Java compatibility</a></dt><dt><a href="compatibility.html#runtimeCompatibility">Runtime library compatibility</a></dt><dt><a href="compatibility.html#binaryCompatibility">Aspect binary compatibility</a></dt><dt><a href="compatibility.html#sourceCompatibility">Aspect source compatibility</a></dt><dt><a href="compatibility.html#upgrading">Problems when upgrading to new AspectJ versions</a></dt></dl></dd></dl></dd></dl></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left">&nbsp;</td><td width="20%" align="center">&nbsp;</td><td width="40%" align="right">&nbsp;<a accesskey="n" href="tools-intro.html">Next</a></td></tr><tr><td width="40%" align="left">&nbsp;</td><td width="20%" align="center">&nbsp;</td><td width="40%" align="right">&nbsp;Chapter 1. Introduction to the AspectJ tools</td></tr></table></div></body></html>