javax.persistence.spi
Interface ClassTransformer

public interface ClassTransformer

Version:

$Rev: 467742 $ $Date: 2006-10-25 21:30:38 +0200 (Wed, 25 Oct 2006) $

Method Summary

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.

Method Detail

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

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.

Parameters:

loader - The defining loader of the class to be transformed, may be null if the bootstrap loader

className - The name of the class in the internal form of fully qualified class and interface names

classBeingRedefined - If this is a redefine, the class being redefined, otherwise null

protectionDomain - The protection domain of the class being defined or redefined

classfileBuffer - The input byte buffer in class file format - must not be modified

Returns:

A well-formed class file buffer (the result of the transform), or null if no transform is performed

Throws:

java.lang.instrument.IllegalClassFormatException - If the input does not represent a well-formed class file