1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html> <head>
<meta http-equiv="Content-Language" content="en-us">
<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="http://eclipse.org/aspectj">http://eclipse.org/aspectj</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="ant-tasks.html">ant task summary</a>,
<a href="api/overview-summary.html">API</a> and
<a href="examples/">example code</a>.
<tr><td><a href="#distributions">distributions</a></td><td>
<a href="http://eclipse.org/aspectj">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="http://eclipse.org/aspectj">AspectJ project</a>
the bug <a href="http://dev.eclipse.org/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="http://eclipse.org/aspectj/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="http://eclipse.org/aspectj/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="http://eclipse.org/aspectj/doc/dist/devguide/index.html">web</a> -->
<!-- end strip -->
)
</td>
<td>Find here a guide to the command-line compiler
<a href="devguide/rn01re01.html">ajc</a>
and the <u>AspectJ Development Environment (AJDE)</u>
for managing crosscutting structure, shown in the stand-alone
<a href="devguide/rn01re02.html">AspectJ Browser</a>.
</td>
</tr>
<tr> <td><a href="ant-tasks.html">AspectJ Ant tasks</a>
</td>
<td>This shows how to use the tasks included
in the <code>aspectjtools.jar</code>.
</td> </tr>
<tr> <td><a href="api/overview-summary.html">AspectJ API</a>
<!-- start strip -->
<!-- (<a href="http://eclipse.org/aspectj/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="http://eclipse.org/aspectj/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="http://eclipse.org/aspectj/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="http://eclipse.org/aspectj/doc/dist/changes.html">web</a>) -->
<!-- end strip -->
</td>
<td>Changes between the latest releases.
</td> </tr>
<tr> <td><a href="examples/">Examples</a>
<!-- 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="http://eclipse.org/aspectj">AspectJ</a>
</td>
<td>The AspectJ distribution contains binaries for the
compiler, structure browser, and Ant taskdefs,
as well as the documentation and examples.
</td>
</tr>
<tr> <td><a href="http://eclipse.org/aspectj">AspectJ</a> source code
</td>
<td>Source code for AspectJ is available
under the open-source
<a href="http://www.eclipse.org/legal/cpl-v10.html">CPL 1.0</a>
license from the CVS
repositories for the AspectJ project. See the
<a href="faq.html#q:buildingsource">FAQ entry</a>.
</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 CPL 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-announce@dev.eclipse.org</tt>)
to get occasional emails about AspectJ releases
and relevant events.
Only those subscribed to the list may post to it.
Go to
<a href="http://eclipse.org/aspectj">
the AspectJ home page</a>
to view list archives or subscribe to the list.
<tr> <td><a href="http://dev.eclipse.org/bugs">Bug database</a>
</td>
<td>Use the Eclipse project's Bugzilla database
to view and submit bugs against the AspectJ product components
<a href="http://bugs.eclipse.org/bugs/buglist.cgi?product=AspectJ&component=Compiler">
Compiler</a> (for the AspectJ compiler, ajc)
<a href="http://bugs.eclipse.org/bugs/buglist.cgi?product=AspectJ&component=IDE">
IDE</a> (for AJBrowser and AJDE bugs),
<a href="http://bugs.eclipse.org/bugs/buglist.cgi?product=AspectJ&component=Ant">
Ant</a> (for the Ant tasks),
and
<a href="http://bugs.eclipse.org/bugs/buglist.cgi?product=AspectJ&component=Docs">
Docs</a> (for the documentation).
See the
<a href="faq.html#q:ajcbugs">
FAQ entry</a> for instructions on submitting bugs.
</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:discuss@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
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/rn01re02.html">AspectJ Browser</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.
As you learn,
use the compiler's <code>-Xlint</code> flags 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>
|
