Интерфейс 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, 2025, 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://download.java.net/java/early_access/jdk24/docs/api/java.compiler/javax/annotation/processing/Messager.html