diff options
| author | Andy Clement <aclement@gopivotal.com> | 2014-08-14 14:26:54 -0700 |
|---|---|---|
| committer | Andy Clement <aclement@gopivotal.com> | 2014-08-14 14:26:54 -0700 |
| commit | 14f0eaa577b2802473ac23235e7986762d955cd9 (patch) | |
| tree | fd53c393b95391563c94a2062a0bf0ff613959c4 /docs | |
| parent | c08f5da1c53fad069357327b2d3bf7b654b6b232 (diff) | |
| download | aspectj-14f0eaa577b2802473ac23235e7986762d955cd9.tar.gz aspectj-14f0eaa577b2802473ac23235e7986762d955cd9.zip | |
1.8.2 readme
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/dist/doc/README-182.html | 157 |
1 files changed, 157 insertions, 0 deletions
diff --git a/docs/dist/doc/README-182.html b/docs/dist/doc/README-182.html new file mode 100644 index 000000000..22930df89 --- /dev/null +++ b/docs/dist/doc/README-182.html @@ -0,0 +1,157 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"> +<html> <head> +<title>AspectJ 1.8.2 Readme</title> +<style type="text/css"> +<!-- + P { margin-left: 20px; } + PRE { margin-left: 20px; } + LI { margin-left: 20px; } + H4 { margin-left: 20px; } + H3 { margin-left: 10px; } +--> +</style> +</head> + +<body> +<div align="right"><small> +© Copyright 2014 Contributors. +All rights reserved. +</small></div> + +<h1>AspectJ 1.8.2 Readme</h1> + +<p>The full list of resolved issues in 1.8.2 is available +<a href="https://bugs.eclipse.org/bugs/buglist.cgi?query_format=advanced;bug_status=RESOLVED;bug_status=VERIFIED;bug_status=CLOSED;product=AspectJ;target_milestone=1.8.2;">here</a></h2>.</p> + +<ul> +<li>1.8.2 available 14-Aug-2014 +</ul> + +<h2>Notable changes</h2> + +<p>Although only a few bugs have been fixed here, they are quite important ones:</p> + +<h3>Update to more recent Eclipse Compiler</h3> + +<p>AspectJ is now based on a more up to date Eclipse compiler level (git hash 2b07958) so includes all the latest fixes</p> + +<h3>Correct handling of RuntimeInvisibleTypeAnnotations (type annotations without runtime visibility)</h3> + +<p>For anyone weaving code containing these kind of type annotations, this is an important fix. Although AspectJ does not currently +support pointcuts matching on these kinds of annotation it was crashing when they were encountered. That is now fixed.</p> + +<h3>Annotation processing</h3> + +<p>A very long standing issue, the AspectJ compiler now supports annotation processors thanks to some work by Sergey Stupin.</p> + +<p>Here is a short example, a very basic annotation and application:</p> + +<h4>Marker.java</h4> +<code><pre> +import java.lang.annotation.Retention; +import java.lang.annotation.RetentionPolicy; + +@Retention(RetentionPolicy.RUNTIME) +public @interface Marker { } +</pre></code> + +<h4>Code.java</h4> +<code><pre> +public class Code { + + public static void main(String []argv) { + new Code().moo(); + new Code().boo(); + new Code().too(); + new Code().woo(); + } + + public void moo() {} + + @Marker + public void boo() {} + + @Marker + public void too() {} + + public void woo() {} +} +</pre></code> + +<p>And now a basic annotation processor. This processor will find methods in the source marked with the annotation <tt>Marker</tt> and for +each one generate an aspect tailored to advising that method (this *is* a contrived demo!)</p> + +<h4>DemoProcessor.java</h4> +<code><pre> +import java.io.*; +import javax.tools.*; +import java.util.*; +import javax.annotation.processing.*; +import javax.lang.model.*; +import javax.lang.model.element.*; + +@SupportedAnnotationTypes(value= {"*"}) +@SupportedSourceVersion(SourceVersion.RELEASE_6) +public class DemoProcessor extends AbstractProcessor { + + private Filer filer; + + @Override + public void init(ProcessingEnvironment env) { + filer = env.getFiler(); + } + + @Override + public boolean process(Set elements, RoundEnvironment env) { + // Discover anything marked with @Marker + for (Element element: env.getElementsAnnotatedWith(Marker.class)) { + if (element.getKind() == ElementKind.METHOD) { + // For any methods we find, create an aspect: + String methodName = element.getSimpleName().toString(); + String aspectText = + "public aspect Advise_"+methodName+" {\n"+ + " before(): execution(* "+methodName+"(..)) {\n"+ + " System.out.println(\""+methodName+" running\");\n"+ + " }\n"+ + "}\n"; + try { + JavaFileObject file = filer.createSourceFile("Advise_"+methodName, element); + file.openWriter().append(aspectText).close(); + System.out.println("Generated aspect to advise "+element.getSimpleName()); + } catch (IOException ioe) { + // already creates message can appear if processor runs more than once + if (!ioe.getMessage().contains("already created")) { + ioe.printStackTrace(); + } + } + } + } + return true; + } +} +</pre></code> + +<p>With those sources, we compile the processor:</p> +<code><pre>ajc -1.6 DemoProcessor.java Marker.java</pre></code> + +<p>Now compile the code with the processor specified:</p> +<code><pre>ajc -1.6 -processor DemoProcessor -showWeaveInfo Code.java Marker.java</pre></code> +<code><pre> +Generated aspect to advise too +Generated aspect to advise boo +Join point 'method-execution(void Code.boo())' in Type 'Code' (Code.java:14) advised by before advice from 'Advise_boo' (Advise_boo.java:2) +Join point 'method-execution(void Code.too())' in Type 'Code' (Code.java:17) advised by before advice from 'Advise_too' (Advise_too.java:2) +</pre></code> + +<p>Notice the processor generates the aspects and then they are woven into the code being compiled immediately.</p> + +<p>Finally we can run it:</p> +<code><pre>java Code +boo running +too running +</pre></code> + +<p><b>Note:</b> There is still work to be done to get annotation processors behaving under AJDT. +<!-- ============================== --> +</body> +</html> |