net.proteusframework.core

Class ProxyUtil

java.lang.Object

net.proteusframework.core.ProxyUtil

public final class ProxyUtil
extends Object

Simple utility to deal with proxied objects. You must set the setProxyClassRetriever(ProxyClassRetriever) in order to correctly unproxy objects. If this method is not passed a non-null instance then methods here will behave as though no proxies are being used. This can be done in Spring as follows:

   <bean class="net.proteusframework.core.ProxyUtil" factory-method="getInstance" singleton="true">
      <property name="proxyClassRetriever">
           <bean class="com.i2rd.hibernate.HibernateProxyClassRetriever" factory-method="getInstance" singleton="true /">
       </property>
   </bean>
 

Author:

Russ Tennant (russ@i2rd.com), Kevin Beaty (kbeaty@i2rd.com) for ProxyClassRetriever, Pat Double (double@i2rd.com) moving ProxyClassRetriever here

Method Summary

Modifier and Type	Method and Description
static ProxyUtil	getInstance() Get an instance.
<O> Class<? extends O>	getProxiedClass(O instance) Get the class that is being proxied.
void	setProxyClassRetriever(com.i2rd.util.ProxyClassRetriever proxyClassRetriever) Sets the proxy class retriever.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getInstance

public static ProxyUtil getInstance()

Get an instance.

Returns:

ProxyUtil.

getProxiedClass

public <O> Class<? extends O> getProxiedClass(O instance)

Get the class that is being proxied. This method calls the equivalent methods in hibernate and spring. If a detached(and proxied) hibernate entity is provided another copy of the entity will be added to the hibernate session as a side-effect of loading the entity to determine the real class.

Type Parameters:

O - the type.

Parameters:

instance - the instance to check.

Returns:

the class being proxied or the specified instance's class if it is not being proxied.

setProxyClassRetriever

public void setProxyClassRetriever(com.i2rd.util.ProxyClassRetriever proxyClassRetriever)

Sets the proxy class retriever. Due to the singleton behaviour of this class, this retriever is intended to be used per JVM and initialized on the setup of the app (through spring or simlilar technology).

Parameters:

proxyClassRetriever - the proxy class retriever to use