org.jclouds.reflect.FunctionalReflection Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of jclouds-core Show documentation
Core components to access jclouds services
There is a newer version: 2.6.0
/*
 * Licensed to the Apache Software Foundation (ASF) under one or more
 * contributor license agreements.  See the NOTICE file distributed with
 * this work for additional information regarding copyright ownership.
 * The ASF licenses this file to You under the Apache License, Version 2.0
 * (the "License"); you may not use this file except in compliance with
 * the License.  You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package org.jclouds.reflect;

import static com.google.common.base.Objects.equal;
import static com.google.common.base.Preconditions.checkArgument;
import static com.google.common.base.Preconditions.checkNotNull;
import static com.google.common.base.Predicates.notNull;
import static com.google.common.base.Throwables.propagate;
import static com.google.common.collect.Iterables.all;
import static org.jclouds.reflect.Reflection2.method;
import static org.jclouds.reflect.Reflection2.typeToken;
import static org.jclouds.util.Throwables2.propagateIfPossible;

import java.lang.reflect.Method;
import java.lang.reflect.Proxy;
import java.util.Arrays;
import java.util.Collections;
import java.util.List;

import com.google.common.annotations.Beta;
import com.google.common.base.Function;
import com.google.common.base.Objects;
import com.google.common.collect.ImmutableList;
import com.google.common.reflect.Invokable;
import com.google.common.reflect.TypeToken;

/**
 * Static utilities relating to functional Java reflection.
 * 
 * @since 1.6
 */
@Beta
public final class FunctionalReflection {
   /**
    * Returns a proxy instance that implements {@code enclosingType} by dispatching method invocations to
    * {@code invocationFunction}. The class loader of {@code enclosingType} will be used to define the proxy class.
    * 
    * Usage example:
    * 
    * 
    * httpAdapter = new Function<Invocation, Result>() {
    *    public Result apply(Invocation in) {
    *       try {
    *          HttpRequest request = parseRequest(in);
    *          HttpResponse response = invoke(request);
    *          return Result.success(parseJson(response));
    *       } catch (Exception e) {
    *          return Result.failure(e);
    *       }
    *    }
    * };
    * 
    * client = FunctionalReflection.newProxy(Client.class, httpAdapter);
    * 
    * 
    * @param invocationFunction
    *           returns a result or a top-level exception, or result
    * @throws IllegalArgumentException
    *            if {@code enclosingType} does not specify the type of a Java interface
    * @see com.google.common.reflect.AbstractInvocationHandler#invoke(Object, Method, Object[])
    * @see com.google.common.reflect.Reflection#newProxy(Class, java.lang.reflect.InvocationHandler)
    */
   public static  T newProxy(TypeToken enclosingType, Function invocationFunction) {
      checkNotNull(enclosingType, "enclosingType");
      checkNotNull(invocationFunction, "invocationFunction");
      return newProxy(enclosingType.getRawType(), new FunctionalInvocationHandler(enclosingType, invocationFunction));
   }

   public static  T newProxy(Class enclosingType, Function invocationFunction) {
      checkNotNull(invocationFunction, "invocationFunction");
      return newProxy(enclosingType, new FunctionalInvocationHandler(typeToken(enclosingType), invocationFunction));
   }

   @SuppressWarnings("unchecked")
   private static  T newProxy(Class enclosingType, FunctionalInvocationHandler invocationHandler) {
      checkNotNull(enclosingType, "enclosingType");
      checkArgument(enclosingType.isInterface(), "%s is not an interface", enclosingType);
      return (T) Proxy.newProxyInstance(enclosingType.getClassLoader(), new Class[] { enclosingType },
            invocationHandler);
   }

   private static final class FunctionalInvocationHandler extends
         com.google.common.reflect.AbstractInvocationHandler {
      private final TypeToken enclosingType;
      private final Function invocationFunction;

      private FunctionalInvocationHandler(TypeToken enclosingType, Function invocationFunction) {
         this.enclosingType = enclosingType;
         this.invocationFunction = invocationFunction;
      }

      @Override
      protected Object handleInvocation(Object proxy, Method invoked, Object[] argv) throws Throwable {
         List