Интерфейс Messager

public interface Messager

A Messager предоставляет способ, позволяющий обработчику аннотаций сообщать об ошибках, предупреждениях и других уведомлениях. Элементы, аннотации и значения аннотаций могут быть переданы для предоставления подсказки местоположения для сообщения. Однако такие подсказки местоположения могут быть недоступны или только приблизительными.

Вывод сообщения с типом ошибки приведет к возникновению ошибки.

Примечание API:

Сообщения, «выводимые» методами в этом интерфейсе, могут или не могут отображаться в виде текстового вывода в местоположении, таком как System.out или System.err. Реализации могут выбрать представление этой информации другим способом, например, сообщениями в окне.

С тех пор:

1.6

См. также:

Краткое описание методов

Модификатор и тип	Метод	Описание
`default 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)`	Выводит предупреждение в месте расположения элемента.

Подробное описание методов

printMessage

void printMessage(Diagnostic.Kind kind, CharSequence msg)

Выводит сообщение указанного типа.

Параметры:: kind - тип сообщения; msg - сообщение, или пустая строка, если нет

printMessage

void printMessage(Diagnostic.Kind kind, CharSequence msg, Element e)

Выводит сообщение указанного типа в месте расположения элемента.

Параметры:: kind - тип сообщения; msg - сообщение, или пустая строка, если нет; e - элемент, используемый в качестве подсказки местоположения

printMessage

void printMessage(Diagnostic.Kind kind, CharSequence msg, Element e, AnnotationMirror a)

Выводит сообщение указанного типа в месте расположения зеркала аннотации аннотированного элемента.

Параметры:: kind - тип сообщения; msg - сообщение, или пустая строка, если нет; e - аннотированный элемент; a - аннотация, используемая в качестве подсказки местоположения

printMessage

void printMessage(Diagnostic.Kind kind, CharSequence msg, Element e, AnnotationMirror a, AnnotationValue v)

Выводит сообщение указанного типа в месте расположения значения аннотации внутри зеркала аннотации аннотированного элемента.

Параметры:: kind - тип сообщения; msg - сообщение, или пустая строка, если нет; e - аннотированный элемент; a - аннотация, содержащая значение аннотации; v - значение аннотации, используемое в качестве подсказки местоположения

printError

default void printError(CharSequence msg)

Выводит ошибку.

Требования к реализации:: По умолчанию реализация эквивалентна printMessage(Diagnostic.Kind.ERROR, msg).
Параметры:: msg - сообщение, или пустая строка, если нет
С тех пор:: 18

printError

default void printError(CharSequence msg, Element e)

Выводит ошибку в месте расположения элемента.

Требования к реализации:: По умолчанию реализация эквивалентна printMessage(Diagnostic.Kind.ERROR, msg, e).
Параметры:: msg - сообщение, или пустая строка, если нет; e - элемент, используемый в качестве подсказки местоположения
С тех пор:: 18

printWarning

default void printWarning(CharSequence msg)

Выводит предупреждение.

Требования к реализации:: По умолчанию реализация эквивалентна printMessage(Diagnostic.Kind.WARNING, msg).
Параметры:: msg - сообщение, или пустая строка, если нет
С тех пор:: 18

printWarning

default void printWarning(CharSequence msg, Element e)

Выводит предупреждение в месте расположения элемента.

Требования к реализации:: По умолчанию реализация эквивалентна printMessage(Diagnostic.Kind.WARNING, msg, e).
Параметры:: msg - сообщение, или пустая строка, если нет; e - элемент, используемый в качестве подсказки местоположения
С тех пор:: 18

printNote

default void printNote(CharSequence msg)

Выводит примечание.

Требования к реализации:: По умолчанию реализация эквивалентна printMessage(Diagnostic.Kind.NOTE, msg).
Параметры:: msg - сообщение, или пустая строка, если нет
С тех пор:: 18

printNote

default void printNote(CharSequence msg, Element e)

Выводит примечание в месте расположения элемента.

Требования к реализации:: По умолчанию реализация эквивалентна printMessage(Diagnostic.Kind.NOTE, msg, e).
Параметры:: msg - сообщение, или пустая строка, если нет; e - элемент, используемый в качестве подсказки местоположения
С тех пор:: 18

© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.compiler/javax/annotation/processing/Messager.html