FAQ - よくある質問

一般的な質問

bytekinとは何ですか?

bytekinはASM上に構築された軽量なJavaバイトコード変換フレームワークです。ソースコードに触れることなく、バイトコードレベルでJavaクラスを変更できます。

なぜバイトコード変換が必要なのですか?

一般的なユースケース:

ソースコードを変更せずにログを追加
横断的関心事の実装
テストとモック
パフォーマンスプロファイリング
セキュリティ強化

bytekinは他のツールとどう違いますか?

ツール	サイズ	複雑さ	ユースケース
bytekin	小	シンプル	直接的なバイトコード操作
Spring AOP	大	複雑	エンタープライズフレームワーク
Mockito	中	中	テスト/モック
Aspect	中	複雑	アスペクト指向プログラミング

bytekinは本番環境対応ですか?

はい、bytekinは本番環境での使用を目的として設計されています。最小限の依存関係（ASMのみ）で、徹底的にテストされています。

技術的な質問

bytekinはどのJavaバージョンをサポートしていますか?

bytekinはJava 8以降が必要です。

bytekinをSpring Bootと一緒に使用できますか?

はい! bytekinはSpring Bootと並行して動作できます。通常、カスタムClassLoaderセットアップ中またはビルド時に変換を適用します。

bytekinは難読化されたコードで動作しますか?

はい、マッピングで! 難読化されたクラス名とメソッド名を処理するためにマッピングシステムを使用します。

複数の変換を組み合わせることはできますか?

はい! 同じクラスに複数の@Inject、@Invoke、その他のアノテーションを使用できます。すべてが適用されます。

使用方法に関する質問

メソッドのメソッドディスクリプタを見つけるにはどうすればよいですか?

javapを使用:

javap -c MyClass.class

メソッドシグネチャを確認し、JVMディスクリプタ形式に変換します:

int add(int a, int b) → (II)I
String process(String s) → (Ljava/lang/String;)Ljava/lang/String;

InjectとInvokeの違いは何ですか?

Inject: メソッドの特定の箇所にコードを挿入
Invoke: メソッド内のメソッド呼び出しをインターセプトし、必要に応じて引数を変更

メソッドの実行をキャンセルできますか?

はい、フックメソッドでci.cancelled = trueを設定します。ただし、これは特定の変換タイプでのみ機能します。

メソッド引数を変更するにはどうすればよいですか?

CallbackInfo.modifyArgsを使用:

ci.modifyArgs = new Object[]{ modifiedArg1, modifiedArg2 };

フックメソッドから静的フィールドにアクセスできますか?

はい、フッククラスから静的フィールドを参照できます:

@Inject(...)
public static CallbackInfo hook() {
    // 静的フィールドにアクセス
    if (cacheEnabled) {
        // ...
    }
}

パフォーマンスに関する質問

bytekinを使用するオーバーヘッドは何ですか?

変換時間: 最小限、クラスロード時に1回のみ発生
ランタイムオーバーヘッド: ゼロ! 変換されたバイトコードは手書きのコードと同じ速度で実行

各変換ごとにトランスフォーマーを再ビルドする必要がありますか?

いいえ! 1回ビルドして再利用:

// 良い
BytekinTransformer transformer = new BytekinTransformer.Builder(MyHooks.class).build();
for (String className : classNames) {
    byte[] transformed = transformer.transform(className, bytecode);
}

// 悪い
for (String className : classNames) {
    BytekinTransformer transformer = new BytekinTransformer.Builder(MyHooks.class).build();
    byte[] transformed = transformer.transform(className, bytecode);
}