Интерфейс диагностики<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 |
Возвращает локализованное сообщение для заданной локали. |
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://download.java.net/java/early_access/jdk24/docs/api/java.compiler/javax/tools/Diagnostic.html
