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
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 runtimeaspectjweaver- the AspectJ weaveraspectjtools- the AspectJ compileraspectjmatcher- 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 installYou 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
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.
- Complete documentation quicklinks
- Setting up a development environment
- Getting started with AspectJ
- Programming Guide
- READMEs for each version of AspectJ
- AspectJ Java version compatibility
AspectJ is published to Maven Central under group ID org.aspectj.