org.zkoss.bind.proxy

Class ProxyHelper

java.lang.Object

org.zkoss.bind.proxy.ProxyHelper

public class ProxyHelper
extends Object

A proxy helper class to create a proxy cache mechanism for Set, List, Collection, Map, and POJO.

Since:

8.0.0

Author:

jumperchen

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	ProxyHelper.ProxyDecorator An interface to decorate the ProxyObject for some purposes, like providing custom validation logic or adding extra handler on it.

Constructor Summary

Constructors

Constructor and Description
ProxyHelper()

Method Summary

Methods

Modifier and Type	Method and Description
static void	addIgnoredProxyClass(Class<?> type) Adds an ignored proxy class type.
static <T> T	createFormProxy(T origin, Class<?> type) Creates a proxy form object from the given origin object, if any.
static <T> T	createFormProxy(T origin, Class<?> type, Class[] interfaces) Creates a proxy form object from the given origin object, if any.
static <T> T	createProxyIfAny(T origin) Creates a proxy object from the given origin object, if any.
static <T> T	createProxyIfAny(T origin, Annotation[] annotations) Creates a proxy object from the given origin object, if any.
static <T> T	getOriginObject(T origin) Internal use only.
static boolean	isImmutable(Object origin) Returns whether the given origin object is immutable.

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

createProxyIfAny

public static <T> T createProxyIfAny(T origin)

Creates a proxy object from the given origin object, if any.

Parameters:

origin -

createProxyIfAny

public static <T> T createProxyIfAny(T origin,
                     Annotation[] annotations)

Creates a proxy object from the given origin object, if any.

Parameters:

origin -

annotations - the annotations of the caller method to indicate whether the elements of the collection or Map type can proxy deeply, if any. (Optional) Like ImmutableElements

addIgnoredProxyClass

public static void addIgnoredProxyClass(Class<?> type)

Adds an ignored proxy class type. Once the data binder try to create a proxy object for the form binding, it will check whether the origin class type should be ignored.

Default it will apply these classes from the library property org.zkoss.bind.proxy.IgnoredProxyClasses

isImmutable

public static boolean isImmutable(Object origin)

Returns whether the given origin object is immutable.

getOriginObject

public static <T> T getOriginObject(T origin)

Internal use only.

createFormProxy

public static <T> T createFormProxy(T origin,
                    Class<?> type)

Creates a proxy form object from the given origin object, if any.

Parameters:

origin - the origin data object

type - the class type of the data object

createFormProxy

public static <T> T createFormProxy(T origin,
                    Class<?> type,
                    Class[] interfaces)

Creates a proxy form object from the given origin object, if any.

Parameters:

origin - the origin data object

type - the class type of the data object

interfaces - the interface type of the data object, if any.

Since:

8.0.1