Top Description Methods
org.hibernate.proxy

public Interface ProxyFactory

Known Direct Implementers
org.hibernate.proxy.dom4j.Dom4jProxyFactory, org.hibernate.proxy.map.MapProxyFactory, org.hibernate.proxy.pojo.cglib.CGLIBProxyFactory, org.hibernate.proxy.pojo.javassist.JavassistProxyFactory
Imports
java.io.Serializable, java.lang.reflect.Method, java.util.Set, org.hibernate.HibernateException, org.hibernate.engine.SessionImplementor, org.hibernate.type.CompositeType

Contract for run-time, proxy-based lazy initialization proxies.
Author
Gavin King

Method Summary

Modifier and TypeMethod and Description
public HibernateProxy

Returns:

The generated proxy.
getProxy
(Serializable
The id value for the proxy to be generated.
id
,
SessionImplementor
The session to which the generated proxy will be associated.
session
)

Create a new proxy instance

public void
postInstantiate(String
The name of the entity for which this factory should generate proxies.
entityName
,
Class<T>
The entity class for which to generate proxies; not always the same as the entityName.
persistentClass
,
Set<E>
The interfaces to expose in the generated proxy; HibernateProxy is already included in this collection.
interfaces
,
Method
Reference to the identifier getter method; invocation on this method should not force initialization
getIdentifierMethod
,
Method
Reference to the identifier setter method; invocation on this method should not force initialization
setIdentifierMethod
,
CompositeType
For composite identifier types, a reference to the type of the identifier property; again accessing the id should generally not cause initialization - but need to bear in mind mappings.
componentIdType
)

Called immediately after instantiation of this factory.

Method Detail

getProxyback to summary
public HibernateProxy getProxy(Serializable id, SessionImplementor session) throws HibernateException

Create a new proxy instance

Parameters
id:Serializable

The id value for the proxy to be generated.

session:SessionImplementor

The session to which the generated proxy will be associated.

Returns:HibernateProxy

The generated proxy.

Exceptions
HibernateException:
Indicates problems generating the requested proxy.
postInstantiateback to summary
public void postInstantiate(String entityName, Class<T> persistentClass, Set<E> interfaces, Method getIdentifierMethod, Method setIdentifierMethod, CompositeType componentIdType) throws HibernateException

Called immediately after instantiation of this factory.

Essentially equivalent to constructor injection, but contracted here via interface.

Parameters
entityName:String

The name of the entity for which this factory should generate proxies.

persistentClass:Class<T>

The entity class for which to generate proxies; not always the same as the entityName.

interfaces:Set<E>

The interfaces to expose in the generated proxy; HibernateProxy is already included in this collection.

getIdentifierMethod:Method

Reference to the identifier getter method; invocation on this method should not force initialization

setIdentifierMethod:Method

Reference to the identifier setter method; invocation on this method should not force initialization

componentIdType:CompositeType

For composite identifier types, a reference to the type of the identifier property; again accessing the id should generally not cause initialization - but need to bear in mind mappings.

Exceptions
HibernateException:
Indicates a problem completing post instantiation initialization.