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.
Andy Clement a22efad254 1.9.7 release 2 years ago
.github/workflows Remove obsolete .mvn/settings-read-github-packages.xml 2 years ago
.mvn/wrapper Remove obsolete .mvn/settings-read-github-packages.xml 2 years ago
ajbrowser 1.9.7 release 2 years ago
ajde 1.9.7 release 2 years ago
ajde.core 1.9.7 release 2 years ago
ajdoc 1.9.7 release 2 years ago
asm 1.9.7 release 2 years ago
aspectjmatcher 1.9.7 release 2 years ago
aspectjrt 1.9.7 release 2 years ago
aspectjtools 1.9.7 release 2 years ago
aspectjweaver 1.9.7 release 2 years ago
bcel-builder 1.9.7 release 2 years ago
bridge 1.9.7 release 2 years ago
build 1.9.7 release 2 years ago
docs 1.9.7 release 2 years ago
installer 1.9.7 release 2 years ago
lib 1.9.7 release 2 years ago
loadtime 1.9.7 release 2 years ago
org.aspectj.ajdt.core 1.9.7 release 2 years ago
org.aspectj.lib Upgrade license from CPLv1/EPLv1 to EPLv2 2 years ago
org.aspectj.matcher 1.9.7 release 2 years ago
run-all-junit-tests 1.9.7 release 2 years ago
runtime 1.9.7 release 2 years ago
shadows.org.eclipse.jdt.core Adrian made me put these in. We seem to need a directory containing one file in order to satisfy the build script when it builds shadows.org.eclipse.jdt.core. 20 years ago
taskdefs 1.9.7 release 2 years ago
testing 1.9.7 release 2 years ago
testing-client 1.9.7 release 2 years ago
testing-drivers 1.9.7 release 2 years ago
testing-util 1.9.7 release 2 years ago
tests 1.9.7 release 2 years ago
util 1.9.7 release 2 years ago
weaver 1.9.7 release 2 years ago
.editorconfig Add a basic .editorconfig file 3 years ago
.gitignore Provision libraries in 'lib' automatically 2 years ago
CODE_OF_CONDUCT.md housekeeping 2 years ago
CONTRIBUTING.md ECA reference 2 years ago
LICENSE Upgrade license from CPLv1/EPLv1 to EPLv2 2 years ago
README.md Add link to BUILD.md to main README.md 2 years ago
mvnw Update to Maven 3.6.3 3 years ago
mvnw.cmd Update to Maven 3.6.3 3 years ago
pom.xml 1.9.7 release 2 years 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 the org.aspectj groupID: https://search.maven.org/search?q=g:org.aspectj