ajc, the AspectJ compiler/weaver

deprecated: since 1.2, use -inpath, which also takes directories.

Accept as source bytecode any .class files in the .jar files or directories on Path. The output will include these classes, possibly as woven with any applicable aspects. Path is a single argument containing a list of paths to zip files or directories, delimited by the platform-specific path delimiter.

Weave binary aspects from jar files and directories on path into all sources. The aspects should have been output by the same version of the compiler. When running the output classes, the run classpath should contain all aspectpath entries. Path, like classpath, is a single argument containing a list of paths to jar files, delimited by the platform-specific classpath delimiter.

The file contains a line-delimited list of arguments. Each line in the file should contain one option, filename, or argument string (e.g., a classpath or inpath). Arguments read from the file are inserted into the argument list for the command. Relative paths in the file are calculated from the directory containing the file (not the current working directory). Comments, as in Java, start with // and extend to the end of the line. Options specified in argument files may override rather than extending existing option values, so avoid specifying options like -classpath in argument files unlike the argument file is the only build specification. The form @file is the same as specifying -argfile file.

Put output classes in zip file output.jar.

Generate aop.xml file for load-time weaving with default name.

Generate aop.xml file for load-time weaving with custom name.

Run the compiler continuously. After the initial compilation, the compiler will wait to recompile until it reads a newline from the standard input, and will quit when it reads a 'q'. It will only recompile necessary components, so a recompile should be much faster than doing a second compile. This requires -sourceroots.

Find and build all .java or .aj source files under any directory listed in DirPaths. DirPaths, like classpath, is a single argument containing a list of paths to directories, delimited by the platform-specific classpath delimiter. Required by -incremental.

Generate a build .ajsym file into the output directory. Used for viewing crosscutting references by tools like the AspectJ Browser.

Generate .ajesym symbol files for emacs support (deprecated).

Same as -Xlint:warning (enabled by default)

Set default level for messages about potential programming mistakes in crosscutting code. {level} may be ignore, warning, or error. This overrides entries in org/aspectj/weaver/XlintDefault.properties from aspectjtools.jar, but does not override levels set using the -Xlintfile option.

Specify properties file to set levels for specific crosscutting messages. PropertyFile is a path to a Java .properties file that takes the same property names and values as org/aspectj/weaver/XlintDefault.properties from aspectjtools.jar, which it also overrides.

Emit information on compiler options and usage

Emit the version of the AspectJ compiler

Specify where to find user class files. Path is a single argument containing a list of paths to zip files or directories, delimited by the platform-specific path delimiter.

Override location of VM’s bootclasspath for purposes of evaluating types when compiling. Path is a single argument containing a list of paths to zip files or directories, delimited by the platform-specific path delimiter.

Override location of VM’s extension directories for purposes of evaluating types when compiling. Path is a single argument containing a list of paths to directories, delimited by the platform-specific path delimiter.

Specify where to place generated .class files. If not specified, <Directory> defaults to the current working dir.

Set source file Java language level

Set classfile Java bytecode level

Set compiler compliance level. Implies identical -source and -target levels. E.g., -11 implies -source 11 and -target 11.

Emit no warnings (equivalent to -warn:none) This does not suppress messages generated by declare warning or Xlint.

Emit warnings for any instances of the comma-delimited list of questionable code (e.g. -warn:unusedLocals,deprecation):

constructorName        method with constructor name
packageDefaultMethod   attempt to override package-default method
deprecation            usage of deprecated type or member
maskedCatchBlocks      hidden catch block
unusedLocals           local variable never read
unusedArguments        method argument never read
unusedImports          import statement not used by code in file
none                   suppress all compiler warnings

Same as -warn:deprecation

Emit no errors for unresolved imports

Keep compiling after error, dumping class files with problem methods

debug attributes level, that may take three forms:

-g         all debug info ('-g:lines,vars,source')
-g:none    no debug info
-g:{items} debug info for any/all of [lines, vars, source], e.g.,
           -g:lines,source

Preserve all local variables during code generation (to facilitate debugging).

Compute reference information.

Specify default source encoding format. Specify custom encoding on a per-file basis by suffixing each input source file/folder name with '[encoding]'.

Emit messages about accessed/processed compilation units

Emit messages about weaving

Specify a log file for compiler messages.

Show progress (requires -log mode).

Display speed information.

Do not call System.exit(n) at end of compilation (n=0 if no error)

Repeat compilation process N times (typically to do performance analysis).

Causes compiler to terminate before weaving

Causes the compiler to calculate and add the SerialVersionUID field to any type implementing Serializable that is affected by an aspect. The field is calculated based on the class before weaving has taken place.

(Experimental - deprecated as now default) Runs weaver in reweavable mode which causes it to create woven classes that can be rewoven, subject to the restriction that on attempting a reweave all the types that advised the woven type must be accessible.

(Experimental) do not inline around advice

(Experimental) This works like incremental mode, but using a file rather than standard input to control the compiler. It will recompile each time file is changed and and halt when file is deleted.

(Experimental) Normally it is an error to declare aspects Serializable. This option removes that restriction.

(Experimental) Create class files that can’t be subsequently rewoven by AspectJ.

(Experimental) Allows code to be generated that targets a 1.2 or a 1.5 level AspectJ runtime (default 1.5)