Alexander Kriegisch 47db35bb48 New abstract class JavaVersionSpecificXMLBasedAjcTestCase Replaces now obsolete base classes - XMLBasedAjcTestCaseForJava[n]OrLater, - XMLBasedAjcTestCaseForJava[n]Only. The new class is parametrised with minimum and maximum Java version and hence can replace all the other classes. This does not only apply the DRY principle, but also makes adding tests for new Java versions less tedious. By chance, I also noticed missing sanity tests for Java 12, which I added as a little drive-by benefit. Signed-off-by: Alexander Kriegisch <Alexander@Kriegisch.name>		vor 3 Monaten
.github	Add 'AspectJ_JDK_Update' hint in various places	vor 3 Monaten
.mvn/wrapper	Remove obsolete .mvn/settings-read-github-packages.xml	vor 3 Jahren
ajde	LangUtil: remove methods like 'is11VMOrGreater', 'is1dot5VMOrGreater'	vor 3 Monaten
ajde.core	LangUtil: remove methods like 'is11VMOrGreater', 'is1dot5VMOrGreater'	vor 3 Monaten
ajdoc	LangUtil: remove methods like 'is11VMOrGreater', 'is1dot5VMOrGreater'	vor 3 Monaten
asm	Set version to 1.9.22-SNAPSHOT	vor 3 Monaten
aspectjmatcher	Run Antrun post-javadoc task depending on Javadoc execution	vor 3 Monaten
aspectjrt	Run Antrun post-javadoc task depending on Javadoc execution	vor 3 Monaten
aspectjtools	Run Antrun post-javadoc task depending on Javadoc execution	vor 3 Monaten
aspectjweaver	Run Antrun post-javadoc task depending on Javadoc execution	vor 3 Monaten
bcel-builder	Remove most MINOR_, MINOR_ BCEL class file versions	vor 3 Monaten
bridge	LangUtil: remove methods like 'is11VMOrGreater', 'is1dot5VMOrGreater'	vor 3 Monaten
build	Remove obsolete stuff from module 'build' and lib/build	vor 3 Monaten
docs	Add 'AspectJ_JDK_Update' hint in various places	vor 3 Monaten
installer	Set version to 1.9.22-SNAPSHOT	vor 3 Monaten
lib	Remove obsolete stuff from module 'build' and lib/build	vor 3 Monaten
loadtime	Set version to 1.9.22-SNAPSHOT	vor 3 Monaten
org.aspectj.ajdt.core	LangUtil: remove methods like 'is11VMOrGreater', 'is1dot5VMOrGreater'	vor 3 Monaten
org.aspectj.matcher	LangUtil: remove methods like 'is11VMOrGreater', 'is1dot5VMOrGreater'	vor 3 Monaten
run-all-junit-tests	Set version to 1.9.22-SNAPSHOT	vor 3 Monaten
runtime	Set version to 1.9.22-SNAPSHOT	vor 3 Monaten
taskdefs	New abstract class JavaVersionSpecificXMLBasedAjcTestCase	vor 3 Monaten
testing	New abstract class JavaVersionSpecificXMLBasedAjcTestCase	vor 3 Monaten
testing-client	Set version to 1.9.22-SNAPSHOT	vor 3 Monaten
testing-drivers	Set version to 1.9.22-SNAPSHOT	vor 3 Monaten
testing-util	Globally replace "http:" by "https:" in non-XML files	vor 3 Monaten
tests	New abstract class JavaVersionSpecificXMLBasedAjcTestCase	vor 3 Monaten
util	New abstract class JavaVersionSpecificXMLBasedAjcTestCase	vor 3 Monaten
weaver	LangUtil: remove methods like 'is11VMOrGreater', 'is1dot5VMOrGreater'	vor 3 Monaten
.editorconfig	Add a basic .editorconfig file	vor 3 Jahren
.gitignore	Remove obsolete DocBook build config in favour of Asciidoctor	vor 4 Monaten
.mailmap	Add Git .mailmap file	vor 3 Monaten
CODE_OF_CONDUCT.md	housekeeping	vor 3 Jahren
CONTRIBUTING.md	Replace old by new AspectJ GitHub URL	vor 3 Monaten
LICENSE	Upgrade license from CPLv1/EPLv1 to EPLv2	vor 3 Jahren
README.md	Fix some docs links	vor 3 Monaten
mvnw	Update to Maven 3.6.3	vor 3 Jahren
mvnw.cmd	Update to Maven 3.6.3	vor 3 Jahren
pom.xml	Add 'AspectJ_JDK_Update' hint in various places	vor 3 Monaten

AspectJ

AspectJ is:

a seamless aspect-oriented extension to the Java programming language
Java platform compatible
easy to learn and use

AspectJ enables:

clean modularization of crosscutting concerns, such as error checking and handling, synchronization, context-sensitive behavior, performance optimizations, monitoring and logging, debugging support, and multi-object protocols

Building

AspectJ has a multi-module Maven build. Although various modules produce intermediate results, the key artifacts at the end of the build are:

aspectjrt - the AspectJ runtime
aspectjweaver - the AspectJ weaver
aspectjtools - the AspectJ compiler
aspectjmatcher - the AspectJ matcher

These are the artifacts published to Maven Central for each release. In addition, there is an installer that can be run with java -jar to install AspectJ onto Windows/Mac/Linux. This installer is produced by the installer sub-module.

In the root of a cloned AspectJ simply run:

./mvnw clean install

You can also use a reasonably recent (3.6.3+), locally installed Maven installation instead of the Maven wrapper script.

This will build all the modules, run all the tests and install the key artifacts in your local repository. Once built, access the Maven dependencies from your local repository or run the installer to install AspectJ locally:

java -jar installer/target/aspectj-<VERSION>.jar

Running the tests in Eclipse

Once you have imported all the projects using m2e, there is a special module called run-all-junit-tests and within that a RunTheseBeforeYouCommitTests class that can be run with the JUnit launcher to execute thousands of tests. Ensure you run this with a JDK - the more recent the better since some tests will not execute on older JDKs - tests that verify language features that only exist in the more up to date JDK version.

Documentation for AspectJ users

Documentation for AspectJ developers

Maven releases

AspectJ is published to Maven Central under group ID org.aspectj.

README.md