{"id":15294789,"url":"https://github.com/whaleal/mars","last_synced_at":"2025-07-02T08:08:13.969Z","repository":{"id":37099241,"uuid":"379461897","full_name":"whaleal/mars","owner":"whaleal","description":"Mars   -  Java Object Document Mapper for MongoDB  (MongoDB ODM Framework )","archived":false,"fork":false,"pushed_at":"2024-09-27T09:03:47.000Z","size":11303,"stargazers_count":34,"open_issues_count":21,"forks_count":4,"subscribers_count":0,"default_branch":"v1-dev","last_synced_at":"2025-04-07T15:23:38.363Z","etag":null,"topics":["codec","java","javaorm","mars","mongodb","odm","orm","orm-framework","springboot","whaleal"],"latest_commit_sha":null,"homepage":"https://docs.whaleal.com/mars/","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/whaleal.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","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":"2021-06-23T02:57:29.000Z","updated_at":"2025-03-19T08:42:47.000Z","dependencies_parsed_at":"2023-12-13T08:53:51.603Z","dependency_job_id":"6edadb1a-2e20-476b-83bf-871c8f9dd3db","html_url":"https://github.com/whaleal/mars","commit_stats":{"total_commits":443,"total_committers":8,"mean_commits":55.375,"dds":"0.42212189616252827","last_synced_commit":"a1795f4b311c988ceb684ba8dec64b22af206024"},"previous_names":[],"tags_count":97,"template":false,"template_full_name":null,"purl":"pkg:github/whaleal/mars","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whaleal%2Fmars","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whaleal%2Fmars/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whaleal%2Fmars/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whaleal%2Fmars/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/whaleal","download_url":"https://codeload.github.com/whaleal/mars/tar.gz/refs/heads/v1-dev","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whaleal%2Fmars/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263099467,"owners_count":23413622,"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":["codec","java","javaorm","mars","mongodb","odm","orm","orm-framework","springboot","whaleal"],"created_at":"2024-09-30T17:06:58.619Z","updated_at":"2025-07-02T08:08:13.944Z","avatar_url":"https://github.com/whaleal.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003ch1\u003eMars\u003c/h1\u003e\n  \u003cp\u003eMongoDB ORM/ODM for Java.\u003c/p\u003e\n\u003c/div\u003e\n\n\n\n##  致自己 \n造自己的轮子，让别人去说 \n\n\n\u003cp align=\"center\"\u003e\n\t\u003ca href=\"https://whaleal.com/\"\u003e\u003cimg src=\"https://docs.whaleal.com/images/logo1.png\" width=\"45%\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n\t\u003ca href=\"https://whaleal.com/\"\u003e\u003cimg src=\"https://docs.whaleal.com/images/logo1.png\" width=\"45%\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n\t\u003cstrong\u003eMars - Object Relational Mapping Framework for NoSql (ORM)\u003c/strong\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n\t\u003cstrong\u003eMars - Object Document Mapping Framework for NoSql (ODM)\u003c/strong\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n\t👉 \u003ca href=\"https://whaleal.com\"\u003ehttps://whaleal.com/\u003c/a\u003e 👈\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n\t\u003ca target=\"_blank\" href=\"https://search.maven.org/artifact/com.whaleal.mars/mars-all\"\u003e\n\t\t\u003cimg src=\"https://img.shields.io/maven-central/v/com.whaleal.mars/mars-core.svg?label=Maven%20Central\" /\u003e\n\t\u003c/a\u003e\n\t\u003ca target=\"_blank\" href=\"https://www.oracle.com/java/technologies/javase/javase-jdk8-downloads.html\"\u003e\n\t\t\u003cimg src=\"https://img.shields.io/badge/JDK-8+-green.svg\" /\u003e\n\t\u003c/a\u003e\n\t\u003ca target=\"_blank\" href='https://github.com/whaleal/mars'\u003e\n\t\t\u003cimg src=\"https://img.shields.io/github/stars/whaleal/mars.svg?style=social\" alt=\"github star\"/\u003e\n\t\u003c/a\u003e\n\u003c/p\u003e\n\n\n\n-------------------------------------------------------------------------------\n\n[**🌎English Documentation**](README-EN.md)\n\n-------------------------------------------------------------------------------\n\n## 📚简介\nmars是一款 关系映射框架和我们经常接触的JPA ,反射技术息息相关，本项目主要针对非关系型数据库，NoSql 大类。其相关性能已经超越 spring-data ，可以完全取代。\n\nmars与spring具有兼容性。本身亦可单独使用。  \n\nmars 目标是兼容大多数的非关系型数据库，使用一套的标准查询方式 ，即可查询多种数据库。减少使用上的学习成本。让开发者有更多的精力创造业务上的价值。\n\n### 🎁mars名称的由来\n\nmars 是 [上海锦木信息技术有限公司](https://www.jinmuinfo.com/) 与 [中国东方航空公司](https://www.ceair.com/) 合作研发的一款ODM/ORM框架  \n纪念中国火星探测任务“天问一号”的火星车祝融号成功登陆火星的乌托邦平原【2021年5月15日】,故起名为 mars。\n\n### 🍺mars如何改变我们的coding方式\n\nmars的目标是使得非关系型数据库使用一套标准的方式，即可简单的实现业务逻辑，减少开发者的学习使用成本,彻底改变我们写代码的方式。\n\nmars的存在就是为了减少框架的学习成本，避免网络上参差不齐的代码出现导致的bug,同时避免重复造轮子。\n\n使用一套标准 兼容多种Nosql 。\n\n-------------------------------------------------------------------------------\n\n## 🛠️包含组件\n一个MongoDB java  ORM/ODM 框架，同时提供以下组件：\n\n| 模块                |     介绍                                                                          |\n| -------------------|---------------------------------------------------------------------------------- |\n| mars-core          |     核心包                                    |\n| mars-springboot    |     基于springboot 自动注入的插件                                                    |\n\n可以根据需求对每个模块单独引入，也可以通过引入`mars-core`方式引入所有模块。\n\n-------------------------------------------------------------------------------\n\n## 📝文档 \n\n* [See the usage docs](https://github.com/whaleal/mars/wiki)\n* [Download Latest](https://github.com/whaleal/mars/releases)\n\n\n-------------------------------------------------------------------------------\n\n## 📦安装\n\n### 🍊Maven\n在项目的pom.xml的dependencies中加入以下内容:\n\n```xml\n\u003cdependency\u003e\n    \u003cgroupId\u003ecom.whaleal.mars\u003c/groupId\u003e\n    \u003cartifactId\u003emars-core\u003c/artifactId\u003e\n    \u003cversion\u003ex.x.x\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\n### 🍐Gradle\n```\nimplementation 'com.whaleal.mars:mars-core:x.x.x'\n```\n\n### 📥下载jar\n\n点击以下链接，下载`mars-core-X.X.X.jar`即可：\n\n- [Maven中央库](https://repo1.maven.org/maven2/com/whaleal/mars/mars-core/)\n\n\u003e 🔔️注意\n\u003e 所有版本编译起始均为JDK8+\n\n### 🚽编译安装\n\n访问mars的github主页：[https://github.com/whaleal/mars](https://github.com/whaleal/mars) 下载整个项目源码（v1-main或v1-dev分支都可）然后进入mars项目目录执行：\n\n```sh\nmvn install \n```\n\n然后就可以使用Maven引入了。\n\n-------------------------------------------------------------------------------\n\n## 🏗️添砖加瓦\n\n### 🎋分支说明\n\nmars的源码分为两个分支，功能如下：\n\n| 分支       | 作用                                                          |\n|-----------|---------------------------------------------------------------|\n| main  | 主分支，release版本使用的分支，与中央库提交的jar一致，不接收任何pr或修改 |\n| v1-main | 大版本主分支，不同大版本具有不同vxx-main, 用于合并v1-dev,观察特性,不接收任何pr或修改 |\n| v1-dev    | 开发分支，默认为下个版本的SNAPSHOT版本，接受修改或pr                 |\n\n### 🐞提供bug反馈或建议\n\n提交问题反馈请说明正在使用的JDK版本呢、mars版本和相关依赖库版本。\n\n- [github issue](https://github.com/whaleal/mars/issues)\n\n\n### 🧬贡献代码的步骤及PR遵照的原则\n\n详见wiki  [How2Contribute](https://github.com/whaleal/mars/wiki/Mars-00How2Contribute)\n\n\n\n## ⭐欢迎关注\n\n如果你觉得本项目还不错，欢迎持续关注，在此表示感谢^_^。\n\n\n![whaleal](https://github.com/whaleal/whaleal.github.io/blob/main/images/logo1.png)\n\n## 其他相关项目 \n[Project](https://docs.whaleal.com/project)\n\n## 社区支持\n本项目由 [whaleal社区](https://www.whaleal.com/)提供支持  \n\n\n\n## What is Mars\n\n Mars is a unified driver platform product  developed by Shanghai Jinmu Information Technology Co., Ltd., which is based on Mongodb's driver layer framework and developed with Java language. It makes further innovation on the basis of the original driver function, making the operation more convenient and fast.\n \nIt uses similar query method as spring, and has higher performance than spring. In the preliminary comparative test, it is improved more than 25% than spring.\n\n\n\n\n## LICENSE\n\nMars is free and the source is available. All versions released after  2020, including patch fixes for prior versions, are published under the [Server Side Public License (SSPL) v1](LICENSE.md). See individual files for details.\n\n## supporter\n\u003cimg src=\"https://www.jinmuinfo.com/community/MongoDB/docs/images/logo/jinmu.png\" width=\"310px\" alt=\"Jinmu Logo\"\u003e\n\nIf you have any problems or suggestions, welcome to contact us!  \n \nHotline：021-58870038 / 021-66696778  \nEmail：support@jinmuinfo.com  \nOffice address: building 10, 1228 Jiangchang Rd, Jiangan District, Shanghai, P.R.C  \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwhaleal%2Fmars","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwhaleal%2Fmars","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwhaleal%2Fmars/lists"}