{"id":20700339,"url":"https://github.com/kptfh/feign-reactive","last_synced_at":"2025-06-27T00:37:09.431Z","repository":{"id":30002479,"uuid":"123467801","full_name":"kptfh/feign-reactive","owner":"kptfh","description":"Reactive Feign client based on Spring WebFlux","archived":false,"fork":false,"pushed_at":"2023-04-15T09:18:46.000Z","size":348,"stargazers_count":166,"open_issues_count":13,"forks_count":160,"subscribers_count":13,"default_branch":"master","last_synced_at":"2025-05-19T23:04:29.881Z","etag":null,"topics":["feign","java","reactive","reactor","ribbon","rxjava2","spring-webclient","spring-webflux"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kptfh.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-03-01T17:23:04.000Z","updated_at":"2025-03-27T00:33:33.000Z","dependencies_parsed_at":"2024-12-19T15:17:37.442Z","dependency_job_id":null,"html_url":"https://github.com/kptfh/feign-reactive","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/kptfh/feign-reactive","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kptfh%2Ffeign-reactive","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kptfh%2Ffeign-reactive/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kptfh%2Ffeign-reactive/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kptfh%2Ffeign-reactive/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kptfh","download_url":"https://codeload.github.com/kptfh/feign-reactive/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kptfh%2Ffeign-reactive/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262166335,"owners_count":23269026,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["feign","java","reactive","reactor","ribbon","rxjava2","spring-webclient","spring-webflux"],"created_at":"2024-11-17T00:35:01.022Z","updated_at":"2025-06-27T00:37:09.407Z","avatar_url":"https://github.com/kptfh.png","language":"Java","readme":"Happy to announce that from now Java Reactive Feign client is officially backed by Playtika. All development will be conducted in Playtika fork https://github.com/Playtika/feign-reactive\n\n[Subscribe to stay up to date 🙂](https://www.youtube.com/channel/UCAIRpdkVAj1RT6butHUV9yg)\n\n# feign-reactive\n\n[ ![Download](https://api.bintray.com/packages/kptfh/feign-reactive/client/images/download.svg) ](https://bintray.com/kptfh/feign-reactive/client/_latestVersion)\n\nUse Feign with Spring WebFlux\n\n## Overview\n\nImplementation of Feign on Spring WebClient. Brings you the best of two worlds together : \nconcise syntax of Feign to write client side API on fast, asynchronous and\nnon-blocking HTTP client of Spring WebClient.\n\n## Modules\n  \n  **_feign-reactor-core_** : base classes and interfaces that should allow to implement alternative reactor Feign\n  \n  **_feign-reactor-webclient_** : Spring WebClient based implementation of reactor Feign \n  \n  **_feign-reactor-cloud_** : Spring Cloud implementation of reactor Feign (Ribbon/Hystrix)\n  \n  **_feign-reactor-rx2_** : Rx2 compatible implementation of reactor Feign (depends on feign-reactor-webclient)\n  \n  **_feign-reactor-jetty_** : experimental Reactive Jetty client based implementation of reactor Feign (doesn't depend on feign-reactor-webclient). In future will allow to write pure Rx2 version.\n  - have greater reactivity level then Spring WebClient. By default don't collect body to list instead starts sending request body as stream. \n  - starts receiving reactive response before all reactive request body has been sent\n  - process Flux\u003c`String`\u003e correctly in request and response body  \n\n## Usage\n\nWrite Feign API as usual, but every method of interface\n - may accept `org.reactivestreams.Publisher` as body\n - must return `reactor.core.publisher.Mono` or `reactor.core.publisher.Flux`.\n\n```java\n@Headers({ \"Accept: application/json\" })\npublic interface IcecreamServiceApi {\n\n  @RequestLine(\"GET /icecream/flavors\")\n  Flux\u003cFlavor\u003e getAvailableFlavors();\n\n  @RequestLine(\"GET /icecream/mixins\")\n  Flux\u003cMixin\u003e getAvailableMixins();\n\n  @RequestLine(\"POST /icecream/orders\")\n  @Headers(\"Content-Type: application/json\")\n  Mono\u003cBill\u003e makeOrder(IceCreamOrder order);\n\n  @RequestLine(\"GET /icecream/orders/{orderId}\")\n  Mono\u003cIceCreamOrder\u003e findOrder(@Param(\"orderId\") int orderId);\n\n  @RequestLine(\"POST /icecream/bills/pay\")\n  @Headers(\"Content-Type: application/json\")\n  Mono\u003cVoid\u003e payBill(Publisher\u003cBill\u003e bill);\n}\n```\nBuild the client :\n\n```java\n\n/* Create instance of your API */\nIcecreamServiceApi client = ReactiveFeign\n    .builder()\n    .target(IcecreamServiceApi.class, \"http://www.icecreame.com\")\n\n/* Execute nonblocking requests */\nFlux\u003cFlavor\u003e flavors = icecreamApi.getAvailableFlavors();\nFlux\u003cMixin\u003e mixins = icecreamApi.getAvailableMixins();\n```\n\nor cloud aware client :\n\n```java\n IcecreamServiceApi client = CloudReactiveFeign.\u003cIcecreamServiceApi\u003ebuilder()\n    .setFallback(new TestInterface() {\n        @Override\n        public Mono\u003cString\u003e get() {\n            return Mono.just(\"fallback\");\n        }\n    })\n    .setLoadBalancerCommand(\n         LoadBalancerCommand.builder()\n                 .withLoadBalancer(AbstractLoadBalancer.class.cast(getNamedLoadBalancer(serviceName)))\n                 .withRetryHandler(new DefaultLoadBalancerRetryHandler(1, 1, true))\n                 .build()\n    )\n    .target(IcecreamServiceApi.class, \"http://\" + serviceName);\n\n/* Execute nonblocking requests */\nFlux\u003cFlavor\u003e flavors = icecreamApi.getAvailableFlavors();\nFlux\u003cMixin\u003e mixins = icecreamApi.getAvailableMixins();\n```\n\n## Rx2 Usage \n\nWrite Feign API as usual, but every method of interface\n - may accept `Flowable`, `Observable`, `Single` or `Maybe` as body\n - must return `Flowable`, `Observable`, `Single` or `Maybe`.\n\n```java\n@Headers({\"Accept: application/json\"})\npublic interface IcecreamServiceApi {\n\n  @RequestLine(\"GET /icecream/flavors\")\n  Flowable\u003cFlavor\u003e getAvailableFlavors();\n\n  @RequestLine(\"GET /icecream/mixins\")\n  Observable\u003cMixin\u003e getAvailableMixins();\n\n  @RequestLine(\"POST /icecream/orders\")\n  @Headers(\"Content-Type: application/json\")\n  Single\u003cBill\u003e makeOrder(IceCreamOrder order);\n\n  @RequestLine(\"GET /icecream/orders/{orderId}\")\n  Maybe\u003cIceCreamOrder\u003e findOrder(@Param(\"orderId\") int orderId);\n\n  @RequestLine(\"POST /icecream/bills/pay\")\n  @Headers(\"Content-Type: application/json\")\n  Single\u003cLong\u003e payBill(Bill bill);\n```\nBuild the client :\n\n```java\n\n/* Create instance of your API */\nIcecreamServiceApi client = Rx2ReactiveFeign\n    .builder()\n    .target(IcecreamServiceApi.class, \"http://www.icecreame.com\")\n\n/* Execute nonblocking requests */\nFlowable\u003cFlavor\u003e flavors = icecreamApi.getAvailableFlavors();\nObservable\u003cMixin\u003e mixins = icecreamApi.getAvailableMixins();\n```\n\n## Maven\n\n```xml\n\u003crepositories\u003e\n    \u003crepository\u003e\n        \u003cid\u003ebintray-kptfh-feign-reactive\u003c/id\u003e\n        \u003cname\u003ebintray\u003c/name\u003e\n        \u003curl\u003ehttps://dl.bintray.com/kptfh/feign-reactive\u003c/url\u003e\n    \u003c/repository\u003e\n\u003c/repositories\u003e\n...\n\u003cdependencies\u003e\n    ...\n    \n    \u003cdependency\u003e\n        \u003cgroupId\u003eio.github.reactivefeign\u003c/groupId\u003e\n        \u003cartifactId\u003efeign-reactor-cloud\u003c/artifactId\u003e\n        \u003cversion\u003e1.0.0\u003c/version\u003e\n    \u003c/dependency\u003e\n    \n    or if you don't need cloud specific functionality\n    \n    \u003cdependency\u003e\n        \u003cgroupId\u003eio.github.reactivefeign\u003c/groupId\u003e\n        \u003cartifactId\u003efeign-reactor-webclient\u003c/artifactId\u003e\n        \u003cversion\u003e1.0.0\u003c/version\u003e\n    \u003c/dependency\u003e\n    \n    or if you tend to use Rx2 interfaces\n    \n    \u003cdependency\u003e\n            \u003cgroupId\u003eio.github.reactivefeign\u003c/groupId\u003e\n            \u003cartifactId\u003efeign-reactor-rx2\u003c/artifactId\u003e\n            \u003cversion\u003e1.0.0\u003c/version\u003e\n        \u003c/dependency\u003e\n    ...\n\u003c/dependencies\u003e\n```\n\n## License\n\nLibrary distributed under Apache License Version 2.0.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkptfh%2Ffeign-reactive","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkptfh%2Ffeign-reactive","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkptfh%2Ffeign-reactive/lists"}