Finagle-circuit is a bolt-on HTTP circuit-breaking library for the Finagle RPC framework from Twitter. It provides a more a granular circuit-breaking ability and includes a HTTP Filter which can be used with Finagle servers and clients.
###See it See the example code.
###Get it
Add the following lines to build.sbt
. Note that this library doesn't depend on a particular version of Finagle,
it has been built and tested with the version below:
resolvers += "JCenter" at "https://jcenter.bintray.com"
libraryDependencies += "com.twitter" %% "finagle-http" % "6.30.0"
libraryDependencies += "io.github.daviddenton" %% "finagle-circuit" % "X.X.X"
###Migration notes
####v5.0.0
- Upgrading to v6.41.0 of finagle-http.
- *Note that the behaviour of timeouts has changed from v4. Previously, calls would NOT eagerly timeout, but merely register any call taking over n-seconds as a failure. Now, calls throw a
####v4.0.0
- Upgrading to v6.30.0 of finagle-http. Finagle-httpx has been renamed as of this release, so have migrated the API to use this instead.
####v3.0.0
- Breaking change: simple repackage of all classes into
io.github.finaglecircuit
- Upgrade Akka-actor dependency
####v2.0.0
- Upgrading to v6.29.0 of Finagle-httpx. Finagle-http has been removed as of this release, so have migrated the API
to use this instead.
- References to
HttpRequest/Response
Netty classes are nowRequest/Response
instead - References to
HttpResponseStatus
changed toStatus
- References to ππ
HttpMethod.GET/POST/...
changd toMethod.Get/Post/...
- References to
Http.XXX()
will now useHttp.XXX()
instead
- References to
####v1.1.0
- Release to be used for versions of Finagle upto 6.28.0