public interface Messager
一个
Messager
提供了注解处理器报告错误消息、警告和其他通知的方式。可以传递元素、注解和注解值以提供消息的位置提示。然而,这样的位置提示可能无法获得或只是近似的。
- API注释:
-
由此接口中的方法“打印”的消息可能会或可能不会出现为文本输出到像
System.out
或System.err
这样的位置。实现可以选择以不同方式呈现此信息,比如在窗口中显示消息。 - 自版本:
- 1.6
- 另请参阅:
-
Method Summary
Modifier and TypeMethodDescriptiondefault void
printError
(CharSequence msg) 打印错误。default void
printError
(CharSequence msg, Element e) 在元素的位置打印错误。void
printMessage
(Diagnostic.Kind kind, CharSequence msg) 打印指定类型的消息。void
printMessage
(Diagnostic.Kind kind, CharSequence msg, Element e) 在元素的位置打印指定类型的消息。void
printMessage
(Diagnostic.Kind kind, CharSequence msg, Element e, AnnotationMirror a) 在注解元素的位置打印指定类型的消息。void
printMessage
(Diagnostic.Kind kind, CharSequence msg, Element e, AnnotationMirror a, AnnotationValue v) 在注解元素的注解值内的位置打印指定类型的消息。default void
printNote
(CharSequence msg) 打印注释。default void
printNote
(CharSequence msg, Element e) 在元素的位置打印注释。default void
printWarning
(CharSequence msg) 打印警告。default void
printWarning
(CharSequence msg, Element e) 在元素的位置打印警告。
-
Method Details
-
printMessage
打印指定类型的消息。- 参数:
-
kind
- 消息的类型 -
msg
- 消息,如果没有则为空字符串
-
printMessage
在元素的位置打印指定类型的消息。- 参数:
-
kind
- 消息的类型 -
msg
- 消息,如果没有则为空字符串 -
e
- 用作位置提示的元素
-
printMessage
在注解元素的位置打印指定类型的消息。- 参数:
-
kind
- 消息的类型 -
msg
- 消息,如果没有则为空字符串 -
e
- 注解元素 -
a
- 用作位置提示的注解
-
printMessage
void printMessage(Diagnostic.Kind kind, CharSequence msg, Element e, AnnotationMirror a, AnnotationValue v) 在注解元素的注解值内的位置打印指定类型的消息。- 参数:
-
kind
- 消息的类型 -
msg
- 消息,如果没有则为空字符串 -
e
- 注解元素 -
a
- 包含注解值的注解 -
v
- 用作位置提示的注解值
-
printError
打印错误。- 实现要求:
-
默认实现等效于
printMessage(Diagnostic.Kind.ERROR, msg)
。 - 参数:
-
msg
- 消息,如果没有则为空字符串 - 自版本:
- 18
-
printError
在元素的位置打印错误。- 实现要求:
-
默认实现等效于
printMessage(Diagnostic.Kind.ERROR, msg, e)
。 - 参数:
-
msg
- 消息,如果没有则为空字符串 -
e
- 用作位置提示的元素 - 自版本:
- 18
-
printWarning
打印警告。- 实现要求:
-
默认实现等效于
printMessage(Diagnostic.Kind.WARNING, msg)
。 - 参数:
-
msg
- 消息,如果没有则为空字符串 - 自版本:
- 18
-
printWarning
在元素的位置打印警告。- 实现要求:
-
默认实现等效于
printMessage(Diagnostic.Kind.WARNING, msg, e)
。 - 参数:
-
msg
- 消息,如果没有则为空字符串 -
e
- 用作位置提示的元素 - 自版本:
- 18
-
printNote
打印注释。- 实现要求:
-
默认实现等效于
printMessage(Diagnostic.Kind.NOTE, msg)
。 - 参数:
-
msg
- 消息,如果没有则为空字符串 - 自版本:
- 18
-
printNote
在元素的位置打印注释。- 实现要求:
-
默认实现等效于
printMessage(Diagnostic.Kind.NOTE, msg, e)
。 - 参数:
-
msg
- 消息,如果没有则为空字符串 -
e
- 用作位置提示的元素 - 自版本:
- 18
-