JavaTM Platform
Standard Ed. 6

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() &lt;= getPosition()

getPosition() &lt;= 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
返回:
本地化消息

JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策