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(Class<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()`	この値記述子が配列型の場合はを返します。

クラス java.lang.Objectで宣言されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細
- 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ではなく、値記述子のリスト

クラスValueDescriptor

コンストラクタのサマリー

メソッドのサマリー

クラス java.lang.Objectで宣言されたメソッド

コンストラクタの詳細

ValueDescriptor

ValueDescriptor

メソッドの詳細

getLabel

getName

getDescription

getContentType

getTypeName

getTypeId

isArray

getAnnotation

getAnnotationElements

getFields