{"id":19237585,"url":"https://github.com/fengzhizi715/okhttp-extension","last_synced_at":"2025-04-21T06:31:30.091Z","repository":{"id":41208152,"uuid":"294738243","full_name":"fengzhizi715/okhttp-extension","owner":"fengzhizi715","description":"okhttp-extension 是针对 okhttp 3 增强的网络框架。使用 Kotlin 特性编写，提供便捷的 DSL 方式创建网络请求，支持协程、响应式编程等等。 ","archived":false,"fork":false,"pushed_at":"2023-02-15T11:15:14.000Z","size":1800,"stargazers_count":44,"open_issues_count":0,"forks_count":5,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-04-01T10:41:52.927Z","etag":null,"topics":["coroutines","dsl","feign","flow","interceptor","kotlin","okhttp3","resilience4j","retrofit2","rxjava","stomp","websocket"],"latest_commit_sha":null,"homepage":"","language":"Kotlin","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/fengzhizi715.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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":"2020-09-11T15:53:47.000Z","updated_at":"2024-12-09T06:00:33.000Z","dependencies_parsed_at":"2024-11-09T16:31:43.260Z","dependency_job_id":"cf4140ea-06c6-4060-9f32-f67d515c79b1","html_url":"https://github.com/fengzhizi715/okhttp-extension","commit_stats":null,"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fengzhizi715%2Fokhttp-extension","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fengzhizi715%2Fokhttp-extension/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fengzhizi715%2Fokhttp-extension/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fengzhizi715%2Fokhttp-extension/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fengzhizi715","download_url":"https://codeload.github.com/fengzhizi715/okhttp-extension/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250008195,"owners_count":21359945,"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":["coroutines","dsl","feign","flow","interceptor","kotlin","okhttp3","resilience4j","retrofit2","rxjava","stomp","websocket"],"created_at":"2024-11-09T16:27:31.003Z","updated_at":"2025-04-21T06:31:29.524Z","avatar_url":"https://github.com/fengzhizi715.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![@Tony沈哲 on weibo](https://img.shields.io/badge/weibo-%40Tony%E6%B2%88%E5%93%B2-blue.svg)](http://www.weibo.com/fengzhizi715)\n[![License](https://img.shields.io/badge/license-Apache%202-lightgrey.svg)](https://www.apache.org/licenses/LICENSE-2.0.html)\n[![](https://jitpack.io/v/fengzhizi715/okhttp-extension.svg)](https://jitpack.io/#fengzhizi715/okhttp-extension)\n\n# okhttp-extension\n\nokhttp-extension 是针对 okhttp 3 增强的网络框架。使用 Kotlin 特性编写，提供便捷的 DSL 方式创建网络请求，支持协程、响应式编程等等。\n\n其中 core 模块只依赖 OkHttp，不会引入第三方库。\n\nokhttp-extension 可以整合 Retrofit、Feign 框架，还提供了很多常用的拦截器，以及非常多的特性。 okhttp-extension 也给开发者提供一种新的选择。\n\n## Features:\n\n* 支持 DSL 创建 HTTP `GET`/`POST`/`PUT`/`HEAD`/`DELETE`/`PATCH` requests.\n* 支持文件上传/下载\n* 支持 Kotlin 协程\n* 支持响应式(RxJava、Spring Reactor)\n* 支持函数式\n* 支持熔断器(Resilience4j)\n* 支持异步请求的取消\n* 支持预连接\n* 支持 Request、Response 的拦截器\n* 提供多款常用的拦截器\n* 支持自定义线程池\n* 支持整合 Retrofit、Feign 框架\n* 支持 WebSocket 的实现、自动重连等\n* 支持 Stomp over WebSocket\n* core 模块只依赖 OkHttp，不依赖其他第三方库\n\n## 更详细的功能请查看 [wiki](https://github.com/fengzhizi715/okhttp-extension/wiki)\n\n![okhttp-extension](images/okhttp-extension.png)\n\n## 最新版本\n模块|最新版本\n---|:-------------:\ncore|[![](https://jitpack.io/v/fengzhizi715/okhttp-extension.svg)](https://jitpack.io/#fengzhizi715/okhttp-extension)|\ncoroutines|[![](https://jitpack.io/v/fengzhizi715/okhttp-extension.svg)](https://jitpack.io/#fengzhizi715/okhttp-extension)|\nrxjava3|[![](https://jitpack.io/v/fengzhizi715/okhttp-extension.svg)](https://jitpack.io/#fengzhizi715/okhttp-extension)|\nrxjava2|[![](https://jitpack.io/v/fengzhizi715/okhttp-extension.svg)](https://jitpack.io/#fengzhizi715/okhttp-extension)|\nreactor|[![](https://jitpack.io/v/fengzhizi715/okhttp-extension.svg)](https://jitpack.io/#fengzhizi715/okhttp-extension)|\nresult|[![](https://jitpack.io/v/fengzhizi715/okhttp-extension.svg)](https://jitpack.io/#fengzhizi715/okhttp-extension)|\nresilience4j|[![](https://jitpack.io/v/fengzhizi715/okhttp-extension.svg)](https://jitpack.io/#fengzhizi715/okhttp-extension)|\n\n## 下载\n\n将它添加到项目的 root build.gradle 中：\n\n```groovy\n\tallprojects {\n\t\trepositories {\n\t\t\t...\n\t\t\tmaven { url 'https://jitpack.io' }\n\t\t}\n\t}\n```\n\n其余，按需依赖各个模块，其中 core 是必须要依赖的\n\n```groovy\nimplementation 'com.github.fengzhizi715.okhttp-extension:core:\u003clatest-version\u003e'\n```\n\n```groovy\nimplementation 'com.github.fengzhizi715.okhttp-extension:coroutines:\u003clatest-version\u003e'\n```\n\n```groovy\nimplementation 'com.github.fengzhizi715.okhttp-extension:rxjava3:\u003clatest-version\u003e'\n```\n\n```groovy\nimplementation 'com.github.fengzhizi715.okhttp-extension:rxjava2:\u003clatest-version\u003e'\n```\n\n```groovy\nimplementation 'com.github.fengzhizi715.okhttp-extension:reactor:\u003clatest-version\u003e'\n```\n\n```groovy\nimplementation 'com.github.fengzhizi715.okhttp-extension:result:\u003clatest-version\u003e'\n```\n\n```groovy\nimplementation 'com.github.fengzhizi715.okhttp-extension:resilience4j:\u003clatest-version\u003e'\n```\n\n## 感谢\n* 参考了 [http4k](https://github.com/http4k/http4k) 的实现\n* 参考了 [kohttp](https://github.com/rybalkinsd/kohttp) 的实现\n* 参考了 [kotlin-stomp-client](https://github.com/DinuBerinde/kotlin-stomp-client) 的实现\n\n## TODO List:\n\n* 完善文档\n* 完善和 Spring/Springboot 集成以及相关示例\n* 支持 kotlinx-serialization\n* 异常的日志记录\n* 支持 Micrometer\n\n\n## ChangeLog\n\n[ChangeLog](CHANGELOG.md)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffengzhizi715%2Fokhttp-extension","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffengzhizi715%2Fokhttp-extension","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffengzhizi715%2Fokhttp-extension/lists"}