mirrors
/
org.aspectj
mirror of https://github.com/eclipse/org.aspectj.git


			
				
					
						
						
							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>&copy; 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> &amp;
  <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>