org.apache.ojb.broker.core.proxy
Class ProxyHelper

java.lang.Object
  org.apache.ojb.broker.core.proxy.ProxyHelper

public class ProxyHelper
extends Object

ProxyHelper used to get the real thing behind a proxy

Version:

$Id: ProxyHelper.java,v 1.1 2007-08-24 22:17:32 ewestfal Exp $

Author:

Jakob Braeuchi

Constructor Summary

ProxyHelper()

Method Summary

static CollectionProxy	getCollectionProxy(Object item) Return CollectionProxy for item is item is a CollectionProxy, otherwise return null
static IndirectionHandler	getIndirectionHandler(Object obj) Returns the invocation handler object of the given proxy object.
static ProxyFactory	getProxyFactory()
static Class	getRealClass(Object objectOrProxy) Get the real Class
static Object	getRealObject(Object objectOrProxy) Get the real Object
static Object	getRealObjectIfMaterialized(Object objectOrProxy) Get the real Object for already materialized Handler
static boolean	isCollectionProxy(Object item) Reports if item is a CollectionProxy.
static boolean	isMaterialized(Object object) Determines whether the object is a materialized object, i.e.
static boolean	isNormalOjbProxy(Object proxyOrObject) Determines whether the given object is an OJB proxy.
static boolean	isProxy(Object proxyOrObject) Returns true if the given object is a Proxy or a VirtualProxy instance.
static boolean	isVirtualOjbProxy(Object proxyOrObject) Determines whether the given object is an OJB virtual proxy.
static String	toString(Object object) Materialization-safe version of toString.

Methods inherited from class java.lang.Object

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

Constructor Detail

ProxyHelper

public ProxyHelper()

Method Detail

getProxyFactory

public static ProxyFactory getProxyFactory()

getRealObject

public static final Object getRealObject(Object objectOrProxy)

Get the real Object

Parameters:

objectOrProxy -

Returns:

Object

getRealObjectIfMaterialized

public static final Object getRealObjectIfMaterialized(Object objectOrProxy)

Get the real Object for already materialized Handler

Parameters:

objectOrProxy -

Returns:

Object or null if the Handel is not materialized

getRealClass

public static final Class getRealClass(Object objectOrProxy)

Get the real Class

Parameters:

objectOrProxy -

Returns:

Class

isNormalOjbProxy

public static boolean isNormalOjbProxy(Object proxyOrObject)

Determines whether the given object is an OJB proxy.

Returns:

true if the object is an OJB proxy

isVirtualOjbProxy

public static boolean isVirtualOjbProxy(Object proxyOrObject)

Determines whether the given object is an OJB virtual proxy.

Returns:

true if the object is an OJB virtual proxy

isProxy

public static boolean isProxy(Object proxyOrObject)

Returns true if the given object is a Proxy or a VirtualProxy instance.

getIndirectionHandler

public static IndirectionHandler getIndirectionHandler(Object obj)

Returns the invocation handler object of the given proxy object.

Parameters:

obj - The object

Returns:

The invocation handler if the object is an OJB proxy, or null otherwise

isMaterialized

public static boolean isMaterialized(Object object)

Determines whether the object is a materialized object, i.e. no proxy or a proxy that has already been loaded from the database.

Parameters:

object - The object to test

Returns:

true if the object is materialized

toString

public static String toString(Object object)

Materialization-safe version of toString. If the object is a yet-unmaterialized proxy, then only the text "unmaterialized proxy for ..." is returned and the proxy is NOT materialized. Otherwise, the normal toString method is called. This useful e.g. for logging etc.

Parameters:

object - The object for which a string representation shall be generated

Returns:

The string representation

getCollectionProxy

public static CollectionProxy getCollectionProxy(Object item)

Return CollectionProxy for item is item is a CollectionProxy, otherwise return null

isCollectionProxy

public static boolean isCollectionProxy(Object item)

Reports if item is a CollectionProxy.