org.eclipse.gemini.blueprint.service.importer.support

Class AbstractServiceProxyCreator

java.lang.Object

org.eclipse.gemini.blueprint.service.importer.support.AbstractServiceProxyCreator

All Implemented Interfaces:

ServiceProxyCreator

Direct Known Subclasses:

StaticServiceProxyCreator

abstract class AbstractServiceProxyCreator
extends java.lang.Object
implements ServiceProxyCreator

Internal (package visible) class used for handling common aspects in creating a proxy over OSGi services. Notably, this class creates common aspects such as publishing the bundleContext on a thread-local or handling of thread context classloader.

Field Summary

Fields

Modifier and Type	Field and Description
protected org.osgi.framework.BundleContext	bundleContext client bundle context
protected java.lang.Class<?>[]	classes proxy classes (for static generation)
protected java.lang.ClassLoader	classLoader importing bundle/client classLoader
private org.aopalliance.aop.Advice	clientTCCLAdvice shared immutable interceptor for client TCCL selection (default)
private ImportContextClassLoaderEnum	iccl
private org.aopalliance.aop.Advice	invokerBundleContextAdvice shared immutable interceptor for publishing the client bundle context
private static org.apache.commons.logging.Log	log

Constructor Summary

Constructors

Constructor and Description
AbstractServiceProxyCreator(java.lang.Class<?>[] classes, java.lang.ClassLoader aopClassLoader, java.lang.ClassLoader bundleClassLoader, org.osgi.framework.BundleContext bundleContext, ImportContextClassLoaderEnum iccl)

Method Summary

Modifier and Type	Method and Description
(package private) abstract ServiceInvoker	createDispatcherInterceptor(org.osgi.framework.ServiceReference reference) Create a dispatcher interceptor that actually execute the call on the target service.
(package private) abstract org.aopalliance.aop.Advice	createServiceProviderTCCLAdvice(org.osgi.framework.ServiceReference reference) Create service provider TCCL advice.
ProxyPlusCallback	createServiceProxy(org.osgi.framework.ServiceReference reference) Create a service proxy for the given service reference.
private org.aopalliance.aop.Advice	determineTCCLAdvice(org.osgi.framework.ServiceReference reference)
(package private) java.lang.Class<?>[]	getInterfaces(org.osgi.framework.ServiceReference reference)

Methods inherited from class java.lang.Object

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

Field Detail

log

private static final org.apache.commons.logging.Log log

clientTCCLAdvice

private final org.aopalliance.aop.Advice clientTCCLAdvice

shared immutable interceptor for client TCCL selection (default)

invokerBundleContextAdvice

private final org.aopalliance.aop.Advice invokerBundleContextAdvice

shared immutable interceptor for publishing the client bundle context

classLoader

protected final java.lang.ClassLoader classLoader

importing bundle/client classLoader

classes

protected final java.lang.Class<?>[] classes

proxy classes (for static generation)

bundleContext

protected final org.osgi.framework.BundleContext bundleContext

client bundle context

iccl

private final ImportContextClassLoaderEnum iccl

Constructor Detail

AbstractServiceProxyCreator

AbstractServiceProxyCreator(java.lang.Class<?>[] classes,
                            java.lang.ClassLoader aopClassLoader,
                            java.lang.ClassLoader bundleClassLoader,
                            org.osgi.framework.BundleContext bundleContext,
                            ImportContextClassLoaderEnum iccl)

Method Detail

createServiceProxy

public ProxyPlusCallback createServiceProxy(org.osgi.framework.ServiceReference reference)

Description copied from interface: ServiceProxyCreator

Create a service proxy for the given service reference. The proxy purpose is to transparently decouple the client from holding a strong reference to the service (which might go away) and provide various decorations.

The method returns a container object with the proxy and a destruction callback for it (normally an invocation interceptor). The same functionality can be achieved by casting the proxy to Advised but for security reasons (users could disable the proxies themselves) the proxies are now created in an opaque manner.

Specified by:

createServiceProxy in interface ServiceProxyCreator

Parameters:

reference - service reference

Returns:

the proxy plus a destruction callback to it

determineTCCLAdvice

private org.aopalliance.aop.Advice determineTCCLAdvice(org.osgi.framework.ServiceReference reference)

getInterfaces

java.lang.Class<?>[] getInterfaces(org.osgi.framework.ServiceReference reference)

createServiceProviderTCCLAdvice

abstract org.aopalliance.aop.Advice createServiceProviderTCCLAdvice(org.osgi.framework.ServiceReference reference)

Create service provider TCCL advice. Subclasses should extend this based on their configuration (i.e. is a static proxy or is it dynamic).

Parameters:

reference - service reference

Returns:

AOP advice

createDispatcherInterceptor

abstract ServiceInvoker createDispatcherInterceptor(org.osgi.framework.ServiceReference reference)

Create a dispatcher interceptor that actually execute the call on the target service.

Parameters:

reference - service reference

Returns:

AOP advice