org.hibernate.bytecode.spi

Interface BytecodeProvider

All Superinterfaces:

Serializable, Service

public interface BytecodeProvider
extends Service

Contract for providers of bytecode services to Hibernate.

Bytecode requirements break down into the following areas

1. proxy generation (both for runtime-lazy-loading and basic proxy generation) getProxyFactoryFactory()
2. bean reflection optimization getReflectionOptimizer(java.lang.Class, java.lang.String[], java.lang.String[], java.lang.Class[])

Method Summary

Modifier and Type	Method and Description
Enhancer	getEnhancer(EnhancementContext enhancementContext) Returns a byte code enhancer that implements the enhancements described in the supplied enhancement context.
ProxyFactoryFactory	getProxyFactoryFactory() Retrieve the specific factory for this provider capable of generating run-time proxies for lazy-loading purposes.
ReflectionOptimizer	getReflectionOptimizer(Class clazz, String[] getterNames, String[] setterNames, Class[] types) Retrieve the ReflectionOptimizer delegate for this provider capable of generating reflection optimization components.
default void	resetCaches() Some BytecodeProvider implementations will have classloader specific caching.

Method Detail

getProxyFactoryFactory

ProxyFactoryFactory getProxyFactoryFactory()

Retrieve the specific factory for this provider capable of generating run-time proxies for lazy-loading purposes.

Returns:

The provider specific factory.

getReflectionOptimizer

ReflectionOptimizer getReflectionOptimizer(Class clazz,
                                           String[] getterNames,
                                           String[] setterNames,
                                           Class[] types)

Retrieve the ReflectionOptimizer delegate for this provider capable of generating reflection optimization components.

Parameters:

clazz - The class to be reflected upon.

getterNames - Names of all property getters to be accessed via reflection.

setterNames - Names of all property setters to be accessed via reflection.

types - The types of all properties to be accessed.

Returns:

The reflection optimization delegate.

getEnhancer

Enhancer getEnhancer(EnhancementContext enhancementContext)

Returns a byte code enhancer that implements the enhancements described in the supplied enhancement context.

Parameters:

enhancementContext - The enhancement context that describes the enhancements to apply.

Returns:

An enhancer to perform byte code manipulations.

resetCaches

default void resetCaches()

Some BytecodeProvider implementations will have classloader specific caching. These caches are useful at runtime but need to be reset at least on SessionFactory shutdown to prevent leaking the deployment classloader. Since the BytecodeProvider is static these caches are potentially shared across multiple deployments; in this case we'll clear all caches which might show as a small, temporary performance degradation on the SessionFactory instances which haven't been closed. This limitation will be removed in the future, when these providers will no longer be static.