diff options
| author | Andy Clement <aclement@gopivotal.com> | 2013-07-29 11:19:02 -0700 |
|---|---|---|
| committer | Andy Clement <andrew.clement@gmail.com> | 2013-07-29 12:05:09 -0700 |
| commit | 38206a5304739c5e986c26e71186b74db0a5af5b (patch) | |
| tree | 5da23736fef0e082b37eeee4e21342ebd0e590bc /docs | |
| parent | 302c14ee680d5782cba619d8cc748e60afd09561 (diff) | |
| download | aspectj-38206a5304739c5e986c26e71186b74db0a5af5b.tar.gz aspectj-38206a5304739c5e986c26e71186b74db0a5af5b.zip | |
AspectJ 1.8
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/dist/doc/README-180.html | 110 | ||||
| -rw-r--r-- | docs/dist/doc/index.html | 1 |
2 files changed, 111 insertions, 0 deletions
diff --git a/docs/dist/doc/README-180.html b/docs/dist/doc/README-180.html new file mode 100644 index 000000000..f28a5ed66 --- /dev/null +++ b/docs/dist/doc/README-180.html @@ -0,0 +1,110 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"> +<html> <head> +<title>AspectJ 1.8.0 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 2013 Contributors. +All rights reserved. +</small></div> + +<h1>AspectJ 1.8.0 Readme</h1> + +<p>The full list of resolved issues in 1.8.0 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.0;">here</a></h2>.</p> + +<ul> +<li>1.8.0.M1 available 29-Jul-2013 +</ul> + +<h2>Overview</h2> + +<p>In previous AspectJ major releases the first milestone normally tolerates weaving bytecode for the +comparable Java level whilst the ability to compile source code for that Java level comes later. +However, AspectJ 1.8.0.M1 is a Java 8 compiler. So why change the approach this time? Some +consumers of AspectJ are choosing to exploit Java8 library features even though they are not +using Java8 language constructs in their source. The Eclipse JDT compiler (in eclipse 4.3) actually +includes a number of changes to facilitate this (basically compiling with -source 1.7 but on top +of a 1.8 JRE). The changes are necessary because the 1.8 classes include metadata that the 1.7 +compiler just isn't expecting. For example default method implementations in interfaces. In order +to support this mode of working AspectJ would need to update to the Eclipse 4.3 compiler. However, +performing upgrades of the compiler inside AspectJ is non trivial and to avoid doing the +upgrade to 4.3 and then doing a further upgrade to the Java8 compiler, we decided to jump straight +to the Java8 compiler which already includes these changes. +</p> + +<h2>Notable changes</h2> + +<h3>Java 8 compilation</h3> + +<p>AspectJ has been updated to the latest available BETA_JAVA8 support level in the Eclipse Java +compiler. The BETA_JAVA8 tag chosen was commit #3D6E745.</p> +<p><b>NOTE:</b>The Java8 libraries are still in flux and changing regularly. If you are going to +use AspectJ 1.8.0.M1 you must run with a compatible level of Java8. We have been testing with +beta 97. Code compiled with this compiler is not guaranteed to run on a later JDK level. +</p> +<p>AspectJ 1.8.0.M1 will now compile Java 8 code, here is a sample:</p> + +<pre><code> +=== 8< ==== C.java ==== 8< === +import java.util.Arrays; + +interface I { + // Default method + default void foo() { + System.out.println("ABC"); + } +} + +public class C implements I{ + public static void main(String[] args) { + new C().foo(); + // Lambda + Runnable r = () -> { System.out.println("hello world!"); }; + r.run(); + // Used Java8 b97 + Arrays.asList(MyClass.doSomething()).forEach((p) -> System.out.println(p)); + } +} + +aspect X { + before(): execution(* I.foo()) { + System.out.println("I.foo running"); + } + before(): staticinitialization(!X) { + System.out.println("Clazz "+thisJoinPointStaticPart); + } +} + + +class Utils { + public static int compareByLength(String in, String out) { + return in.length() - out.length(); + } +} + +class MyClass { + public static String[] doSomething() { + String []args = new String[]{"4444","333","22","1"}; + // Method reference + Arrays.sort(args,Utils::compareByLength); + return args; + } +} +=== 8< ==== C.java ==== 8< === +</code></pre> + +<h4> +<!-- ============================== --> +</body> +</html> diff --git a/docs/dist/doc/index.html b/docs/dist/doc/index.html index 711ac3e23..ad2bdd71d 100644 --- a/docs/dist/doc/index.html +++ b/docs/dist/doc/index.html @@ -138,6 +138,7 @@ <tr> <td>README's </td> <td>Changes and porting guide for AspectJ + <a href="README-180.html">1.8.0.M1</a>, <a href="README-173.html">1.7.3</a>, <a href="README-172.html">1.7.2</a>, <a href="README-171.html">1.7.1</a>, |