123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127 |
- <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
- <html>
-
- <head>
- <title>AspectJ 1.9.7 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 2021 Contributors. All rights reserved.</small></div>
-
- <h1>AspectJ 1.9.7</h1>
-
- <p>
- AspectJ (binaries, source code, documentation) is now distributed under the
- <a href="https://www.eclipse.org/org/documents/epl-2.0/EPL-2.0.txt">Eclipse Public License v 2.0</a>.
- </p>
-
- <p>
- Please note that going forward Bugzilla for issue management is deprecated and new issues should be filed as <a href="https://github.com/eclipse/org.aspectj/issues/new">GitHub issues</a>.
- The list of issues addressed for 1.9.7 can be found
- <a href="https://bugs.eclipse.org/bugs/buglist.cgi?bug_status=RESOLVED&bug_status=VERIFIED&bug_status=CLOSED&f0=OP&f1=OP&f3=CP&f4=CP&j1=OR&list_id=16866879&product=AspectJ&query_format=advanced&target_milestone=1.9.7">here for Bugzilla</a>
- and <a href="https://github.com/eclipse/org.aspectj/issues?q=is%3Aissue+is%3Aclosed++milestone%3A1.9.7">here for GitHub issues</a>.
- </p>
-
- <h2>New features</h2>
-
- <p>
- AspectJ 1.9.7 supports <a href="https://openjdk.java.net/projects/jdk/15/">Java 15</a> &
- <a href="https://openjdk.java.net/projects/jdk/16/">Java 16</a> and their respective final and preview features:
- </p>
- <ul>
- <li>text blocks (final 15)</li>
- <li>records (preview 15, final 16)</li>
- <li><tt>instanceof</tt> pattern matching (preview 15, final 16)</li>
- <li>hidden classes (final 15)</li>
- <li>sealed classes (preview 15, preview 16)</li>
- </ul>
- <p>
- For features marked as preview on a given JDK, you need to compile with <tt>ajc --enable-preview</tt> and run with
- <tt>java --enable-preview</tt> on that JDK.
- </p>
- <p>
- Please note that you cannot run code compiled with preview features on any other JDK than the one used for
- compilation. For example, records compiled with preview on JDK 15 cannot be used on JDK 16 without recompilation. This
- is a JVM limitation unrelated to AspectJ. Also, e.g. sealed classes are preview-1 on JDK 15 and preview-2 on JDK 16.
- You still need to recompile, no matter what.
- </p>
- <p>
- <p>
- You can find some sample code in the AspectJ test suite under the respective AspectJ version in which the features
- were first supported (possibly as JVM preview features):
- </p>
- <ul>
- <li><a href="https://github.com/eclipse/org.aspectj/tree/master/tests/features195/textblock">
- AspectJ 1.9.5: text blocks</a></li>
- <li><a href="https://github.com/eclipse/org.aspectj/tree/master/tests/features196/java14">
- AspectJ 1.9.6: records, <tt>instanceof</tt> patterns</a></li>
- <li><a href="https://github.com/eclipse/org.aspectj/tree/master/tests/features197/java15">
- AspectJ 1.9.7: hidden classes, sealed classes</a></li>
- </ul>
-
- <h2>Using LTW on Java 16+</h2>
-
- <p>
- Please note that if you want to use load-time weaving on Java 16+, the weaving agent collides with
- <a href="https://openjdk.java.net/jeps/396">JEP 396 (Strongly Encapsulate JDK Internals by Default)</a>. Therefore,
- you need to set the JVM parameter <tt>--add-opens java.base/java.lang=ALL-UNNAMED</tt> in order to enable aspect
- weaving. This is due to the fact that the weaver uses internal APIs for which we have not found an adequate
- replacement yet when defining classes in different classloaders.
- </p>
-
- <h2>Organisational and internal changes</h2>
-
- <p>
- For AspectJ 1.9.7, we implemented a lot of internal changes concerning the build and release process, most of which
- are not visible in the product itself but will help us to more easily maintain and release the product in the future
- and more easily on-boarding new developers or contributors. For example:
- </p>
- <ul>
- <li>The main repository has been moved to <a href="https://github.com/eclipse/org.aspectj">GitHub</a>, i.e. you can
- open bug reports, feature requests and pull requests there now.</li>
- <li>The Maven build has been improved, i.e. it is now easier to build and contribute to the product. Developers can
- just import the Maven project and no longer depend on Eclipse to build and test AspectJ, but can e.g. also use
- IntelliJ IDEA.</li>
- <li>Continuous integration builds now run on GitHub for different JDK versions, also for pull requests. I.e. both
- maintainers and contributors get to know if their changes break any tests.</li>
- <li>We can build releases and deploy them directly to Sonatype OSSRH (snapshots) or Maven Central (releases) with
- Maven now, i.e. it should be much easier in the future to publish development versions in order to enable users to
- re-test fixed bugs or try new features.</li>
- <li>All tests are portable now, i.e. they correctly run on Windows, too. This enables developers and contributors to make
- a choice if they want to work on Linux or on Windows.</li>
- </ul>
-
- <h2>Other changes and bug fixes</h2>
-
- <ul>
- <li>Remove legacy JRockit support.</li>
- <li>Support Windows 10 and Windows Server 2016/2019 in installer. Those versions were not detected until now, which
- led to bogus Windows batch files forwarding only 9 AJC parameters to the Java process via
- <tt>%1 %2 %3 %4 %5 %6 %7 %8 %9</tt> instead of <tt>%*</tt>.</li>
- <li>AJdoc (AspectJ's javadoc generator add-on for aspects) now supports the JDK 16 javadoc generator.</li>
- <li>Fix <tt>serialVersionUID</tt> initialization for Java 9+</li>
- <li>AJC (AspectJ Compiler) usage texts sometimes used to be printed twice and they were printed too often, e.g. on
- top of every compile error. This has been fixed. Furthermore, the partly outdated usage text is now basically the
- same as ECJ (Eclipse Java Compiler), which AJC is a fork of, plus AspectJ-specific additions which are added during
- runtime.</li>
- <li>Source and javadoc JARs distributed together with the AspectJ artifacts on Maven Central are now more accurate and
- more complete with regard to what is included (ASM, JDT Core) and how package names have been relocated.</li>
- <li>Fix sample code formatting issues (indentation) throughout the documentation.</li>
- </ul>
-
- <p>
- Available: 1.9.7 available 24-Jun-2021
- </p>
-
- </body>
-
- </html>
|