モジュール java.base

パッケージ java.lang.classfile^PREVIEW

インタフェースAttributeMapper<A>

型パラメータ:

A - 属性の型

public interface AttributeMapper<A>

AttributeMapperは、JavaプラットフォームのプレビューAPIです。

プレビュー機能が有効な場合のみ、プログラムでAttributeMapperを使用できます。

プレビュー機能は、今後のリリースで削除するか、Javaプラットフォームの永続機能にアップグレードすることができます。

属性のクラス・ファイル表現と、その属性がAPIでどのようにモデル化されるかの間の双方向マッパー。 属性マッパーは、クラス・ファイル表現をモデルに解析し、モデル表現をクラス・ファイルに書き戻すために使用されます。 標準属性ごとに、事前定義済の属性マッパーがAttributes^PREVIEWで定義されています。 非標準属性の場合、クライアントは独自のAttributeMapper^PREVIEWを定義できます。 非標準属性をモデル化するクラスは、CustomAttribute^PREVIEWを拡張する必要があります。

導入されたバージョン:

22

ネストされたクラスのサマリー

ネストされたクラス

修飾子と型	インタフェース	説明
static enum	AttributeMapper.AttributeStabilityPREVIEW	Preview. 属性安定性インジケータ

メソッドのサマリー

修飾子と型	メソッド	説明
default boolean	allowMultiple()	この属性が指定されたロケーションに複数回出現できるかどうかを返します。
String	name()	属性の名前を返します。
A	readAttribute(AttributedElementPREVIEW enclosing, ClassReaderPREVIEW cf, int pos)	クラス・ファイルからAttributePREVIEWインスタンスを作成します。
AttributeMapper.AttributeStabilityPREVIEW	stability()	属性安定性インジケータを返します。
void	writeAttribute(BufWriterPREVIEW buf, A attr)	AttributePREVIEWインスタンスをクラス・ファイルに書き込みます。

メソッドの詳細

name

String name()

属性の名前を返します。

戻り値:

属性の名前

readAttribute

A readAttribute(AttributedElementPREVIEW enclosing, ClassReaderPREVIEW cf, int pos)

クラス・ファイルからAttribute^PREVIEWインスタンスを作成します。

パラメータ:

enclosing - この属性が表示されるクラス、メソッド、フィールドまたはコード属性

cf - 読み取るクラス・ファイルを記述するClassReader^PREVIEW

pos - 属性が開始されるクラス・ファイルへのオフセット

戻り値:

新しい属性

writeAttribute

void writeAttribute(BufWriterPREVIEW buf, A attr)

Attribute^PREVIEWインスタンスをクラス・ファイルに書き込みます。

パラメータ:

buf - 属性の書込み先となるBufWriter^PREVIEW

attr - 書き込む属性

allowMultiple

default boolean allowMultiple()

この属性が指定されたロケーションに複数回出現できるかどうかを返します。

実装要件:

デフォルトの実装ではfalseを返します

戻り値:

この属性が指定されたロケーションに複数回出現できるかどうか

stability

AttributeMapper.AttributeStabilityPREVIEW stability()

属性安定性インジケータを返します。

戻り値:

属性安定性インジケータ