File Doc Category Size Date Package
ClassTransformer.java API Doc Glassfish v2 API 3607 Fri May 04 22:34:08 BST 2007 javax.persistence.spi

ClassTransformer

public interface ClassTransformer

A persistence provider supplies an instance of this interface to the {@link PersistenceUnitInfo#addTransformer PersistenceUnitInfo.addTransformer} method. The supplied transformer instance will get called to transform entity class files when they are loaded or redefined. The transformation occurs before the class is defined by the JVM.

since: Java Persistence 1.0

Fields Summary
Constructors Summary
Methods Summary
public byte[] transform(java.lang.ClassLoader loader, java.lang.String className, java.lang.Class classBeingRedefined, java.security.ProtectionDomain protectionDomain, byte[] classfileBuffer)
Invoked when a class is being loaded or redefined. The implementation of this method may transform the supplied class file and return a new replacement class file.
param
loader The defining loader of the class to be transformed, may be null if the bootstrap loader
param
className The name of the class in the internal form of fully qualified class and interface names
param
classBeingRedefined If this is a redefine, the class being redefined, otherwise null
param
protectionDomain The protection domain of the class being defined or redefined
param
classfileBuffer The input byte buffer in class file format - must not be modified
return
A well-formed class file buffer (the result of the transform), or null if no transform is performed
throws
IllegalClassFormatException If the input does not represent a well-formed class file