要素のデフォルト名を設定する注釈。

名前は、Java言語(たとえば、イベント・クラスの"com.example.Transaction"またはイベント・フィールドの"message"です。)で指定されている有効な識別子である必要があります。

安定した使いやすいイベント名の形式は次のとおりです:

[org|com|net].[organization|product].EventName

@Name注釈のないイベントは、その名前を完全修飾クラス名から取得します。これは実験に適していますが、本番では回避する必要があります。

この名前は、イベントを使用または構成する設定ファイルおよびコードが壊れないように安定している必要があります。
この名前には、"jfr", "internal", "events"や"Event"などの冗長な情報や不要な情報を含めないでください。
名前は短くする必要がありますが、他の組織または製品と競合するように短くしないでください。
この名前はわかりやすく、イベントを構成するユーザーにとって覚えやすい名前にする必要があります。これは特に、イベントが、第三者の使用するフレームワークやライブラリの一部である場合に当てはまります。通常は、ライブラリまたは製品のすべてのイベントを同じネームスペースに入れるだけで十分です。たとえば、OpenJDKのすべてのイベントは"jdk"ネームスペースにあり、"hotspot"、"gc"または"compiler"のサブ・ネーム・スペースはありません。これにより、ユーザーの不必要な認識的負荷を回避できます。かわりに、@Category注釈を使用してイベントをカテゴリに分類できます。カテゴリの名前は、依存性を損なうことなく自由に変更できます

注釈インタフェースName

必須要素のサマリー