javax.tools
介面 Diagnostic<S>

型別參數：

S - 此診斷使用的源物件型別

public interface Diagnostic<S>

用於來自工具的診斷的介面。診斷通常報告源檔案中指定位置處的問題。但是，並非所有的診斷都與位置或檔案關聯。

位置是指距檔案開始位置的字元偏移量（從 0 開始）。負值（除 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()

獲取距源物件開始位置的字元偏移量，其中源對象與指示問題位置的此診斷關聯。此外，以下表達式必須為 true：

getStartPostion() <= getPosition()

getPosition() <= getEndPosition()

返回：

距源開始位置的字元偏移量；如果 getSource() 返回 null 或者沒有合適的位置，則返回 NOPOS

getStartPosition

long getStartPosition()

獲取距檔案開始位置的字元偏移量，其中檔案與指示問題開始位置的此診斷關聯。

返回：

距檔案開始位置的偏移量；當且僅當 getPosition() 返回 NOPOS 時，返回 NOPOS

getEndPosition

long getEndPosition()

獲取距檔案開始位置的字元偏移量，其中檔案與指示問題結束位置的此診斷關聯。

返回：

距檔案開始位置的偏移量；當且僅當 getPosition() 返回 NOPOS 時，返回 NOPOS

getLineNumber

long getLineNumber()

返回由 getPosition() 返回的字元偏移量的行號。

返回：

行號；當且僅當 getPosition() 返回 NOPOS 時，返回 NOPOS

getColumnNumber

long getColumnNumber()

返回由 getPosition() 返回的字元偏移量的列號。

返回：

列號；當且僅當 getPosition() 返回 NOPOS 時，返回 NOPOS

getCode

String getCode()

獲取指示診斷型別的診斷程式碼。該程式碼是依賴於實作的，可以為 null。

返回：

診斷程式碼

getMessage

String getMessage(Locale locale)

獲取給定語言環境的本地化訊息。實際訊息是依賴於實作的。如果 locale 為 null，則使用預設的語言環境。

參數：

locale - 語言環境；可以為 null

返回：

本地化訊息