### Version 11.9
* `OkHttpClient` now implements `AsyncClient`
### Version 10.9
* Configurable to disable streaming mode for Default client by verils (#1182)
* Overriding query parameter name by boggard (#1184)
* Internal feign metrics by velo:
* Dropwizard metrics 5 (#1181)
* Micrometer (#1188)
### Version 10.8
* async feign variant supporting CompleteableFutures by motinis (#1174)
* deterministic iterations for Feign mocks by contextshuffling (#1165)
* Async client for apache http 5 by velo (#1179)
### Version 10.7
* Fix for vunerabilities reported by snky (#1121)
* Makes iterator compatible with Java iterator expected behavior (#1117)
* Bump reactive dependencies (#1105)
* Deprecated `encoded` and add comment (#1108)
### Version 10.6
* Remove java8 module (#1086)
* Add composed Spring annotations support (#1090)
* Generate mocked clients for tests from feign interfaces (#1092)
### Version 10.5
* Add Apache Http 5 Client (#1065)
* Updating Apache HttpClient to 4.5.10 (#1080) (#1081)
* Spring4 contract (#1069)
* Declarative contracts (#1060)
### Version 10.4
* Adding support for JDK Proxy (#1045)
* Add Google HTTP Client support (#1057)
### Version 10.3
* Upgrade dependencies with security vunerabilities (#997 #1010 #1011 #1024 #1025 #1031 #1032 )
* Parse Retry-After header responses that include decimal points (#980)
* Fine-grained HTTP error exceptions with client and server errors (#854)
* Adds support for per request timeout options (#970)
* Unwrap RetryableException and throw cause (#737)
* JacksonEncoder avoids intermediate String request body (#989)
* Respect decode404 flag and decode 404 response body (#1012)
* Maintain user-given order for header values (#1009)
### Version 10.1
* Refactoring RequestTemplate to RFC6570 (#778)
* Allow JAXB context caching in factory (#761)
* Reactive Wrapper Support (#795)
* Introduced native http2 client using Java 11 (#806)
* Unwrap RetryableException and throw cause (#737)
* Supports PATCH without a body paramter (#824)
* Feign-Ribbon integration now depends on Ribbon 2.3.0, updated from Ribbon 2.1.1 (#826)
### Version 10.0
* Feign baseline is now JDK 8
- Feign is now being built and tested with OpenJDK 11 as well. Releases and code base will use JDK 8, we are just testing compatibility with JDK 11.
* Removed @Deprecated methods marked for removal on feign 10.
* `RetryException` includes the `Method` used for the offending `Request` .
* `Response` objects now contain the `Request` used.
### Version 9.6
* Feign builder now supports flag `doNotCloseAfterDecode` to support lazy iteration of responses.
* Adds `JacksonIteratorDecoder` and `StreamDecoder` to decode responses as `java.util.Iterator` or `java.util.stream.Stream` .
### Version 9.5.1
* When specified, Content-Type header is now included on OkHttp requests lacking a body.
* Sets empty HttpEntity if apache request body is null.
### Version 9.5
* Introduces `feign-java8` with support for `java.util.Optional`
* Adds `Feign.Builder.mapAndDecode()` to allow response preprocessing before decoding it.
### Version 9.4.1
* 404 responses are no longer swallowed for `void` return types.
### Version 9.4
* Adds Builder class to JAXBDecoder for disabling namespace-awareness (defaults to true).
### Version 9.3
* Adds `FallbackFactory` , allowing access to the cause of a Hystrix fallback
* Adds support for encoded parameters via `@Param(encoded = true)`
### Version 9.2
* Adds Hystrix `SetterFactory` to customize group and command keys
* Supports context path when using Ribbon `LoadBalancingTarget`
* Adds builder methods for the Response object
* Deprecates Response factory methods
* Adds nullable Request field to the Response object
### Version 9.1
* Allows query parameters to match on a substring. Ex `q=body:{body}`
### Version 9.0
* Migrates to maven from gradle
* Changes maven groupId to `io.github.openfeign`
### Version 8.18
* Adds support for expansion of @Param lists
* Content-Length response bodies with lengths greater than Integer.MAX_VALUE report null length
* Previously the OkhttpClient would throw an exception, and ApacheHttpClient
would report a wrong, possibly negative value
* Adds support for encoded query parameters in `@QueryMap` via `@QueryMap(encoded = true)`
* Keys in `Response.headers` are now lower-cased. This map is now case-insensitive with regards to keys,
and iterates in lexicographic order.
* This is a step towards supporting http2, as header names in http1 are treated as case-insensitive
and http2 down-cases header names.
### Version 8.17
* Adds support to RxJava Completable via `HystrixFeign` builder with fallback support
* Upgraded hystrix-core to 1.4.26
* Upgrades dependency version for OkHttp/MockWebServer 3.2.0
### Version 8.16
* Adds `@HeaderMap` annotation to support dynamic header fields and values
* Add support for default and static methods on interfaces
### Version 8.15
* Adds `@QueryMap` annotation to support dynamic query parameters
* Supports runtime injection of `Param.Expander` via `MethodMetadata.indexToExpander`
* Adds fallback support for HystrixCommand, Observable, and Single results
* Supports PUT without a body parameter
* Supports substitutions in `@Headers` like in `@Body` . (#326)
* **Note:** You might need to URL-encode literal values of `{` or `%` in your existing code.
### Version 8.14
* Add support for RxJava Observable and Single return types via the `HystrixFeign` builder.
* Adds fallback implementation configuration to the `HystrixFeign` builder
* Bumps dependency versions, most notably Gson 2.5 and OkHttp 2.7
### Version 8.13
* Never expands >8kb responses into memory
Adds Feign.Builder.decode404() to reduce boilerplate for empty semantics
This adds the `Feign.Builder.decode404()` flag which indicates decoders
should process responses with 404 status. It also changes all
first-party decoders (like gson) to return well-known empty values by
default. Further customization is possible by wrapping or creating a
custom decoder.
Prior to this change, we used custom invocation handlers as the way to
add fallback values based on exception or return status. `feign-hystrix`
uses this to return `HystrixCommand<X>`, but the general pattern applies
to anything that has a type representing both success and failure, such
as `Try<X>` or `Observable<X>`.
As we define it here, 404 status is not a retry or fallback policy, it
is just empty semantics. By limiting Feign's special processing to 404,
we gain a lot with very little supporting code.
If instead we opened all codes, Feign could easily turn bad request,
redirect, or server errors silently to null. This sort of configuration
issue is hard to troubleshoot. 404 -> empty is a very safe policy vs
all codes.
Moreover, we don't create a cliff, where folks seeking fallback policy
eventually realize they can't if only given a response code. Fallback
systems like Hystrix address exceptions that occur before or in lieu of
a response. By special-casing 404, we avoid a slippery slope of half-
implementing Hystrix.
Finally, 404 handling has been commonly requested: it has a clear use-
case, and through that value. This design supports that without breaking
compatibility, or impacting existing integrations such as Hystrix or
Ribbon.
See #238 #287
9 years ago
### Version 8.12
* Adds `Feign.Builder.decode404()` to reduce boilerplate for empty semantics.
### Version 8.11
* Adds support for Hystrix via a `HystrixFeign` builder.
### Version 8.10
* Adds HTTP status to FeignException for easier response handling
* Reads class-level @Produces/@Consumes JAX-RS annotations
* Supports POST without a body parameter
### Version 8.9
* Skips error handling when return type is `Response`
### Version 8.8
* Adds jackson-jaxb codec
* Bumps dependency versions for integrations
* OkHttp/MockWebServer 2.5.0
* Jackson 2.6.1
* Apache Http Client 4.5
* JMH 1.10.5
### Version 8.7
* Bumps dependency versions for integrations
* OkHttp/MockWebServer 2.4.0
* Gson 2.3.1
* Jackson 2.6.0
* Ribbon 2.1.0
* SLF4J 1.7.12
### Version 8.6
* Adds base api support via single-inheritance interfaces
### Version 7.5/8.5
* Added possibility to leave slash encoded in path parameters
### Version 8.4
* Correct Retryer bug that prevented it from retrying requests after the first 5 retry attempts.
* **Note:** If you have a custom `feign.Retryer` implementation you now must now implement `public Retryer clone()` .
It is suggested that you simply return a new instance of your Retryer class.
### Version 8.3
* Adds client implementation for Apache Http Client
### Version 8.2
* Allows customized request construction by exposing `Request.create()`
* Adds JMH benchmark module
* Enforces source compatibility with animal-sniffer
### Version 8.1
* Allows `@Headers` to be applied to a type
### Version 8.0
* Removes Dagger 1.x Dependency
* Removes support for parameters annotated with `javax.inject.@Named` . Use `feign.@Param` instead.
* Makes body parameter type explicit.
### Version 7.4
* Allows `@Headers` to be applied to a type
### Version 7.3
* Adds Request.Options support to RibbonClient
* Adds LBClientFactory to enable caching of Ribbon LBClients
* Updates to Ribbon 2.0-RC13
* Updates to Jackson 2.5.1
* Supports query parameters without values
### Version 7.2
* Adds `Feign.Builder.build()`
* Opens constructor for Gson and Jackson codecs which accepts type adapters
* Adds EmptyTarget for interfaces who exclusively declare URI methods
* Reformats code according to [Google Java Style ](https://google-styleguide.googlecode.com/svn/trunk/javaguide.html )
### Version 7.1
* Introduces feign.@Param to annotate template parameters. Users must migrate from `javax.inject.@Named` to `feign.@Param` before updating to Feign 8.0.
* Supports custom expansion via `@Param(value = "name", expander = CustomExpander.class)`
* Adds OkHttp integration
* Allows multiple headers with the same name.
* Ensures Accept headers default to `*/*`
### Version 7.0
* Expose reflective dispatch hook: InvocationHandlerFactory
* Add JAXB integration
* Add SLF4J integration
* Upgrade to Dagger 1.2.2.
* **Note:** Dagger-generated code prior to version 1.2.0 is incompatible with Dagger 1.2.0 and beyond. Dagger users should upgrade Dagger to at least version 1.2.0, and recompile any dependency-injected classes.
### Version 6.1.3
* Updates to Ribbon 2.0-RC5
### Version 6.1.1
* Fix for #85
### Version 6.1.0
* Add [SLF4J ](http://www.slf4j.org/ ) integration
### Version 6.0.1
* Fix for BasicAuthRequestInterceptor when username and/or password are long.
### Version 6.0
* Support binary request and response bodies.
* Don't throw http status code exceptions when return type is `Response` .
### Version 5.4.0
* Add `BasicAuthRequestInterceptor`
* Add Jackson integration
### Version 5.3.0
* Split `GsonCodec` into `GsonEncoder` and `GsonDecoder` , which are easy to use with `Feign.Builder`
* Deprecate `GsonCodec`
* Update to Ribbon 0.2.3
### Version 5.2.0
* Support usage of `GsonCodec` via `Feign.Builder`
### Version 5.1.0
* Correctly handle IOExceptions wrapped by Ribbon.
* Miscellaneous findbugs fixes.
### Version 5.0.1
* `Decoder.decode()` is no longer called for `Response` or `void` types.
### Version 5.0
* Remove support for Observable methods.
* Use single non-generic Decoder/Encoder instead of sets of type-specific Decoders/Encoders.
* Decoders/Encoders are now more flexible, having access to the Response/RequestTemplate respectively.
* Moved SaxDecoder into `feign-sax` dependency.
* SaxDecoder now decodes multiple types.
* Remove pattern decoders in favor of SaxDecoder.
* Added Feign.Builder to simplify client customizations without using Dagger.
* Gson type adapters can be registered as Dagger set bindings.
* `Feign.create(...)` now requires specifying an encoder and decoder.
### Version 4.4.1
* Fix NullPointerException on calling equals and hashCode.
### Version 4.4
* Support overriding default HostnameVerifier.
* Support GZIP content encoding for request bodies.
* Support Iterable args for query parameters.
* Support urls which have query parameters.
### Version 4.3
* Add ability to configure zero or more RequestInterceptors.
* Remove `overrides = true` on codec modules.
### Version 4.2/3.3
* Document and enforce JAX-RS annotation processing from server POV
* Skip query template parameters when corresponding java arg is null
### Version 4.1/3.2
* update to dagger 1.1
* Add wikipedia search example
* Allow `@Path` on types in feign-jaxrs
### Version 4.0
* Support RxJava-style Observers.
* Return type can be `Observable<T>` for an async equiv of `Iterable<T>` .
* `Observer<T>` replaces `IncrementalCallback<T>` and is passed to `Observable.subscribe()` .
* On `Subscription.unsubscribe()` , `Observer.onNext()` will stop being called.
### Version 3.1
* Log when an http request is retried or a response fails due to an IOException.
### Version 3.0
* Added support for asynchronous callbacks via `IncrementalCallback<T>` and `IncrementalDecoder.TextStream<T>` .
* Wire is now Logger, with configurable Logger.Level.
* Added `feign-gson` codec, used via `new GsonModule()`
* changed codec to be similar to [WebSocket JSR 356 ](http://docs.oracle.com/javaee/7/api/javax/websocket/package-summary.html )
* Decoder is now `Decoder.TextStream<T>`
* BodyEncoder is now `Encoder.Text<T>`
* FormEncoder is now `Encoder.Text<Map<String, ?>>`
* Encoder and Decoders are specified via `Provides.Type.SET` binding.
* Default Encoder and Form Encoder is `Encoder.Text<Object>`
* Default Decoder is `Decoder.TextStream<Object>`
* ErrorDecoder now returns Exception, not fallback.
* There can only be one `ErrorDecoder` and `Request.Options` binding now.
### Version 2.0.0
* removes guava and jax-rs dependencies
* adds JAX-RS integration
### Version 1.1.0
* adds Ribbon integration
* adds cli example
* exponential backoff customizable via Retryer.Default ctor
### Version 1.0.0
* Initial open source release
