Интерфейс Diagnostic<S>
- Параметры типа:
-
S- тип объекта источника, используемого этим диагностическим средством
public interface Diagnostic<S>
Интерфейс для диагностики инструментов. Диагностика обычно сообщает о проблеме в определённой позиции файла-источника. Однако не все диагностические средства связаны с позицией или файлом.
Позиция — это смещение символов, отсчитываемое от начала файла, с нуля. Отрицательные значения (кроме NOPOS) не являются допустимыми позициями.
Номера строк и столбцов начинаются с 1. Отрицательные значения (кроме NOPOS) и 0 не являются допустимыми номерами строк или столбцов.
- С:
- 1.6
Вложенные классы
| Модификатор и тип | Интерфейс и описание |
|---|---|
static class |
Diagnostic.Kind Виды диагностических сообщений, например, ошибка или предупреждение. |
Поля
| Модификатор и тип | Поле и описание |
|---|---|
static 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()
Возвращает смещение символов от начала объекта источника, связанного с этой диагностикой, указывающее местоположение проблемы. Кроме того, должны выполняться следующие условия:
getStartPostion() <= 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, 2020, 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.