org.aspectj.tools.ajc
Class Main

java.lang.Object
  org.aspectj.tools.ajc.Main

Direct Known Subclasses:

CompilerWrapper

public class Main
extends java.lang.Object

Programmatic and command-line interface to AspectJ compiler. The compiler is an ICommand obtained by reflection. Not thread-safe. By default, messages are printed as they are emitted; info messages go to the output stream, and warnings and errors go to the error stream.

Clients can handle all messages by registering a holder:

 Main main = new Main();
 IMessageHolder holder = new MessageHandler();
 main.setHolder(holder);
 

Clients can get control after each command completes by installing a Runnable:

 main.setCompletionRunner(new Runnable() {..});
 

Nested Class Summary

static class	Main.CommandController controller for repeatable command delays until input or file changed or removed
static class	Main.LogModeMessagePrinter
static class	Main.MessagePrinter interceptor IMessageHandler to print as we go.

Field Summary

static java.lang.String

THROWN_PREFIX Header used when rendering exceptions for users

Constructor Summary

Main()

Method Summary

static int	bareMain(java.lang.String[] args, boolean useSystemExit, java.util.List fails, java.util.List errors, java.util.List warnings, java.util.List infos) Convenience method to run ajc and collect String lists of messages.
IMessageHolder	getHolder()
MessageHandler	getMessageHandler()
static void	main(java.lang.String[] args)
void	quit() call this to stop after the next iteration of incremental compile
static java.lang.String	renderExceptionForUser(java.lang.Throwable thrown)
void	run(java.lang.String[] args, IMessageHolder holder) Run without using System.exit(..), putting all messages in holder: ERROR: compiler error WARNING: compiler warning FAIL: command error (bad arguments, exception thrown) This handles incremental behavior: If args include "-incremental", repeat for every input char until 'q' is entered.
void	runMain(java.lang.String[] args, boolean useSystemExit) Run without throwing exceptions but optionally using System.exit(..).
void	setCommand(ICommand command)
void	setCompletionRunner(java.lang.Runnable runner) Install a Runnable to be invoked synchronously after each compile completes.
void	setHolder(IMessageHolder holder) Set holder to be passed all messages.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

THROWN_PREFIX

public static final java.lang.String THROWN_PREFIX

Header used when rendering exceptions for users

Constructor Detail

Main

public Main()

Method Detail

main

public static void main(java.lang.String[] args)
                 throws java.io.IOException

Parameters:

args - the String[] of command-line arguments

Throws:

java.io.IOException

bareMain

public static int bareMain(java.lang.String[] args,
                           boolean useSystemExit,
                           java.util.List fails,
                           java.util.List errors,
                           java.util.List warnings,
                           java.util.List infos)

Convenience method to run ajc and collect String lists of messages. This can be reflectively invoked with the List collecting parameters supplied by a parent class loader. The String messages take the same form as command-line messages.

Parameters:

args - the String[] args to pass to the compiler

useSystemExit - if true and errors, return System.exit(errs)

fails - the List sink, if any, for String failure (or worse) messages

errors - the List sink, if any, for String error messages

warnings - the List sink, if any, for String warning messages

info - the List sink, if any, for String info messages

Returns:

number of messages reported with level ERROR or above

Throws:

any - unchecked exceptions the compiler does

renderExceptionForUser

public static java.lang.String renderExceptionForUser(java.lang.Throwable thrown)

Returns:

String rendering throwable as compiler error for user/console, including information on how to report as a bug.

Throws:

java.lang.NullPointerException - if thrown is null

getMessageHandler

public MessageHandler getMessageHandler()

setCommand

public void setCommand(ICommand command)

runMain

public void runMain(java.lang.String[] args,
                    boolean useSystemExit)

Run without throwing exceptions but optionally using System.exit(..). This sets up a message handler which emits messages immediately, so report(boolean, IMessageHandler) only reports total number of errors or warnings.

Parameters:

args - the String[] command line for the compiler

useSystemExit - if true, use System.exit(int) to complete unless one of the args is -noExit. and signal result (0 no exceptions/error, <0 exceptions, >0 compiler errors).

run

public void run(java.lang.String[] args,
                IMessageHolder holder)

Run without using System.exit(..), putting all messages in holder:

• ERROR: compiler error
• WARNING: compiler warning
• FAIL: command error (bad arguments, exception thrown)

This handles incremental behavior:

• If args include "-incremental", repeat for every input char until 'q' is entered.
• If args include "-incrementalTagFile {file}", repeat every time we detect that {file} modification time has changed.
• Either way, list files recompiled each time if args includes "-verbose".
• Exit when the commmand/compiler throws any Throwable.

When complete, this contains all the messages of the final run of the command and/or any FAIL messages produced in running the command, including any Throwable thrown by the command itself.

Parameters:

args - the String[] command line for the compiler

holder - the MessageHandler sink for messages.

quit

public void quit()

call this to stop after the next iteration of incremental compile

setHolder

public void setHolder(IMessageHolder holder)

Set holder to be passed all messages. When holder is set, messages will not be printed by default.

Parameters:

holder - the IMessageHolder sink for all messages (use null to restore default behavior)

getHolder

public IMessageHolder getHolder()

setCompletionRunner

public void setCompletionRunner(java.lang.Runnable runner)

Install a Runnable to be invoked synchronously after each compile completes.

Parameters:

runner - the Runnable to invoke - null to disable