public class ClassWriter extends ClassVisitor
ClassVisitor。より正確には、このビジターは Java クラスファイル形式に準拠したバイト配列を生成します。単独で使用して「ゼロから」Java クラスを生成するか、1 つ以上の ClassReader およびアダプタークラスビジターとともに使用して、1 つ以上の既存の Java クラスから変更されたクラスを生成できます。| 修飾子と型 | フィールドと説明 |
|---|---|
static int | COMPUTE_FRAMES メソッドのスタックマップフレームを最初から自動的に計算するフラグ。 |
static int | COMPUTE_MAXS メソッドの最大スタックサイズとローカル変数の最大数を自動的に計算するフラグ。 |
api, cv| コンストラクターと説明 |
|---|
ClassWriter(ClassReader classReader, int flags) 新しい ClassWriter オブジェクトを構築し、「ほとんど追加」するバイトコード変換の最適化を有効にします。 |
ClassWriter(int flags) 新しい ClassWriter オブジェクトを構築します。 |
| 修飾子と型 | メソッドと説明 |
|---|---|
protected ClassLoaderSE | getClassLoader() |
protected StringSE | getCommonSuperClass(StringSE type1, StringSE type2) 指定された 2 つの型の共通のスーパー型を返します。 |
int | newClass(StringSE value) ビルドされるクラスの定数プールにクラス参照を追加します。 |
int | newConst(ObjectSE cst) ビルドされるクラスの定数プールに数値または文字列定数を追加します。 |
int | newField(StringSE owner, StringSE name, StringSE desc) ビルドされるクラスの定数プールにフィールド参照を追加します。 |
int | newHandle(int tag, StringSE owner, StringSE name, StringSE desc) 使用すべきではありません。 このメソッドは newHandle(int, String, String, String, boolean) に取って代わりました。 |
int | newHandle(int tag, StringSE owner, StringSE name, StringSE desc, boolean itf) ビルドされるクラスの定数プールにハンドルを追加します。 |
int | newInvokeDynamic(StringSE name, StringSE desc, Handle bsm, ObjectSE... bsmArgs) ビルドされるクラスの定数プールに invokedynamic 参照を追加します。 |
int | newMethod(StringSE owner, StringSE name, StringSE desc, boolean itf) ビルドされるクラスの定数プールにメソッド参照を追加します。 |
int | newMethodType(StringSE methodDesc) ビルドされるクラスの定数プールにメソッド型参照を追加します。 |
int | newModule(StringSE moduleName) ビルドされるクラスの定数プールにモジュール参照を追加します。 |
int | newNameType(StringSE name, StringSE desc) ビルドするクラスの定数プールに名前と型を追加します。 |
int | newPackage(StringSE packageName) ビルドされるクラスの定数プールにパッケージ参照を追加します。 |
int | newUTF8(StringSE value) ビルドされるクラスの定数プールに UTF8 文字列を追加します。 |
byte[] | toByteArray() このクラスライターで作成されたクラスのバイトコードを返します。 |
void | visit(int version, int access, StringSE name, StringSE signature, StringSE superName, StringSE[] interfaces) クラスのヘッダーにアクセスします。 |
AnnotationVisitor | visitAnnotation(StringSE desc, boolean visible) クラスのアノテーションにアクセスします。 |
void | visitAttribute(Attribute attr) クラスの非標準属性を訪問します。 |
void | visitEnd() クラスの最後を訪問します。 |
FieldVisitor | visitField(int access, StringSE name, StringSE desc, StringSE signature, ObjectSE value) クラスのフィールドを訪問します。 |
void | visitInnerClass(StringSE name, StringSE outerName, StringSE innerName, int access) 内部クラスに関する情報を訪問します。 |
MethodVisitor | visitMethod(int access, StringSE name, StringSE desc, StringSE signature, StringSE[] exceptions) クラスのメソッドを訪問します。 |
ModuleVisitor | visitModule(StringSE name, int access, StringSE version) クラスに対応するモジュールにアクセスしてください。 |
void | visitOuterClass(StringSE owner, StringSE name, StringSE desc) クラスの外側のクラスを訪問します。 |
void | visitSource(StringSE file, StringSE debug) クラスのソースを訪問します。 |
AnnotationVisitor | visitTypeAnnotation(int typeRef, TypePath typePath, StringSE desc, boolean visible) クラスシグネチャーの型のアノテーションにアクセスします。 |
cloneSE, equalsSE, finalizeSE, getClassSE, hashCodeSE, notifySE, notifyAllSE, toStringSE, waitSE, waitSE, waitSEpublic static final int COMPUTE_MAXS
visitMethod メソッドによって返される MethodVisitor の visitMaxs メソッドの引数は無視され、各メソッドの署名とバイトコードから自動的に計算されます。ClassWriter(int), 定数フィールド値 public static final int COMPUTE_FRAMES
MethodVisitor.visitFrame(int, int, java.lang.Object[], int, java.lang.Object[]) メソッドの呼び出しは無視され、スタックマップフレームはメソッドのバイトコードから再計算されます。visitMaxs メソッドの引数も無視され、バイトコードから再計算されます。つまり、COMPUTE_FRAMES は COMPUTE_MAXS を意味します。ClassWriter(int), 定数フィールド値 public ClassWriter(int flags)
ClassWriter オブジェクトを構築します。flags - このクラスのデフォルトの動作を変更するために使用できるオプションフラグ。COMPUTE_MAXS、COMPUTE_FRAMES を参照してください。public ClassWriter(ClassReader classReader, int flags)
ClassWriter オブジェクトを構築し、「ほとんど追加」するバイトコード変換の最適化を有効にします。これらの最適化は次のとおりです。ClassReader が ClassWriter(および他の ClassVisitor インスタンスからではない)からの MethodVisitor オブジェクトを受け取るという事実によって検出されます。classReader - 元のクラスを読み取るために使用される ClassReader。これは、元のクラスから定数プール全体をコピーするため、および該当する場合は元のバイトコードの他のフラグメントをコピーするためにも使用されます。flags - このクラスのデフォルトの動作を変更するために使用できるオプションフラグ。 これらのオプションフラグは、新しいクラスにそのままコピーされるメソッドには影響しません。これは、これらのメソッドの最大スタックサイズもスタックフレームも計算されないことを意味します。COMPUTE_MAXS、COMPUTE_FRAMES を参照してください。public final void visit(int version,
int access,
StringSE name,
StringSE signature,
StringSE superName,
StringSE[] interfaces)ClassVisitorClassVisitor の visit version - クラスのバージョン。access - クラスのアクセスフラグ(Opcodes を参照)このパラメーターは、クラスが非推奨かどうかも示します。name - クラスの内部名(getInternalName を参照)signature - このクラスの署名。クラスが総称クラスではなく、総称クラスまたはインターフェースを継承または実装しない場合は、 null になる可能性があります。superName - スーパークラスの内部名(getInternalName を参照)インターフェースの場合、スーパークラスは ObjectSE です。 null の場合がありますが、ObjectSE クラスの場合のみです。interfaces - クラスのインターフェースの内部名(getInternalName を参照) null の場合があります。public final void visitSource(StringSE file, StringSE debug)
ClassVisitorClassVisitor の visitSource file - クラスのコンパイル元のソースファイルの名前。 null の場合があります。debug - クラスのソース要素とコンパイル済み要素の間の対応を計算するための追加のデバッグ情報。 null の場合があります。public final ModuleVisitor visitModule(StringSE name, int access, StringSE version)
ClassVisitorClassVisitor の visitModule name - モジュール名 access - ACC_OPEN、ACC_SYNTHETIC、ACC_MANDATED の中でモジュールフラグ。version - モジュールバージョンまたは null。public final void visitOuterClass(StringSE owner, StringSE name, StringSE desc)
ClassVisitorClassVisitor の visitOuterClass owner - クラスを囲むクラスの内部名。name - クラスを含むメソッドの名前、またはクラスがそのクラスのメソッドで囲まれていない場合は null 。desc - クラスを含むメソッドの記述子、またはクラスがその包含クラスのメソッドで囲まれていない場合は null 。public final AnnotationVisitor visitAnnotation(StringSE desc, boolean visible)
ClassVisitorClassVisitor の visitAnnotation desc - アノテーションクラスのクラス記述子。visible - true アノテーションが実行時に表示される場合。public final AnnotationVisitor visitTypeAnnotation(int typeRef, TypePath typePath, StringSE desc, boolean visible)
ClassVisitorClassVisitor の visitTypeAnnotation typeRef - アノテーション付きの型への参照。この型参照の種類は、CLASS_TYPE_PARAMETER、CLASS_TYPE_PARAMETER_BOUND または CLASS_EXTENDS でなければなりません。TypeReference を参照してください。typePath - 'typeRef' 内のアノテーション付き型引数、ワイルドカード境界、配列要素型、静的内部型へのパス。アノテーションが 'typeRef' 全体を対象とする場合は、null になることがあります。desc - アノテーションクラスのクラス記述子。visible - true アノテーションが実行時に表示される場合。public final void visitAttribute(Attribute attr)
ClassVisitorClassVisitor の visitAttribute attr - 属性。public final void visitInnerClass(StringSE name, StringSE outerName, StringSE innerName, int access)
ClassVisitorClassVisitor の visitInnerClass name - 内部クラスの内部名(getInternalName を参照)outerName - 内部クラスが属するクラスの内部名(getInternalName を参照)メンバークラスではない場合は、 null になることがあります。innerName - 包含クラス内の内部クラスの(単純な)名前匿名の内部クラスの場合、 null になる場合があります。access - 外側のクラスで最初に宣言された内部クラスのアクセスフラグ。public final FieldVisitor visitField(int access, StringSE name, StringSE desc, StringSE signature, ObjectSE value)
ClassVisitorClassVisitor の visitField access - フィールドのアクセスフラグ(Opcodes を参照)このパラメーターは、フィールドが合成か非推奨か、あるいはその両方かを示します。name - フィールドの名前。desc - フィールドの記述子(Type を参照)signature - フィールドの署名。フィールドの型がジェネリクス型を使用しない場合、 null になることがあります。value - フィールドの初期値。このパラメーターは、フィールドに初期値がない場合は null になる可能性があり、IntegerSE、FloatSE、LongSE、DoubleSE、StringSE(それぞれ int、float、long、または String フィールドの場合)でなければなりません。 このパラメーターは静的フィールドにのみ使用されます。非静的フィールドの場合、その値は無視されます。これは、コンストラクターまたはメソッドのバイトコード命令によって初期化する必要があります。public final MethodVisitor visitMethod(int access, StringSE name, StringSE desc, StringSE signature, StringSE[] exceptions)
ClassVisitorMethodVisitor インスタンス(または null)を返す必要があります。つまり、以前に返されたビジターを返しません。ClassVisitor の visitMethod access - メソッドのアクセスフラグ(Opcodes を参照)このパラメーターは、メソッドが合成であるか、非推奨であるかを示します。name - メソッドの名前。desc - メソッドの記述子(Type を参照)signature - メソッドの署名。メソッドのパラメーター、戻り値の型、例外がジェネリクス型を使用しない場合、 null になることがあります。exceptions - メソッドの例外クラスの内部名(getInternalName を参照) null の場合があります。public final void visitEnd()
ClassVisitorClassVisitor の visitEnd public byte[] toByteArray()
public int newConst(ObjectSE cst)
Attribute サブクラスを対象としており、通常、クラスジェネレーターやアダプターでは必要ありません。public int newUTF8(StringSE value)
Attribute サブクラスを対象としており、通常、クラスジェネレーターやアダプターでは必要ありません。value - 文字列値。public int newClass(StringSE value)
Attribute サブクラスを対象としており、通常、クラスジェネレーターやアダプターでは必要ありません。value - クラスの内部名。public int newMethodType(StringSE methodDesc)
Attribute サブクラスを対象としており、通常、クラスジェネレーターやアダプターでは必要ありません。methodDesc - メソッド型のメソッド記述子。public int newModule(StringSE moduleName)
Attribute サブクラスを対象としており、通常、クラスジェネレーターやアダプターでは必要ありません。moduleName - モジュールの名前。public int newPackage(StringSE packageName)
Attribute サブクラスを対象としており、通常、クラスジェネレーターやアダプターでは必要ありません。packageName - 内部形式でのパッケージの名前。@DeprecatedSE public int newHandle(int tag, StringSE owner, StringSE name, StringSE desc)
newHandle(int, String, String, String, boolean) に置き換えられました。Attribute サブクラスを対象としており、通常、クラスジェネレーターやアダプターでは必要ありません。tag - このハンドルの種類。Opcodes.H_GETFIELD、Opcodes.H_GETSTATIC、Opcodes.H_PUTFIELD、Opcodes.H_PUTSTATIC、Opcodes.H_INVOKEVIRTUAL、Opcodes.H_INVOKESTATIC、Opcodes.H_INVOKESPECIAL、Opcodes.H_NEWINVOKESPECIAL、Opcodes.H_INVOKEINTERFACE である必要があります。owner - フィールドまたはメソッド所有者クラスの内部名。name - フィールドまたはメソッドの名前。desc - フィールドまたはメソッドの記述子。public int newHandle(int tag,
StringSE owner,
StringSE name,
StringSE desc,
boolean itf)Attribute サブクラスを対象としており、通常、クラスジェネレーターやアダプターでは必要ありません。tag - このハンドルの種類。Opcodes.H_GETFIELD、Opcodes.H_GETSTATIC、Opcodes.H_PUTFIELD、Opcodes.H_PUTSTATIC、Opcodes.H_INVOKEVIRTUAL、Opcodes.H_INVOKESTATIC、Opcodes.H_INVOKESPECIAL、Opcodes.H_NEWINVOKESPECIAL、Opcodes.H_INVOKEINTERFACE である必要があります。owner - フィールドまたはメソッド所有者クラスの内部名。name - フィールドまたはメソッドの名前。desc - フィールドまたはメソッドの記述子。itf - 所有者がインターフェースの場合は true。public int newInvokeDynamic(StringSE name, StringSE desc, Handle bsm, ObjectSE... bsmArgs)
Attribute サブクラスを対象としており、通常、クラスジェネレーターやアダプターでは必要ありません。name - 呼び出されたメソッドの名前。desc - invoke メソッドの記述子。bsm - ブートストラップメソッド。bsmArgs - ブートストラップメソッド定数引数。public int newField(StringSE owner, StringSE name, StringSE desc)
Attribute サブクラスを対象としており、通常、クラスジェネレーターやアダプターでは必要ありません。owner - フィールドの所有者クラスの内部名。name - フィールドの名前。desc - フィールドの記述子。public int newMethod(StringSE owner, StringSE name, StringSE desc, boolean itf)
Attribute サブクラスを対象としており、通常、クラスジェネレーターやアダプターでは必要ありません。owner - メソッドの所有者クラスの内部名。name - メソッドの名前。desc - メソッドの記述子。itf - 所有者がインターフェースの場合は true 。public int newNameType(StringSE name, StringSE desc)
Attribute サブクラスを対象としており、通常、クラスジェネレーターやアダプターでは必要ありません。name - 名前。desc - 型記述子。protected StringSE getCommonSuperClass(StringSE type1, StringSE type2)
type1 - クラスの内部名。type2 - 別のクラスの内部名。protected ClassLoaderSE getClassLoader()