模块 java.compiler
包 javax.tools

接口 Diagnostic<S>

类型参数：
S - 此诊断使用的源对象类型
public interface Diagnostic<S>
工具诊断接口。诊断通常会报告源文件中特定位置的问题。但是，并非所有诊断都与位置或文件相关联。

位置是从文件开头开始的从零开始的字符偏移量。负值（NOPOS 除外）不是有效位置。

行号和列号从 1 开始。负值（NOPOS 除外）和 0 不是有效的行号或列号。

自从：
1.6

  • 内部类总结

    内部类
    修饰符和类型
    接口
    描述
    static enum 
    Diagnostic.Kind
    各种诊断，例如，错误或警告。

  • 字段摘要

    字段
    修饰符和类型
    Field
    描述
    static final long
    NOPOS
    用于表示没有位置可用。

  • 方法总结

    修饰符和类型
    方法
    描述
    String
    getCode()
    返回指示诊断类型的诊断代码。
    long
    getColumnNumber()
    返回 getPosition() 返回的字符偏移量的列号。
    long
    getEndPosition()
    返回与指示问题结束的此诊断关联的文件开头的字符偏移量。
    Diagnostic.Kind
    getKind()
    返回此诊断的类型，例如，错误或警告。
    long
    getLineNumber()
    返回 getPosition() 返回的字符偏移量的行号。
    String
    getMessage(Locale 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)
      返回给定locale的本地化消息。实际消息是依赖于实现的。如果区域设置为 null，则使用默认区域设置。
      参数：
      locale - locale；可能是null
      返回：
      本地化消息