Интерфейс Messager

public interface Messager

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://docs.oracle.com/en/java/javase/25/docs/api/java.compiler/javax/annotation/processing/Messager.html