/* * Copyright 2013 Netflix, Inc. * * Licensed 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 feign; import dagger.Lazy; import dagger.ObjectGraph; import dagger.Provides; import feign.Logger.NoOpLogger; import feign.Request.Options; import feign.Target.HardCodedTarget; import feign.codec.Decoder; import feign.codec.Encoder; import feign.codec.ErrorDecoder; import feign.codec.IncrementalDecoder; import javax.inject.Named; import javax.inject.Singleton; import javax.net.ssl.HostnameVerifier; import javax.net.ssl.HttpsURLConnection; import javax.net.ssl.SSLSocketFactory; import java.io.Closeable; import java.lang.reflect.Method; import java.util.ArrayList; import java.util.Collections; import java.util.List; import java.util.Set; import java.util.concurrent.Executor; import java.util.concurrent.ExecutorService; import java.util.concurrent.Executors; import java.util.concurrent.ThreadFactory; import static java.lang.Thread.MIN_PRIORITY; /** * Feign's purpose is to ease development against http apis that feign * restfulness. *
* In implementation, Feign is a {@link Feign#newInstance factory} for * generating {@link Target targeted} http apis. */ public abstract class Feign implements Closeable { /** * Returns a new instance of an HTTP API, defined by annotations in the * {@link Feign Contract}, for the specified {@code target}. You should * cache this result. */ public abstract T newInstance(Target target); public static T create(Class apiType, String url, Object... modules) { return create(new HardCodedTarget(apiType, url), modules); } /** * Shortcut to {@link #newInstance(Target) create} a single {@code targeted} * http api using {@link ReflectiveFeign reflection}. */ public static T create(Target target, Object... modules) { return create(modules).newInstance(target); } /** * Returns a {@link ReflectiveFeign reflective} factory for generating * {@link Target targeted} http apis. */ public static Feign create(Object... modules) { return ObjectGraph.create(modulesForGraph(modules).toArray()).get(Feign.class); } /** * Returns an {@link ObjectGraph Dagger ObjectGraph} that can inject a * {@link ReflectiveFeign reflective} Feign. */ public static ObjectGraph createObjectGraph(Object... modules) { return ObjectGraph.create(modulesForGraph(modules).toArray()); } @SuppressWarnings("rawtypes") @dagger.Module(complete = false, injects = Feign.class, library = true) public static class Defaults { @Provides Logger.Level logLevel() { return Logger.Level.NONE; } @Provides Contract contract() { return new Contract.Default(); } @Provides SSLSocketFactory sslSocketFactory() { return SSLSocketFactory.class.cast(SSLSocketFactory.getDefault()); } @Provides HostnameVerifier hostnameVerifier() { return HttpsURLConnection.getDefaultHostnameVerifier(); } @Provides Client httpClient(Client.Default client) { return client; } @Provides Retryer retryer() { return new Retryer.Default(); } @Provides Logger noOp() { return new NoOpLogger(); } @Provides ErrorDecoder errorDecoder() { return new ErrorDecoder.Default(); } @Provides Options options() { return new Options(); } /** * Used for both http invocation and decoding when observers are used. */ @Provides @Singleton @Named("http") Executor httpExecutor() { return Executors.newCachedThreadPool(new ThreadFactory() { @Override public Thread newThread(final Runnable r) { return new Thread(new Runnable() { @Override public void run() { Thread.currentThread().setPriority(MIN_PRIORITY); r.run(); } }, MethodHandler.IDLE_THREAD_NAME); } }); } } /** *
* Configuration keys are formatted as unresolved see tags. *
* For example. *
    *
  • {@code Route53}: would match a class such as * {@code denominator.route53.Route53} *
  • {@code Route53#list()}: would match a method such as * {@code denominator.route53.Route53#list()} *
  • {@code Route53#listAt(Marker)}: would match a method such as * {@code denominator.route53.Route53#listAt(denominator.route53.Marker)} *
  • {@code Route53#listByNameAndType(String, String)}: would match a * method such as {@code denominator.route53.Route53#listAt(String, String)} *
*
* Note that there is no whitespace expected in a key! */ public static String configKey(Method method) { StringBuilder builder = new StringBuilder(); builder.append(method.getDeclaringClass().getSimpleName()); builder.append('#').append(method.getName()).append('('); for (Class param : method.getParameterTypes()) builder.append(param.getSimpleName()).append(','); if (method.getParameterTypes().length > 0) builder.deleteCharAt(builder.length() - 1); return builder.append(')').toString(); } private static List modulesForGraph(Object... modules) { List modulesForGraph = new ArrayList(3); modulesForGraph.add(new Defaults()); modulesForGraph.add(new ReflectiveFeign.Module()); if (modules != null) for (Object module : modules) modulesForGraph.add(module); return modulesForGraph; } private final Lazy httpExecutor; Feign(Lazy httpExecutor) { this.httpExecutor = httpExecutor; } @Override public void close() { Executor e = httpExecutor.get(); if (e instanceof ExecutorService) { ExecutorService.class.cast(e).shutdownNow(); } } }