mirrors
/
org.aspectj
şunun yansıması https://github.com/eclipse/org.aspectj.git


			
							123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318
							<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html> <head>
<LINK rel="STYLESHEET" href="../style.css">
<!--  type="text/css": Error: no attribute "TYPE" for this element (in 3.2) -->
<title>AspectJ Documentation and Resources</title>
</head>
<body>
<a name="top"></a>
<h1>AspectJ Documentation and Resources</h1>
<p> 
    AspectJ <sup><small>tm</small></sup>
    is a seamless aspect-oriented extension to 
    Java<sup><small>tm</small></sup>.
    The compiler and development tools are available under 
    an open-source license, require Java 2 to run, and produce
    code that runs in JDK 1.1 and later VM's. 
    For the latest materials, see
    <a href="@aspectj.home.url@">@aspectj.home.url@</a>,
    especially the <a href="@aspectj.home.url@/faq">FAQ</a>.
<p>

<table>
    <tr><td><u>Section</u></td><td><u>Contents</u></td></tr>
    <tr><td><a href="#documentation">docs</a></td><td>
       <a href="faq.html">FAQ</a>, 
       <a href="quick.pdf">Quick Reference</a>, 
       <a href="progguide/index.html">programming</a> and 
       <a href="devguide/index.html">development</a> guides, 
       <a href="api/overview-summary.html">API</a> and
       <!-- start strip -->
       (<a href="examples/">local</a>) 
       <!-- end strip -->
       examples
    <tr><td><a href="#distributions">distributions</a></td><td>  
        <a href="@aspectj.home.url@/dist">AspectJ</a> itself
        and development environment support for 
        <a href="http://eclipse.org/ajdt">Eclipse</a>, 
        <a href="http://aspectj4emacs.sourceforge.net">Emacs</a>, 
        <a href="http://aspectj4jbuildr.sourceforge.net">JBuilder</a>, 
        and
        <a href="http://aspectj4netbean.sourceforge.net">Netbeans</a>. 
        
    <tr><td><a href="#resources">resources</a></td><td>
       <a href="http://aosd.net">aosd.net</a>;
       <a href="@aspectj.home.url@">AspectJ project</a>
       the bug <a href="@aspectj.home.url@/bugs">db</a>,
       and mailing lists for 
       <a href="mailto:aspectj-users@eclipse.org">users</a> and
       <a href="mailto:aspectj-dev@eclipse.org">developers</a>.
    <tr><td><a href="#paths">paths</a> </td><td>for those new to AspectJ
</table>
<p>

<a name="documentation"></a>
<h3>AspectJ documentation</h3>
<table border="1">
<tr> <th>Documentation</th><th>Description</th> 
     </tr>

<tr> <td><a href="quick.pdf"> AspectJ Quick Reference</a>
       <!-- start strip -->
         (<a href="@aspectj.home.url@/doc/dist/quick.pdf">web</a>)
       <!-- end strip -->
     </td>
     <td>This is a two-page quick reference for the AspectJ language. 
     </td> </tr>


<tr> <td><a href="progguide/index.html">Programming Guide</a>
         (printable <a href="progguide.pdf">pdf</a> or <a href="progguide/printable.html">html</a>
         <!-- start strip -->
         - <a href="@aspectj.home.url@/doc/dist/progguide/index.html">web</a>
         <!-- end strip -->
         )
     </td>
     <td>This introduces AOP and the AspectJ language.  
      <a href="progguide/ch01.html">Getting Started</a>
     describes basic semantics, and shows development- and production-time applications.
     <a href="progguide/ch02.html">The AspectJ Language</a>
     describes join points, pointcuts, advice, and introduction, all features new to AOP. 
     <a href="progguide/ch03.html">Examples</a> walks you through the 
     examples included with the documentation, and there are two short
     chapters on useful <a href="progguide/ch04.html">Idioms</a> and a
     few <a href="progguide/ch05.html">Pitfalls</a>
     The appendices have reference information:
     the <a href="progguide/apa.html">Quick Reference</a>
     summarizes AspectJ syntax,
     the <a href="progguide/apb.html">Language Semantics</a>
     best describes AspectJ usage, and 
     <a href="progguide/apc.html">Implementation Limitations</a> notes that
     the current version is limited to code the compiler controls.</td>
     </tr>

<tr> <td><a href="devguide/index.html">Development Environment Guide</a><br>
         
         (printable <a href="devguide/printable.html">html</a>
       <!-- start strip -->
         - <a href="@aspectj.home.url@/doc/dist/devguide/index.html">web</a>
       <!-- end strip -->
       )
     </td>
     <td>Find here a guide to the command-line compiler <u><tt>ajc</tt></u> 
     and API doc tool <u><tt>ajdoc</tt></u>, as well as
     the <u>AspectJ Development Environment (AJDE)</u> for managing crosscutting
     structure in JBuilder, Forte, Emacs, and the stand-alone <tt>ajbrowser</tt>.
     (For using <tt>ajc</tt> and <tt>ajdoc</tt> in 
     <a href="http://jakarta.apache.org/ant">Ant</a> builds,
     see the <code>taskdefs</code> distribution.)
     </td>
     </tr>

<tr> <td><a href="api/overview-summary.html">AspectJ API</a> 
       <!-- start strip -->
         (<a href="@aspectj.home.url@/doc/dist/api/overview-summary.html">web</a>)
       <!-- end strip -->
     </td>
     <td>API documentation for AspectJ runtime classes. <tt>JoinPoint</tt>
         shows the state automatically available at each join point.
     </td> </tr>

<tr> <td><a href="faq.html"> FAQ</a>
       <!-- start strip -->
         (<a href="@aspectj.home.url@/doc/dist/faq.html">web</a>)
       <!-- end strip -->
     </td>
     <td>Frequently-asked questions about the AspectJ language, tools, and project.
     </td> </tr>

<tr> <td><a href="porting.html"> Porting guide</a>
       <!-- start strip -->
         (<a href="@aspectj.home.url@/doc/dist/porting.html">web</a>)
       <!-- end strip -->
     </td>
     <td>How users can convert code from pre-1.0 versions 
     of AspectJ to 1.0.  
     </td> </tr>

<tr> <td><a href="changes.html"> Changes </a>
       <!-- start strip -->
         (<a href="@aspectj.home.url@/doc/dist/changes.html">web</a>)
       <!-- end strip -->
     </td>
     <td>Changes between the latest releases.
     </td> </tr>

<tr> <td>Examples 
       <!-- start strip -->
       (<a href="examples/">local</a>) 
       <!-- end strip -->
     </td>
     <td>AspectJ code to demonstrate some language features and implement
     JavaBean properties, the Observer pattern, a tracing library, 
     and a game application where aspects handle display updating.
     </td> </tr>

</table>

<a name="distributions"></a>
<h3>AspectJ distributions</h3>
<table border="1">
<tr> <th>Distributions</th><th>Description</th>
<tr> <td><a href="@aspectj.home.url@/dl">AspectJ</a>
     </td>
     <td>The AspectJ distribution contains binaries for the
         compiler, structure browser, and Ant taskdefs,
         as well as the documentation and examples.
         (Source code for AspectJ is available from the CVS
         repositories for the AspectJ project.)
         </td>
     </tr>

<tr> <td><a href="http://eclipse.org/ajdt">AspectJ for Eclipse</a>
     </td>
     <td>AspectJ Development Environment support for
         Eclipse is available under the Common Public License 1.0
         from the eclipse.org project site
         <a href="http://eclipse.org/ajdt">
                  http://eclipse.org/ajdt</a>
         </td>
     </tr>

<tr> <td><a href="http://aspectj4emacs.sourceforge.net">
            AspectJ for Emacs</a>
     </td>
     <td>AspectJ Development Environment support for
         Emacs is available under the GPL
         from the sourceforge project site
         <a href="http://aspectj4emacs.sourceforge.net/">
                  http://aspectj4emacs.sourceforge.net</a>
         </td>
     </tr>

<tr> <td><a href="http://aspectj4jbuildr.sourceforge.net">
            AspectJ for JBuilder</a>
     </td>
     <td>AspectJ Development Environment support for
         JBuilder is available under the Mozilla Public License 1.1
         from the sourceforge project site
         <a href="http://aspectj4jbuildr.sourceforge.net/">
                  http://aspectj4jbuildr.sourceforge.net</a>
         </td>
     </tr>

<tr> <td><a href="http://aspectj4netbean.sourceforge.net">
          AspectJ for Netbeans</a>
     </td>
     <td>AspectJ Development Environment support for
         Netbeans is available under the Mozilla Public License 1.1
         from the sourceforge project site
         <a href="http://aspectj4netbean.sourceforge.net/">
                  http://aspectj4netbean.sourceforge.net</a>
         </td>
     </tr>

</table>

<a name="resources"></a>
<h3>Other AspectJ resources</h3>
<table border="1">
<tr> <th>Resources</th><th>Description</th> 
     </tr>
<tr> <td>Mail lists 
         </td>
     </td>
     <td>
         AspectJ users 
         discuss tips and
         best practices for writing AspectJ programs
         on the  
         <a href="mailto:aspectj-users@dev.eclipse.org">
           aspectj-users@dev.eclipse.org</a> mail list.
         AspectJ Developers discuss issues with developing
         AspectJ on the 
         <a href="mailto:aspectj-developers@dev.eclipse.org">
          aspectj-developers@dev.eclipse.org</a> list.
         You can subscribe to the announce list
         (<tt>aspectj-developers@dev.eclipse.org</tt>) 
         to get occasional emails about AspectJ releases
         and relevant events.

<tr> <td><a href="http://dev.eclipse.org/bugs">Bug database</a>
     </td>
     <td>Use Bugzilla to submit bugs against the AspectJ
     product components 
     <tt>compiler</tt> (for the ajc compiler)
     <tt>ide</tt> (for AJBrowser and AJDE bugs),
     <tt>ant</tt> (for Ant tasks)
     and
     <tt>docs</tt> (for the documentation).
     </td> </tr>

<tr> <td> <a href="http://aosd.net">http://aosd.net</a> - the AOSD web site
     </td>
     <td>This site has discussion and announcements related to
         aspect-oriented software development (AOSD) in general.  
         Use <a href="mailto:announce@aosd.net">announce@aosd.net</a>
         to get and publish notices about AOSD
         workshops, conferences, and technology releases.
         Use <a href="mailto:announce@aosd.net">discuss@aosd.net</a>
         for general AOSD discussions.
     </td> </tr>
</table>

<p>
<a name="paths"></a>
<h3>Suggested paths for those new to AspectJ</h3>
<p>
   To learn the AspectJ language, read the 
    <a href="progguide/index.html">Programming Guide</a>,
    keeping the <a href="progguide/apb.html">Semantics appendix</a>
    nearby as the best reference for AspectJ usage.
    Focus initially on the join point model and
    pointcuts, concepts AOP adds to OOP.
    To see how the code works, tour your 
       <!-- start strip -->
       <a href="../examples/">local</a>
       <!-- end strip -->
    examples as described in the 
    <a href="progguide/ch03.html">Examples </a> section of the
    <a href="progguide/index.html">Programming Guide</a>.
    View and navigate the crosscutting structure using 
    the <code>ajbrowser</code> structure viewer, as described in
    the <a href="devguide/rn02re04.html">ajbrowser</a> section of
    the <a href="devguide/index.html">Development Environment Guide</a>.
<p>
    To start using AspectJ with your own code, 
    modify the example aspects to apply to your classes.
    The <a href="devguide/index.html">Development Environment Guide</a>
    shows how to build using the command-line tools. 
    As you learn,
    use the compiler's <code>-Xlint</code> flag to catch some common 
    mistakes.  (Understand that the 
    <a href="progguide/apc.html">current implementation</a>
    is limited to code the compiler controls.)
<p>
   To plan how to adopt AspectJ into a project, read the 
    <a href="progguide/index.html">Programming Guide</a>
   on development- and production-time aspects 
   and the <a href="faq.html">FAQ</a> entries for 
   <a href="faq.html#q:startUsingAJ">How should I start using AspectJ?</a>,
   <a href="faq.html#adoption">Deciding to adopt AspectJ</a>,
   the Development tools sections
   (<a href="faq.html#q:integrateWithDevTools">one</a>,
    <a href="faq.html#devtools">two</a>), and
   <a href="faq.html#q:opensource">AspectJ as open-source</a>.
</p>
<p>
Enjoy the language!
</p>
<p>
The AspectJ Team
</p>

<hr>
<small>
<a href="#top">Top</a>
</small>
</body> </html>