oracle.javatools.util

Class ProxyFactory

java.lang.Object

oracle.javatools.util.ProxyFactory

public class ProxyFactory
extends java.lang.Object

Method Summary

Modifier and Type	Method and Description
static <P> P	newProxy(java.lang.Class<P> type, P delegate) Create a new Proxy of the given type.
static <P> P	newSoftProxy(java.lang.Class<P> type, P delegate) Create a new Proxy of the given type.
static <P> P	newSoftProxy(java.lang.Class<P> type, P delegate, Operator runWhenNull) Create a new Proxy of the given type.
static <P> P	newSoftProxy(java.lang.Class<P> type, P delegate, java.lang.Runnable runWhenNull) Deprecated. use newSoftProxy(Class, Object, Operator)
static <P> P	newWeakProxy(java.lang.Class<P> type, P delegate) Create a new Proxy of the given type.
static <P> P	newWeakProxy(java.lang.Class<P> type, P delegate, Operator runWhenNull) Create a new Proxy of the given type.
static <P> P	newWeakProxy(java.lang.Class<P> type, P delegate, java.lang.Runnable runWhenNull) Deprecated. Use newWeakProxy(Class, Object, Operator)

Methods inherited from class java.lang.Object

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

Method Detail

newProxy

public static <P> P newProxy(java.lang.Class<P> type,
                             P delegate)

Create a new Proxy of the given type. Method invocations will be forwarded to the given delegate.

Type Parameters:

P - the parameterized type

Parameters:

type - the type to be implemented by the returned proxy (must be an interface type)

delegate - the implementation to which method invocations will be forwarded

Returns:

a new Proxy of the given type

newWeakProxy

public static <P> P newWeakProxy(java.lang.Class<P> type,
                                 P delegate)

Create a new Proxy of the given type. Method invocations will be forwarded to the given delegate. Only a weak reference to the delegate will be held by the proxy, such that the proxy will not keep the delegate from being garbage collected.

This may be useful for providing a proxy to an event listener, so that the object to which the listener proxy is added won't hold a hard reference to the delegate itself thereby reducing potential memory issues and freeing the programmer from the job of determining the best opportunity to remove the listener.

Type Parameters:

P - the parameterized type

Parameters:

type - the type to be implemented by the returned proxy (must be an interface type)

delegate - the implementation to which method invocations will be forwarded

Returns:

a new Proxy of the given type

newWeakProxy

@Deprecated
public static <P> P newWeakProxy(java.lang.Class<P> type,
                                             P delegate,
                                             java.lang.Runnable runWhenNull)

Deprecated. Use newWeakProxy(Class, Object, Operator)

Create a new Proxy of the given type. Method invocations will be forwarded to the given delegate. Only a weak reference to the delegate will be held by the proxy, such that the proxy will not keep the delegate from being garbage collected. The optional Runnable will be executed in the case that the proxy is invoked after its reference to the delegate has been cleared (usually due to garbage collection).

This may be useful for providing a proxy to an event listener, so that the object to which the listener proxy is added won't hold a hard reference to the delegate itself thereby reducing potential memory issues and freeing the programmer from the job of determining the best opportunity to remove the listener.

Type Parameters:

P - the parameterized type

Parameters:

type - the type to be implemented by the returned proxy (must be an interface type)

delegate - the implementation to which method invocations will be forwarded

runWhenNull - will be executed when the reference to the delegate has been cleared

Returns:

a new Proxy of the given type

newWeakProxy

public static <P> P newWeakProxy(java.lang.Class<P> type,
                                 P delegate,
                                 Operator runWhenNull)

Create a new Proxy of the given type. Method invocations will be forwarded to the given delegate. Only a weak reference to the delegate will be held by the proxy, such that the proxy will not keep the delegate from being garbage collected. The optional Runnable will be executed in the case that the proxy is invoked after its reference to the delegate has been cleared (usually due to garbage collection).

This may be useful for providing a proxy to an event listener, so that the object to which the listener proxy is added won't hold a hard reference to the delegate itself thereby reducing potential memory issues and freeing the programmer from the job of determining the best opportunity to remove the listener.

Type Parameters:

P - the parameterized type

Parameters:

type - the type to be implemented by the returned proxy (must be an interface type)

delegate - the implementation to which method invocations will be forwarded

runWhenNull - will be invoked with the created proxy instance when the reference to the delegate has been cleared

Returns:

a new Proxy of the given type

newSoftProxy

public static <P> P newSoftProxy(java.lang.Class<P> type,
                                 P delegate)

Create a new Proxy of the given type. Method invocations will be forwarded to the given delegate. Only a soft reference to the delegate will be held by the proxy, such that the proxy will not keep the delegate from being garbage collected. Usually the delegate will not be collected until the VM is low on memory.

This may be useful for providing a proxy to an event listener, so that the object to which the listener proxy is added won't hold a hard reference to the delegate itself thereby reducing potential memory issues and freeing the programmer from the job of determining the best opportunity to remove the listener.

Type Parameters:

P - the parameterized type

Parameters:

type - the type to be implemented by the returned proxy (must be an interface type)

delegate - the implementation to which method invocations will be forwarded

Returns:

a new Proxy of the given type

newSoftProxy

@Deprecated
public static <P> P newSoftProxy(java.lang.Class<P> type,
                                             P delegate,
                                             java.lang.Runnable runWhenNull)

Deprecated. use newSoftProxy(Class, Object, Operator)

Create a new Proxy of the given type. Method invocations will be forwarded to the given delegate. Only a weak reference to the delegate will be held by the proxy, such that the proxy will not keep the delegate from being garbage collected. Usually the delegate will not be collected until the VM is low on memory. The optional Runnable will be executed in the case that the proxy is invoked after its reference to the delegate has been cleared (usually due to garbage collection).

This may be useful for providing a proxy to an event listener, so that the object to which the listener proxy is added won't hold a hard reference to the delegate itself thereby reducing potential memory issues and freeing the programmer from the job of determining the best opportunity to remove the listener.

Type Parameters:

P - the parameterized type

Parameters:

type - the type to be implemented by the returned proxy (must be an interface type)

delegate - the implementation to which method invocations will be forwarded

runWhenNull - will be executed when the reference to the delegate has been cleared

Returns:

a new Proxy of the given type

newSoftProxy

public static <P> P newSoftProxy(java.lang.Class<P> type,
                                 P delegate,
                                 Operator runWhenNull)

Create a new Proxy of the given type. Method invocations will be forwarded to the given delegate. Only a weak reference to the delegate will be held by the proxy, such that the proxy will not keep the delegate from being garbage collected. Usually the delegate will not be collected until the VM is low on memory. The optional Runnable will be executed in the case that the proxy is invoked after its reference to the delegate has been cleared (usually due to garbage collection).

This may be useful for providing a proxy to an event listener, so that the object to which the listener proxy is added won't hold a hard reference to the delegate itself thereby reducing potential memory issues and freeing the programmer from the job of determining the best opportunity to remove the listener.

Type Parameters:

P - the parameterized type

Parameters:

type - the type to be implemented by the returned proxy (must be an interface type)

delegate - the implementation to which method invocations will be forwarded

runWhenNull - will be invoked with the created proxy instance when the reference to the delegate has been cleared

Returns:

a new Proxy of the given type