org.apache.aries.proxy

Interface ProxyManager

public interface ProxyManager

The proxy manager service allows clients to generate and manage proxies.

Method Summary

Modifier and Type	Method and Description
Object	createDelegatingInterceptingProxy(org.osgi.framework.Bundle clientBundle, Collection<Class<?>> classes, Callable<Object> dispatcher, Object template, InvocationListener wrapper) Creates a single proxy that both delegates and intercepts.
Object	createDelegatingProxy(org.osgi.framework.Bundle clientBundle, Collection<Class<?>> classes, Callable<Object> dispatcher, Object template) Create a proxy that delegates to an object instance which may change over time
Object	createInterceptingProxy(org.osgi.framework.Bundle clientBundle, Collection<Class<?>> classes, Object delegate, InvocationListener wrapper) Creates a proxy that invokes the supplied InvocationListener immediately before and after any non-private method is called.
boolean	isProxy(Object proxy) Returns true if and only if the specified object was generated by the ProxyManager.
Callable<Object>	unwrap(Object proxy) This method unwraps the provided proxy returning the target object.

Method Detail

createDelegatingProxy

Object createDelegatingProxy(org.osgi.framework.Bundle clientBundle,
                             Collection<Class<?>> classes,
                             Callable<Object> dispatcher,
                             Object template)
                      throws UnableToProxyException

Create a proxy that delegates to an object instance which may change over time

Parameters:

clientBundle - The bundle providing the class to be proxied

classes - The interfaces and/or classes to be proxied

dispatcher - A Callable that will called each time the proxy is invoked to locate the object to delegate to

template - A template object for the proxy, may be null if only interfaces need to be proxied. Supplying a templates typically offer a significant performance boost to the resulting proxy.

Returns:

A proxy object that delegates to real objects under the covers

Throws:

UnableToProxyException

createInterceptingProxy

Object createInterceptingProxy(org.osgi.framework.Bundle clientBundle,
                               Collection<Class<?>> classes,
                               Object delegate,
                               InvocationListener wrapper)
                        throws UnableToProxyException

Creates a proxy that invokes the supplied InvocationListener immediately before and after any non-private method is called.

Parameters:

clientBundle -

classes -

delegate -

wrapper -

Returns:

Throws:

UnableToProxyException

createDelegatingInterceptingProxy

Object createDelegatingInterceptingProxy(org.osgi.framework.Bundle clientBundle,
                                         Collection<Class<?>> classes,
                                         Callable<Object> dispatcher,
                                         Object template,
                                         InvocationListener wrapper)
                                  throws UnableToProxyException

Creates a single proxy that both delegates and intercepts. See ProxyManager.createDelegatingProxy(Bundle, Collection, Callable) and ProxyManager.createInterceptingProxy(Bundle, Collection, Object, InvocationListener)

Parameters:

clientBundle -

classes -

dispatcher -

template - A template object for the proxy, may be null if only interfaces need to be proxied. Supplying a templates typically offer a significant performance boost to the resulting proxy.

wrapper -

Returns:

Throws:

UnableToProxyException

unwrap

Callable<Object> unwrap(Object proxy)

This method unwraps the provided proxy returning the target object.

Parameters:

proxy - the proxy to unwrap.

Returns:

the target object.

isProxy

boolean isProxy(Object proxy)

Returns true if and only if the specified object was generated by the ProxyManager. See ProxyManager.createDelegatingProxy(Bundle, Collection, Callable) for details on how to create a proxy.

Parameters:

proxy - The proxy object to test

Returns:

true if it is a proxy, false otherwise.