javax.persistence.spi

インタフェース ClassTransformer

public interface ClassTransformer

永続性プロバイダーはこのインタフェースのインスタンスをPersistenceUnitInfo.addTransformerメソッドに提供します。 提供されたトランスフォーマーインスタンスはエンティティクラスのファイルがロードまたは再定義されたときに変換するために呼び出されます。 変換はクラスがJVMによって定義される前に行われます。

導入されたバージョン:

Java Persistence 1.0

メソッドのサマリー

修飾子とタイプ	メソッドと説明
byte[]	transform(java.lang.ClassLoader loader, java.lang.String className, java.lang.Class<?> classBeingRedefined, java.security.ProtectionDomain protectionDomain, byte[] classfileBuffer) クラスがロードまたは再定義されるときに呼び出されます。

メソッドの詳細

transform

byte[] transform(java.lang.ClassLoader loader,
                 java.lang.String className,
                 java.lang.Class<?> classBeingRedefined,
                 java.security.ProtectionDomain protectionDomain,
                 byte[] classfileBuffer)
          throws java.lang.instrument.IllegalClassFormatException

クラスがロードまたは再定義されるときに呼び出されます。 このメソッドの実装は与えられたクラスファイルを変換し、新しい変換されたクラスファイルを返すことがあります。

パラメータ:

loader - 変換されるクラスの定義されたローダー、ブートストラップローダーの場合はnullでも良い

className - 内部形式の完全修飾されたクラスおよびインタフェース名のクラスの名前

classBeingRedefined - 再定義の場合は再定義されるクラス、そうでない場合はnull

protectionDomain - 定義または再定義されるクラスの保護ドメイン

classfileBuffer - クラスファイル形式の入力バイトバッファー - 変換してはならない

戻り値:

(変換の結果)正常な形式のクラスファイルのバッファー、変換が行われなかった場合はnull

例外:

java.lang.instrument.IllegalClassFormatException - 入力が正常な形式のクラスファイルを表していない場合