{"id":34936876,"url":"https://github.com/microsphere-projects/microsphere-resilience4j","last_synced_at":"2026-06-02T11:01:05.790Z","repository":{"id":205697957,"uuid":"714247601","full_name":"microsphere-projects/microsphere-resilience4j","owner":"microsphere-projects","description":"The microsphere projects for resilience4j","archived":false,"fork":false,"pushed_at":"2026-05-31T03:04:30.000Z","size":885,"stargazers_count":2,"open_issues_count":1,"forks_count":9,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-31T05:05:42.661Z","etag":null,"topics":["bulkhead","circuit-breaker","cloud-native","devops","fault-tolerance","java","metrics","microservices","microsphere","resilience4j","spring","time-limit"],"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/microsphere-projects.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-11-04T10:56:23.000Z","updated_at":"2026-05-31T03:02:19.000Z","dependencies_parsed_at":"2026-05-31T05:03:24.164Z","dependency_job_id":null,"html_url":"https://github.com/microsphere-projects/microsphere-resilience4j","commit_stats":null,"previous_names":["microsphere-projects/microsphere-resilience4j"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/microsphere-projects/microsphere-resilience4j","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsphere-projects%2Fmicrosphere-resilience4j","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsphere-projects%2Fmicrosphere-resilience4j/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsphere-projects%2Fmicrosphere-resilience4j/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsphere-projects%2Fmicrosphere-resilience4j/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/microsphere-projects","download_url":"https://codeload.github.com/microsphere-projects/microsphere-resilience4j/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsphere-projects%2Fmicrosphere-resilience4j/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33818568,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-02T02:00:07.132Z","response_time":109,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["bulkhead","circuit-breaker","cloud-native","devops","fault-tolerance","java","metrics","microservices","microsphere","resilience4j","spring","time-limit"],"created_at":"2025-12-26T18:16:12.972Z","updated_at":"2026-06-02T11:01:05.776Z","avatar_url":"https://github.com/microsphere-projects.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Microsphere Resilience4j\n\n\u003e Microsphere Projects for [Resilience4j](https://github.com/resilience4j/microsphere-resilience4j)\n\n[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/microsphere-projects/microsphere-resilience4j)\n[![Maven Build](https://github.com/microsphere-projects/microsphere-resilience4j/actions/workflows/maven-build.yml/badge.svg)](https://github.com/microsphere-projects/microsphere-resilience4j/actions/workflows/maven-build.yml)\n[![Codecov](https://codecov.io/gh/microsphere-projects/microsphere-resilience4j/branch/main/graph/badge.svg)](https://app.codecov.io/gh/microsphere-projects/microsphere-resilience4j)\n![Maven](https://img.shields.io/maven-central/v/io.github.microsphere-projects/microsphere-resilience4j.svg)\n![License](https://img.shields.io/github/license/microsphere-projects/microsphere-resilience4j.svg)\n\nMicrosphere Resilience4j is an extension framework that enhances the capabilities of the Resilience4j library by\nproviding seamless integration with popular Java frameworks and libraries. It offers a unified approach to implementing\nfault tolerance patterns across different parts of an application.\n\nThe project aims to simplify the application of resilience patterns such as Circuit Breaker, Bulkhead, Rate Limiter,\nRetry, and Time Limiter in various contexts including:\n\n- Spring Web MVC applications\n- API clients (Feign)\n- Database access (MyBatis, JDBC with Druid and P6Spy)\n\n## Modules\n\n| **Module**                                | **Purpose**                                                            |\n|-------------------------------------------|------------------------------------------------------------------------|\n| **microsphere-resilience4j-parent**       | Defines the parent POM with dependency management and version profiles |\n| **microsphere-resilience4j-dependencies** | Centralizes dependency management for all project modules              |\n| **microsphere-resilience4j-commons**      | Common featurues of Resilience4j extension                             |\n| **microsphere-resilience4j-plugins**      | The plugins of Resilience4j                                            |\n| **microsphere-resilience4j-spring**       | Integration for Resilience4j Spring                                    |\n\n## Getting Started\n\nThe easiest way to get started is by adding the Microsphere Resilience4j BOM (Bill of Materials) to your project's\npom.xml:\n\n```xml\n\n\u003cdependencyManagement\u003e\n    \u003cdependencies\u003e\n        ...\n        \u003c!-- Microsphere Resilience4j Dependencies --\u003e\n        \u003cdependency\u003e\n            \u003cgroupId\u003eio.github.microsphere-projects\u003c/groupId\u003e\n            \u003cartifactId\u003emicrosphere-resilience4j-dependencies\u003c/artifactId\u003e\n            \u003cversion\u003e${microsphere-resilience4j.version}\u003c/version\u003e\n            \u003ctype\u003epom\u003c/type\u003e\n            \u003cscope\u003eimport\u003c/scope\u003e\n        \u003c/dependency\u003e\n        ...\n    \u003c/dependencies\u003e\n\u003c/dependencyManagement\u003e\n```\n\n`${microsphere-resilience4j.version}` has two branches:\n\n| **Branches** | **Purpose**                                      | **Latest Version** |\n|--------------|--------------------------------------------------|--------------------|\n| **main**     | Compatible with Spring Cloud 2022.0.x - 2025.0.x | 0.2.1              |\n| **1.x**      | Compatible with Spring Cloud Hoxton - 2021.0.x   | 0.1.1              |\n\n## Building from Source\n\nYou don't need to build from source unless you want to try out the latest code or contribute to the project.\n\nTo build the project, follow these steps:\n\n1. Clone the repository:\n\n```bash\ngit clone https://github.com/microsphere-projects/microsphere-resilience4j.git\n```\n\n2. Build the source:\n\n- Linux/MacOS:\n\n```bash\n./mvnw package\n```\n\n- Windows:\n\n```powershell\nmvnw.cmd package\n```\n\n## Contributing\n\nWe welcome your contributions! Please read [Code of Conduct](./CODE_OF_CONDUCT.md) before submitting a pull request.\n\n## Reporting Issues\n\n* Before you log a bug, please search\n  the [issues](https://github.com/microsphere-projects/microsphere-resilience4j/issues)\n  to see if someone has already reported the problem.\n* If the issue doesn't already\n  exist, [create a new issue](https://github.com/microsphere-projects/microsphere-resilience4j/issues/new).\n* Please provide as much information as possible with the issue report.\n\n## Documentation\n\n### User Guide\n\n[DeepWiki Host](https://deepwiki.com/microsphere-projects/microsphere-resilience4j)\n\n### Wiki\n\n[Github Host](https://github.com/microsphere-projects/microsphere-resilience4j/wiki)\n\n### JavaDoc\n\n- [microsphere-resilience4j-commons](https://javadoc.io/doc/io.github.microsphere-projects/microsphere-resilience4j-commons)\n- [microsphere-resilience4j-spring](https://javadoc.io/doc/io.github.microsphere-projects/microsphere-resilience4j-spring)\n- [microsphere-resilience4j-alibaba-druid](https://javadoc.io/doc/io.github.microsphere-projects/microsphere-resilience4j-alibaba-druid)\n- [microsphere-resilience4j-mybatis](https://javadoc.io/doc/io.github.microsphere-projects/microsphere-resilience4j-mybatis)\n- [microsphere-resilience4j-openfeign](https://javadoc.io/doc/io.github.microsphere-projects/microsphere-resilience4j-openfeign)\n- [microsphere-resilience4j-spring-web](https://javadoc.io/doc/io.github.microsphere-projects/microsphere-resilience4j-spring-web)\n- [microsphere-resilience4j-spring](https://javadoc.io/doc/io.github.microsphere-projects/microsphere-resilience4j-spring)\n\n## License\n\nThe Microsphere Spring is released under the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0).","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmicrosphere-projects%2Fmicrosphere-resilience4j","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmicrosphere-projects%2Fmicrosphere-resilience4j","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmicrosphere-projects%2Fmicrosphere-resilience4j/lists"}