Top Description Interfaces Classes
[default module]

Package org.hibernate.bytecode

This package defines the API for plugging in bytecode libraries for usage by Hibernate. Hibernate uses these bytecode libraries in three scenarios:

  1. Reflection optimization - to speed up the performance of POJO entity and component conctruction and field/property access
  2. Proxy generation - runtime building of proxies used for deferred loading of lazy entities
  3. Field-level interception - build-time instrumentation of entity classes for the purpose of intercepting field-level access (read/write) for both lazy loading and dirty tracking.

Currently, both CGLIB and Javassist are supported out-of-the-box.

Note that for field-level interception, simply plugging in a new BytecodeProvider is not enough for Hibernate to be able to recognize new providers. You would additionally need to make appropriate code changes to the org.hibernate.intercept.Helper class. This is because the detection of these enhanced classes is needed in a static environment (i.e. outside the scope of any org.hibernate.SessionFactory.

Note that in the current form the ability to specify a different bytecode provider is actually considered a global settings (global to the JVM).

Interface Summary

Modifier and TypeInterface and Description
public interface
BasicProxyFactory

A proxy factory for "basic proxy" generation

public interface
BytecodeProvider

Contract for providers of bytecode services to Hibernate.

public interface
ClassTransformer

A persistence provider provides an instance of this interface to the PersistenceUnitInfo.addTransformer method.

public interface
ProxyFactoryFactory

An interface for factories of proxy factory instances.

public interface
ReflectionOptimizer

Represents reflection optimization for a particular class.

Class Summary

Modifier and TypeClass and Description
public abstract class
AbstractClassTransformerImpl

Basic implementation of the ClassTransformer contract.

public class
InstrumentedClassLoader

A specialized classloader which performs bytecode enhancement on class definitions as they are loaded into the classloader scope.