{"id":34936884,"url":"https://github.com/microsphere-projects/microsphere-mybatis","last_synced_at":"2026-04-05T17:01:44.465Z","repository":{"id":277784442,"uuid":"933135889","full_name":"microsphere-projects/microsphere-mybatis","owner":"microsphere-projects","description":"The microsphere project for MyBatis","archived":false,"fork":false,"pushed_at":"2026-03-31T04:06:18.000Z","size":461,"stargazers_count":1,"open_issues_count":1,"forks_count":2,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-31T05:55:28.275Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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":"2025-02-15T08:25:18.000Z","updated_at":"2026-03-31T04:06:04.000Z","dependencies_parsed_at":"2026-01-18T06:06:24.145Z","dependency_job_id":null,"html_url":"https://github.com/microsphere-projects/microsphere-mybatis","commit_stats":null,"previous_names":["microsphere-projects/microsphere-mybatis"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/microsphere-projects/microsphere-mybatis","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsphere-projects%2Fmicrosphere-mybatis","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsphere-projects%2Fmicrosphere-mybatis/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsphere-projects%2Fmicrosphere-mybatis/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsphere-projects%2Fmicrosphere-mybatis/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/microsphere-projects","download_url":"https://codeload.github.com/microsphere-projects/microsphere-mybatis/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsphere-projects%2Fmicrosphere-mybatis/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31442924,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-05T15:22:31.103Z","status":"ssl_error","status_checked_at":"2026-04-05T15:22:00.205Z","response_time":75,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":[],"created_at":"2025-12-26T18:16:18.226Z","updated_at":"2026-04-05T17:01:44.457Z","avatar_url":"https://github.com/microsphere-projects.png","language":"Java","readme":"# Microsphere MyBatis\n\n\u003e Microsphere Projects for MyBatis\n\n[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/microsphere-projects/microsphere-mybatis)\n[![zread](https://img.shields.io/badge/Ask_Zread-_.svg?style=flat\u0026color=00b0aa\u0026labelColor=000000\u0026logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB3aWR0aD0iMTYiIGhlaWdodD0iMTYiIHZpZXdCb3g9IjAgMCAxNiAxNiIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTQuOTYxNTYgMS42MDAxSDIuMjQxNTZDMS44ODgxIDEuNjAwMSAxLjYwMTU2IDEuODg2NjQgMS42MDE1NiAyLjI0MDFWNC45NjAxQzEuNjAxNTYgNS4zMTM1NiAxLjg4ODEgNS42MDAxIDIuMjQxNTYgNS42MDAxSDQuOTYxNTZDNS4zMTUwMiA1LjYwMDEgNS42MDE1NiA1LjMxMzU2IDUuNjAxNTYgNC45NjAxVjIuMjQwMUM1LjYwMTU2IDEuODg2NjQgNS4zMTUwMiAxLjYwMDEgNC45NjE1NiAxLjYwMDFaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00Ljk2MTU2IDEwLjM5OTlIMi4yNDE1NkMxLjg4ODEgMTAuMzk5OSAxLjYwMTU2IDEwLjY4NjQgMS42MDE1NiAxMS4wMzk5VjEzLjc1OTlDMS42MDE1NiAxNC4xMTM0IDEuODg4MSAxNC4zOTk5IDIuMjQxNTYgMTQuMzk5OUg0Ljk2MTU2QzUuMzE1MDIgMTQuMzk5OSA1LjYwMTU2IDE0LjExMzQgNS42MDE1NiAxMy43NTk5VjExLjAzOTlDNS42MDE1NiAxMC42ODY0IDUuMzE1MDIgMTAuMzk5OSA0Ljk2MTU2IDEwLjM5OTlaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik0xMy43NTg0IDEuNjAwMUgxMS4wMzg0QzEwLjY4NSAxLjYwMDEgMTAuMzk4NCAxLjg4NjY0IDEwLjM5ODQgMi4yNDAxVjQuOTYwMUMxMC4zOTg0IDUuMzEzNTYgMTAuNjg1IDUuNjAwMSAxMS4wMzg0IDUuNjAwMUgxMy43NTg0QzE0LjExMTkgNS42MDAxIDE0LjM5ODQgNS4zMTM1NiAxNC4zOTg0IDQuOTYwMVYyLjI0MDFDMTQuMzk4NCAxLjg4NjY0IDE0LjExMTkgMS42MDAxIDEzLjc1ODQgMS42MDAxWiIgZmlsbD0iI2ZmZiIvPgo8cGF0aCBkPSJNNCAxMkwxMiA0TDQgMTJaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00IDEyTDEyIDQiIHN0cm9rZT0iI2ZmZiIgc3Ryb2tlLXdpZHRoPSIxLjUiIHN0cm9rZS1saW5lY2FwPSJyb3VuZCIvPgo8L3N2Zz4K\u0026logoColor=ffffff)](https://zread.ai/microsphere-projects/microsphere-mybatis)\n[![Maven Build](https://github.com/microsphere-projects/microsphere-mybatis/actions/workflows/maven-build.yml/badge.svg)](https://github.com/microsphere-projects/microsphere-mybatis/actions/workflows/maven-build.yml)\n[![Codecov](https://codecov.io/gh/microsphere-projects/microsphere-mybatis/branch/main/graph/badge.svg)](https://app.codecov.io/gh/microsphere-projects/microsphere-mybatis)\n![Maven](https://img.shields.io/maven-central/v/io.github.microsphere-projects/microsphere-mybatis-dependencies.svg)\n![License](https://img.shields.io/github/license/microsphere-projects/microsphere-mybatis.svg)\n[![Average time to resolve an issue](http://isitmaintained.com/badge/resolution/microsphere-projects/microsphere-mybatis.svg)](http://isitmaintained.com/project/microsphere-projects/microsphere-mybatis \"Average time to resolve an issue\")\n[![Percentage of issues still open](http://isitmaintained.com/badge/open/microsphere-projects/microsphere-mybatis.svg)](http://isitmaintained.com/project/microsphere-projects/microsphere-mybatis \"Percentage of issues still open\")\n\nMicrosphere MyBatis is a lightweight extension framework for MyBatis that provides powerful SQL statement interception\ncapabilities. It enables developers to monitor, modify, or enhance SQL execution without changing your existing MyBatis\ncode base.\n\n## Purpose and Scope\n\nMicrosphere MyBatis is provides an extensible framework for enhancing MyBatis functionality through a sophisticated\ninterception pipeline. The framework enables developers to inject custom processing logic into MyBatis database\noperations without modifying existing application code, following the principle of separation of concerns:\n\n- Monitor SQL execution for logging, metrics, and observability\n- Apply cross-cutting concerns to SQL operations (security, throttling, caching)\n- Enhance SQL execution with additional capabilities\n- Integrate with other Microsphere projects like Sentinel, Resilience4j, and Observability\n\n## Modules\n\n| **Module**                           | **Purpose**                                       |\n|--------------------------------------|---------------------------------------------------|\n| **microsphere-mybatis-core**         | Core MyBatis framework                            |\n| **microsphere-mybatis-test**         | Base testing utilities and infrastructure         |\n| **microsphere-mybatis-spring**       | Spring Framework integration and configuration    |\n| **microsphere-mybatis-spring-test**  | Spring Testing integration                        |\n| **microsphere-mybatis-spring-boot**  | Spring Boot auto-configuration and properties     |\n| **microsphere-mybatis-spring-cloud** | Spring Cloud features integration                 |\n| **microsphere-mybatis-parent**       | Spring-specific testing utilities                 |\n| **microsphere-mybatis-dependencies** | Bill of Materials (BOM) for dependency management |\n\n## Getting Started\n\nThe easiest way to get started is by adding the Microsphere MyBatis BOM (Bill of Materials) to your project's\npom.xml:\n\n```xml\n\n\u003cdependencyManagement\u003e\n    \u003cdependencies\u003e\n        ...\n        \u003c!-- Microsphere MyBatis Dependencies --\u003e\n        \u003cdependency\u003e\n            \u003cgroupId\u003eio.github.microsphere-projects\u003c/groupId\u003e\n            \u003cartifactId\u003emicrosphere-mybatis-dependencies\u003c/artifactId\u003e\n            \u003cversion\u003e${microsphere-mybatis.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-mybatis.version}` has two branches:\n\n| **Branches** | **Purpose**                                      | **Latest Version** |\n|--------------|--------------------------------------------------|--------------------|\n| **0.2.x**    | Compatible with Spring Cloud 2022.0.x - 2025.0.x | 0.2.0              |\n| **0.1.x**    | Compatible with Spring Cloud Hoxton - 2021.0.x   | 0.1.0              |\n\nThen add the specific modules you need.\n\n### Maven Dependencies\n\n```xml\n\n\u003cdependencies\u003e\n    \u003c!-- Microsphere MyBatis Core --\u003e\n    \u003cdependency\u003e\n        \u003cgroupId\u003eio.github.microsphere-projects\u003c/groupId\u003e\n        \u003cartifactId\u003emicrosphere-mybatis-core\u003c/artifactId\u003e\n    \u003c/dependency\u003e\n\u003c/dependencies\u003e\n```\n\n### Gradle Dependencies\n\n```kotlin\nimplementation(platform(\"io.github.microsphere-projects:microsphere-mybatis-core:${microsphere.mybatis.version}\"))\n```\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-mybatis.git\n```\n\n2. Build the source:\n\n- Linux/MacOS:\n\n```bash\n./mvnw build\n```\n\n- Windows:\n\n```powershell\nmvnw.cmd build\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-mybatis/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-mybatis/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-mybatis)\n\n[ZRead Host](https://zread.ai/microsphere-projects/microsphere-mybatis)\n\n### Wiki\n\n[Github Host](https://github.com/microsphere-projects/microsphere-mybatis/wiki)\n\n### JavaDoc\n\n- [microsphere-mybatis-core](https://javadoc.io/doc/io.github.microsphere-projects/microsphere-mybatis-core)\n- [microsphere-mybatis-test](https://javadoc.io/doc/io.github.microsphere-projects/microsphere-mybatis-test)\n- [microsphere-mybatis-spring](https://javadoc.io/doc/io.github.microsphere-projects/microsphere-mybatis-spring)\n- [microsphere-mybatis-spring-test](https://javadoc.io/doc/io.github.microsphere-projects/microsphere-mybatis-spring-test)\n- [microsphere-mybatis-spring-boot](https://javadoc.io/doc/io.github.microsphere-projects/microsphere-mybatis-spring-boot)\n- [microsphere-mybatis-spring-cloud](https://javadoc.io/doc/io.github.microsphere-projects/microsphere-mybatis-spring-cloud)\n\n## License\n\nMicrosphere MyBatis is licensed under\nthe [Apache License, Version 2.0](http://www.apache.org/licenses/LICENSE-2.0).\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmicrosphere-projects%2Fmicrosphere-mybatis","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmicrosphere-projects%2Fmicrosphere-mybatis","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmicrosphere-projects%2Fmicrosphere-mybatis/lists"}