Интерфейс Diagnostic<S>

Параметры типа:: S — тип исходного объекта, используемого этой диагностикой

public interface Diagnostic<S>

Интерфейс для диагностики от инструментов. Диагностика обычно сообщает о проблеме в определённой позиции исходного файла. Однако не все диагностики связаны с позицией или файлом.

Позиция — это смещение символа от начала файла, отсчитываемое с нуля. Отрицательные значения (за исключением NOPOS) не являются допустимыми позициями.

Нумерация строк и столбцов начинается с 1. Отрицательные значения (за исключением NOPOS) и 0 не являются допустимыми номерами строк или столбцов.

Начиная с:: 1.6

Краткое описание вложенных классов

Модификатор и тип	Интерфейс	Описание
`static enum`	`Diagnostic.Kind`	Виды диагностики, например ошибка или предупреждение.

Краткое описание полей

Модификатор и тип	Поле	Описание
`static final long`	`NOPOS`	Используется для обозначения отсутствия позиции.

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

Модификатор и тип	Метод	Описание
`String`	`getCode()`	Возвращает код диагностики, указывающий на её тип.
`long`	`getColumnNumber()`	Возвращает номер столбца для смещения символа, возвращённого методом getPosition().
`long`	`getEndPosition()`	Возвращает смещение символа от начала файла, связанного с этой диагностикой, которое указывает на конец проблемы.
`Diagnostic.Kind`	`getKind()`	Возвращает вид этой диагностики, например ошибку или предупреждение.
`long`	`getLineNumber()`	Возвращает номер строки для смещения символа, возвращённого методом getPosition().
`String`	`getMessage(Locale locale)`	Возвращает локализованное сообщение для заданной локали.
`long`	`getPosition()`	Возвращает смещение символа от начала исходного объекта, связанного с этой диагностикой, которое указывает на местоположение проблемы.
`S`	`getSource()`	Возвращает исходный объект, связанный с этой диагностикой.
`long`	`getStartPosition()`	Возвращает смещение символа от начала файла, связанного с этой диагностикой, которое указывает на начало проблемы.

Подробное описание полей

NOPOS

static final long NOPOS

Используется для обозначения отсутствия позиции.

См. также:

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

getKind

Diagnostic.Kind getKind()

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

Возвращает:: вид этой диагностики

getSource

S getSource()

Возвращает исходный объект, связанный с этой диагностикой.

Возвращает:: исходный объект, связанный с этой диагностикой. null, если с диагностикой не связан исходный объект.

getPosition

long getPosition()

Возвращает смещение символа от начала исходного объекта, связанного с этой диагностикой, которое указывает на местоположение проблемы. Кроме того, должны выполняться следующие условия:

getStartPosition() <= getPosition()

getPosition() <= getEndPosition()

Возвращает:: смещение символа от начала исходного объекта; NOPOS, если getSource() вернул бы null или если подходящее местоположение отсутствует

getStartPosition

long getStartPosition()

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

Возвращает:: смещение от начала файла; NOPOS тогда и только тогда, когда getPosition() возвращает NOPOS

getEndPosition

long getEndPosition()

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

Возвращает:: смещение от начала файла; NOPOS тогда и только тогда, когда getPosition() возвращает NOPOS

getLineNumber

long getLineNumber()

Возвращает номер строки для смещения символа, возвращённого методом getPosition().

Возвращает:: номер строки или NOPOS тогда и только тогда, когда getPosition() возвращает NOPOS

getColumnNumber

long getColumnNumber()

Возвращает номер столбца для смещения символа, возвращённого методом getPosition().

Возвращает:: номер столбца или NOPOS тогда и только тогда, когда getPosition() возвращает NOPOS

getCode

String getCode()

Возвращает код диагностики, указывающий на её тип. Код зависит от реализации и может быть null.

Возвращает:: код диагностики

getMessage

String getMessage(Locale locale)

Возвращает локализованное сообщение для заданной локали. Фактическое сообщение зависит от реализации. Если локаль равна


null

, используется локаль по умолчанию.

Параметры:: locale — локаль; может быть null
Возвращает:: локализованное сообщение

© 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/tools/Diagnostic.html