You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Alexander Kriegisch b16525c004 README.md: Fix word order from comment in previous commit 1 day ago
.github CI build: add Temurin JDK 22 5 days ago
.mvn/wrapper Remove obsolete .mvn/settings-read-github-packages.xml 2 years ago
ajde Set version to 1.9.23-SNAPSHOT 5 days ago
ajde.core Set version to 1.9.23-SNAPSHOT 5 days ago
ajdoc Set version to 1.9.23-SNAPSHOT 5 days ago
asm Set version to 1.9.23-SNAPSHOT 5 days ago
aspectjmatcher Set version to 1.9.23-SNAPSHOT 5 days ago
aspectjrt Set version to 1.9.23-SNAPSHOT 5 days ago
aspectjtools Set version to 1.9.23-SNAPSHOT 5 days ago
aspectjweaver Set version to 1.9.23-SNAPSHOT 5 days ago
bcel-builder Set version to 1.9.23-SNAPSHOT 5 days ago
bridge Set version to 1.9.23-SNAPSHOT 5 days ago
build Set version to 1.9.23-SNAPSHOT 5 days ago
docs Implement remaining 'AspectJ_JDK_Update' tasks for 1.9.22 5 days ago
installer Set version to 1.9.23-SNAPSHOT 5 days ago
lib Implement remaining 'AspectJ_JDK_Update' tasks for 1.9.22 5 days ago
loadtime Set version to 1.9.23-SNAPSHOT 5 days ago
org.aspectj.ajdt.core Set version to 1.9.23-SNAPSHOT 5 days ago
org.aspectj.matcher Set version to 1.9.23-SNAPSHOT 5 days ago
run-all-junit-tests Set version to 1.9.23-SNAPSHOT 5 days ago
runtime Set version to 1.9.23-SNAPSHOT 5 days ago
taskdefs Set version to 1.9.23-SNAPSHOT 5 days ago
testing Set version to 1.9.23-SNAPSHOT 5 days ago
testing-client Set version to 1.9.23-SNAPSHOT 5 days ago
testing-drivers Set version to 1.9.23-SNAPSHOT 5 days ago
testing-util Set version to 1.9.23-SNAPSHOT 5 days ago
tests Set version to 1.9.23-SNAPSHOT 5 days ago
util Set version to 1.9.23-SNAPSHOT 5 days ago
weaver Set version to 1.9.23-SNAPSHOT 5 days ago
.editorconfig Add a basic .editorconfig file 3 years ago
.gitignore Remove lib/jdtcore-aj 1 week ago
.mailmap Add Git .mailmap file 1 month ago
CODE_OF_CONDUCT.md housekeeping 2 years ago
CONTRIBUTING.md Replace old by new AspectJ GitHub URL 1 month ago
LICENSE Upgrade license from CPLv1/EPLv1 to EPLv2 2 years ago
README.md README.md: Fix word order from comment in previous commit 1 day ago
mvnw Update to Maven 3.6.3 3 years ago
mvnw.cmd Update to Maven 3.6.3 3 years ago
pom.xml Set version to 1.9.23-SNAPSHOT 5 days ago

README.md

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

Please make sure that your project root directory name is either aspectj (default for git clone) or org.aspectj (case-insensitive), if you wish to run the build with tests. Some integration tests rely on this name when dynamically searching up the current path for the root folder.

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.