Интерфейс диагностики<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, 2021, 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/17/docs/api/java.compiler/javax/tools/Diagnostic.html