モジュール jdk.jfr
パッケージ jdk.jfr

クラスValueDescriptor


  • public final class ValueDescriptor
    extends Object
    イベント・フィールドおよび注釈要素を説明します。
    導入されたバージョン:
    9
    • コンストラクタのサマリー

      コンストラクタ 
      コンストラクタ 説明
      ValueDescriptor​(Class<?> type, String name)
      イベント型および注釈を動的に作成する場合に役立つ値記述子を構築します。
      ValueDescriptor​(Class<?> type, String name, List<AnnotationElement> annotations)
      イベント型および注釈を動的に作成する場合に役立つ値記述子を構築します。
    • メソッドのサマリー

      修飾子と型 メソッド 説明
      <A extends Annotation>
      A
      getAnnotation​(クラス<A> annotationType)
      この値記述子(null)に同じ名前の注釈要素が直接存在する場合は、指定された型の最初の注釈を返します。
      List<AnnotationElement> getAnnotationElements()
      この値記述子の注釈要素の不変なリストを返します。
      String getContentType()
      このValueDescriptorが表す値の解釈またはフォーマット方法を指定するテキスト識別子を返します。
      String getDescription()
      (たとえば、"Maximum throughput in the transaction system. Value is reset after each new batch.")という値を説明する文を返します。
      List<ValueDescriptor> getFields()
      型が複合型の場合は値記述子の不変のリストを返し、それ以外の場合は空のリストを返します。
      String getLabel()
      (たとえば、"Maximum Throughput")の値を説明する判読可能な名前を返します。
      String getName()
      (たとえば、"maxThroughput")という値の名前を返します。
      long getTypeId()
      Java仮想マシン(JVM)のタイプの一意のIDを返します。
      String getTypeName()
      この値記述子に関連付けられている型の完全修飾クラス名を返します。
      boolean isArray()
      この値記述子が配列型の場合はを返します。
    • コンストラクタの詳細

      • ValueDescriptor

        public ValueDescriptor​(Class<?> type,
                               String name)

        イベント型および注釈を動的に作成する場合に役立つ値記述子を構築します。

        次のタイプがサポートされています。

        • byte.class
        • short.class
        • int.class
        • long.class
        • char.class
        • float.class
        • double.class
        • boolean.class
        • String.class
        • Class.class
        • Thread.class

        名前は有効なJava識別子(たとえば、"maxThroughput")である必要があります。 詳細は、3.8 Java言語仕様を参照してください。

        パラメータ:
        type - タイプは、nullではなく
        name - nullではなく名前
        例外:
        SecurityException - セキュリティ・マネージャが存在し、呼び出し元にFlightRecorderPermission("registerEvent")がない場合
      • ValueDescriptor

        public ValueDescriptor​(Class<?> type,
                               String name,
                               List<AnnotationElement> annotations)

        イベント型および注釈を動的に作成する場合に役立つ値記述子を構築します。

        次のタイプがサポートされています。

        • byte.class
        • short.class
        • int.class
        • long.class
        • char.class
        • float.class
        • double.class
        • boolean.class
        • String.class
        • Class.class
        • Thread.class

        名前は有効なJava識別子(たとえば、"maxThroughput")である必要があります。 詳細は、3.8 Java言語仕様を参照してください。

        パラメータ:
        type - タイプは、nullではなく
        name - nullではなく名前
        annotations - nullではなく、値記述子に関する注釈
        例外:
        SecurityException - セキュリティ・マネージャが存在し、呼び出し元にFlightRecorderPermission("registerEvent")がない場合
    • メソッドの詳細

      • getLabel

        public String getLabel()
        (たとえば、"Maximum Throughput")の値を説明する判読可能な名前を返します。
        戻り値:
        判読可能な名前、または存在しない場合はnull
      • getName

        public String getName()
        (たとえば、"maxThroughput")という値の名前を返します。
        戻り値:
        nullではなく名前
      • getDescription

        public String getDescription()
        (たとえば、"Maximum throughput in the transaction system. Value is reset after each new batch.")という値を説明する文を返します。
        戻り値:
        説明(存在しない場合はnull)
      • getContentType

        public String getContentType()
        このValueDescriptorが表す値の解釈またはフォーマット方法を指定するテキスト識別子を返します。

        たとえば、値の記述子タイプがfloatで、イベント値が0.5fである場合、コンテンツ・タイプ"jdk.jfr.Percentage"は、値がパーセンテージであり、"50%"としてレンダリングされるべきであることをヒントします。

        JDKには、次の事前定義済コンテンツ・タイプが用意されています。

        • jdk.jfr.Percentage
        • jdk.jfr.Timespan
        • jdk.jfr.Timestamp
        • jdk.jfr.Frequency
        • jdk.jfr.Flag
        • jdk.jfr.MemoryAddress
        • jdk.jfr.DataAmount
        • jdk.jfr.NetworkAddress

        ユーザー定義コンテンツ・タイプはContentTypeクラスを使用して作成できます。

        戻り値:
        コンテンツ・タイプ(存在しない場合はnull)
        関連項目:
        ContentType
      • getTypeName

        public String getTypeName()
        この値記述子に関連付けられている型の完全修飾クラス名を返します。
        戻り値:
        nullではなく型名
        関連項目:
        getTypeId()
      • getTypeId

        public long getTypeId()
        Java仮想マシン(JVM)のタイプの一意のIDを返します。 IDがJVMインスタンス間で同じでない可能性があります。
        戻り値:
        型ID (負ではない)
      • isArray

        public boolean isArray()
        この値記述子が配列型の場合はを返します。
        戻り値:
        配列型の場合はtrue、それ以外の場合はfalse
      • getAnnotation

        public <A extends Annotation> A getAnnotation​(Class<A> annotationType)
        この値記述子(null)に同じ名前の注釈要素が直接存在する場合は、指定された型の最初の注釈を返します。
        型パラメータ:
        A - 問合せの対象であり、存在する場合に返される注釈の型
        パラメータ:
        annotationType - nullではなく、注釈型に対応するクラス・オブジェクト
        戻り値:
        指定された注釈型のこの要素注釈(存在する場合)、そうでない場合はnull
      • getAnnotationElements

        public List<AnnotationElement> getAnnotationElements()
        この値記述子の注釈要素の不変なリストを返します。
        戻り値:
        nullではなく、注釈のリスト
      • getFields

        public List<ValueDescriptor> getFields()
        型が複合型の場合は値記述子の不変のリストを返し、それ以外の場合は空のリストを返します。
        戻り値:
        nullではなく、値記述子のリスト