Package org.aspectj.bridge
Interface IMessageHandler
- All Known Subinterfaces:
IMessageHolder
- All Known Implementing Classes:
AjdeCoreMessageHandlerAdapter
,CountingMessageHandler
,DefaultMessageHandler
,Main.LogModeMessagePrinter
,Main.MessagePrinter
,MessageHandler
,MessageWriter
,PinpointingMessageHandler
,WeaverMessageHandler
,WeavingAdaptor.WeavingAdaptorMessageHolder
,WeavingAdaptor.WeavingAdaptorMessageWriter
public interface IMessageHandler
Handle messages, logging and/or aborting as appropriate.
Implementations define which messages are logged and whether
the handler aborts the process.
For messages that are costly to construct, clients may query
isIgnoring(IMessage.Kind)
to avoid construction if the message will be ignored.
Clients passing messages to an IMessageHandler should not
interfere with aborts by catching AbortException unless
otherwise required by their logic or the message handler.-
Field Summary
Modifier and TypeFieldDescriptionstatic final IMessageHandler
print all to System.err and throw AbortException on failure or abort messagesstatic final IMessageHandler
print all to System.out but do not throw AbortException on failure or abort messagesstatic final IMessageHandler
Throw exceptions for anything with ERROR or greater severity -
Method Summary
Modifier and TypeMethodDescriptionvoid
dontIgnore
(IMessage.Kind kind) Allow fine grained configuration after initialization.boolean
handleMessage
(IMessage message) Handle message, by reporting and/or throwing an AbortException.void
ignore
(IMessage.Kind kind) Allow fine grained configuration after initialization.boolean
isIgnoring
(IMessage.Kind kind) Signal clients whether this will ignore messages of a given type.
-
Field Details
-
SYSTEM_ERR
print all to System.err and throw AbortException on failure or abort messages -
SYSTEM_OUT
print all to System.out but do not throw AbortException on failure or abort messages -
THROW
Throw exceptions for anything with ERROR or greater severity
-
-
Method Details
-
handleMessage
Handle message, by reporting and/or throwing an AbortException.- Parameters:
message
- the IMessage to handle - never null- Returns:
- true if this message was handled by this handler
- Throws:
IllegalArgumentException
- if message is nullAbortException
- depending on handler logic.
-
isIgnoring
Signal clients whether this will ignore messages of a given type. Clients may use this to avoid constructing or sending certain messages.- Returns:
- true if this handler is ignoring all messages of this type
-
dontIgnore
Allow fine grained configuration after initialization. Minaly used in LTW. Most of the implementation can have this method be a no-op.- Parameters:
kind
-
-
ignore
Allow fine grained configuration after initialization.- Parameters:
kind
-
-