Interface ClassTransformer

  • All Superinterfaces:
    jakarta.persistence.spi.ClassTransformer
    All Known Implementing Classes:
    EnhancingClassTransformerImpl

    public interface ClassTransformer
    extends jakarta.persistence.spi.ClassTransformer
    A persistence provider provides an instance of this interface to the PersistenceUnitInfo.addTransformer method. The supplied transformer instance will get called to transform entity class files when they are loaded and redefined. The transformation occurs before the class is defined by the JVM
    • Method Detail

      • transform

        byte[] transform​(ClassLoader loader,
                         String className,
                         Class<?> classBeingRedefined,
                         ProtectionDomain protectionDomain,
                         byte[] classfileBuffer)
                  throws jakarta.persistence.spi.TransformerException
        Invoked when a class is being loaded or redefined to add hooks for persistence bytecode manipulation.
        Specified by:
        transform in interface jakarta.persistence.spi.ClassTransformer
        Parameters:
        loader - the defining class loader of the class being transformed. It may be null if using bootstrap loader
        className - The name of the class being transformed
        classBeingRedefined - If an already loaded class is being redefined, then pass this as a parameter
        protectionDomain - ProtectionDomain of the class being (re)-defined
        classfileBuffer - The input byte buffer in class file format
        Returns:
        A well-formed class file that can be loaded
        Throws:
        jakarta.persistence.spi.TransformerException