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 1cdf71119c Improve unwoven class file handling in SimpleCache 1 day ago
.github Add 'AspectJ_JDK_Update' hint in various places 1 week ago
.mvn/wrapper Remove obsolete .mvn/settings-read-github-packages.xml 2 years ago
ajde LangUtil: remove methods like 'is11VMOrGreater', 'is1dot5VMOrGreater' 1 week ago
ajde.core LangUtil: remove methods like 'is11VMOrGreater', 'is1dot5VMOrGreater' 1 week ago
ajdoc LangUtil: remove methods like 'is11VMOrGreater', 'is1dot5VMOrGreater' 1 week ago
asm Set version to 1.9.22-SNAPSHOT 2 weeks ago
aspectjmatcher Run Antrun post-javadoc task depending on Javadoc execution 2 weeks ago
aspectjrt Run Antrun post-javadoc task depending on Javadoc execution 2 weeks ago
aspectjtools Run Antrun post-javadoc task depending on Javadoc execution 2 weeks ago
aspectjweaver Run Antrun post-javadoc task depending on Javadoc execution 2 weeks ago
bcel-builder Remove most MINOR_*, MINOR_* BCEL class file versions 1 week ago
bridge LangUtil: remove methods like 'is11VMOrGreater', 'is1dot5VMOrGreater' 1 week ago
build Remove obsolete stuff from module 'build' and lib/build 2 weeks ago
docs Further improve '-xmlConfigured' docs 1 week ago
installer Set version to 1.9.22-SNAPSHOT 2 weeks ago
lib Improve unwoven class file handling in SimpleCache 1 day ago
loadtime Set version to 1.9.22-SNAPSHOT 2 weeks ago
org.aspectj.ajdt.core Fix typos: '-xmlConfigured', not '-xmlConfig' 1 week ago
org.aspectj.matcher LangUtil: remove methods like 'is11VMOrGreater', 'is1dot5VMOrGreater' 1 week ago
run-all-junit-tests Set version to 1.9.22-SNAPSHOT 2 weeks ago
runtime Set version to 1.9.22-SNAPSHOT 2 weeks ago
taskdefs New abstract class JavaVersionSpecificXMLBasedAjcTestCase 1 week ago
testing New abstract class JavaVersionSpecificXMLBasedAjcTestCase 1 week ago
testing-client Set version to 1.9.22-SNAPSHOT 2 weeks ago
testing-drivers Set version to 1.9.22-SNAPSHOT 2 weeks ago
testing-util Globally replace "http:" by "https:" in non-XML files 2 weeks ago
tests Add Bugs1921Tests::testGitHub_285 1 day ago
util New abstract class JavaVersionSpecificXMLBasedAjcTestCase 1 week ago
weaver Improve unwoven class file handling in SimpleCache 1 day ago
.editorconfig Add a basic .editorconfig file 3 years ago
.gitignore Remove obsolete DocBook build config in favour of Asciidoctor 1 month ago
.mailmap Add Git .mailmap file 2 weeks ago
CODE_OF_CONDUCT.md housekeeping 2 years ago
CONTRIBUTING.md Replace old by new AspectJ GitHub URL 3 weeks ago
LICENSE Upgrade license from CPLv1/EPLv1 to EPLv2 2 years ago
README.md Fix some docs links 2 weeks ago
mvnw Update to Maven 3.6.3 3 years ago
mvnw.cmd Update to Maven 3.6.3 3 years ago
pom.xml Add link to JDK-8326483 for "generated by javadoc (n)" issue 1 week 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

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.