wamblee.org Git - utils/blob - support/general/src/main/java/org/wamblee/general/ThreadSpecificProxyFactory.java

   1 /*
   2  * Copyright 2005-2010 the original author or authors.
   3  *
   4  * Licensed under the Apache License, Version 2.0 (the "License");
   5  * you may not use this file except in compliance with the License.
   6  * You may obtain a copy of the License at
   7  *
   8  *      http://www.apache.org/licenses/LICENSE-2.0
   9  *
  10  * Unless required by applicable law or agreed to in writing, software
  11  * distributed under the License is distributed on an "AS IS" BASIS,
  12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13  * See the License for the specific language governing permissions and
  14  * limitations under the License.
  15  */
  16 package org.wamblee.general;
  17
  18 import java.lang.reflect.InvocationHandler;
  19 import java.lang.reflect.InvocationTargetException;
  20 import java.lang.reflect.Method;
  21 import java.lang.reflect.Proxy;
  22
  23 /**
  24  * Thread-specific proxy is used to create implementations of interfaces that
  25  * delegate to a thread-specific implementation of the service.
  26  *
  27  * It is used for instance to pass a transaction scoped entity manager around.
  28  *
  29  * The {@link #set(Object)} method sets the current service instance for the current thread.
  30  * The {@link #get()} method gets the current service instance for the current thread.
  31  * The {@link #getProxy()} method gets a proxy that will delegate at runtime to the thread-specific
  32  * instance. The result from this method can be passed at construction of an object that will be used
  33  * by multiple threads.
  34  *
  35  * This class is mostly used by other test tools.
  36  *
  37  * @param T
  38  *            Interface to proxy.
  39  * @author Erik Brakkee
  40  *
  41  */
  42 public class ThreadSpecificProxyFactory<T> {
  43     private class ThreadSpecificInvocationHandler implements InvocationHandler {
  44
  45         @Override
  46         public Object invoke(Object aProxy, Method aMethod, Object[] aArgs)
  47             throws Throwable {
  48             try {
  49                 return aMethod.invoke(svc.get(), aArgs);
  50             } catch (InvocationTargetException e) {
  51                 throw e.getCause();
  52             }
  53         }
  54     }
  55
  56     private ThreadLocal<T> svc = new ThreadLocal<T>();
  57     private Class clazz;
  58
  59     /**
  60      * Constructs the factory.
  61      *
  62      * @param aClass
  63      *            Interface class of the service to proxy.
  64      */
  65     public ThreadSpecificProxyFactory(Class<T> aClass) {
  66         if (!aClass.isInterface()) {
  67             throw new IllegalArgumentException("Class " + aClass.getName() +
  68                 " is not an interface");
  69         }
  70         clazz = aClass;
  71     }
  72
  73     /**
  74      * Sets the thread-specific service.
  75      *
  76      * @param aService
  77      *            Service, use null value to reset.
  78      */
  79     public void set(T aService) {
  80         svc.set(aService);
  81     }
  82
  83     /**
  84      * Gets the current thread-specific service.
  85      * To get a contextual reference that can be used by any thread but delegates to a thread-specific
  86      * instance, use {@link #getProxy()}.
  87      * @return Service.
  88      */
  89     public T get() {
  90         return svc.get();
  91     }
  92
  93     /**
  94      * Gets the proxy that delegates to the thread-specific instance set by
  95      * {@link #set(Object)}
  96      *
  97      * @return Proxy.
  98      */
  99     public T getProxy() {
 100         InvocationHandler handler = new ThreadSpecificInvocationHandler();
 101         Class proxyClass = Proxy.getProxyClass(clazz.getClassLoader(),
 102             new Class[] { clazz });
 103         T proxy;
 104         try {
 105             proxy = (T) proxyClass.getConstructor(
 106                 new Class[] { InvocationHandler.class }).newInstance(
 107                 new Object[] { handler });
 108             return proxy;
 109         } catch (Exception e) {
 110             throw new RuntimeException("Could not create proxy for " +
 111                 clazz.getName(), e);
 112         }
 113     }
 114 }