加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
贡献代码
同步代码
取消
提示: 由于 Git 不支持空文件夾,创建文件夹后会生成空的 .keep 文件
Loading...
README
MIT

Make Java Great Again!

🧧🎖️🥇🏅🏆

modern Lightweight Test Meticulous coding Meticulous coding

MJGA 是一款基于以下理念设计的现代化 Java Web 脚手架。

容器化与云原生 🍋

  1. 通过 docker-compose.yml 管理应用程序的整个生命周期与配置。
  2. 通过 .env 文件自定义所有配置。
  3. 通过 docker-compose.yml 交付整个应用程序和配套的生态组件。

开箱即用 🍌

  1. 集成了常用的基础业务功能,如身份验证、权限管理和缓存抽象。
  2. Code Check&Format、CI/CD Plugin 、Docker Integration 全部开箱即用。
  3. 完善的、从设计出发的、隔离了运行环境的单元测试。

现代化 🍒

  1. 现代化:技术选型紧跟开源社区风向。
  2. 可配置化:支持在网页上选配组件。
  3. 考究的编码:每个变量和函数、每个模块和组件都考虑最佳实践。
  4. Not-all-in-one:现在和未来,MJGA 都将守好自己的边界。

技术选型 🥝

MIT License

技术栈 版本号
OpenJdk 17
SpringBoot 3.2.5 核心框架
SpringDoc 2.2.0 生成 OpenAPI 文档
TestContainers 1.19.7 为测试环境提供容器支持
Jooq 3.18.6 生成类型安全的 SQL 查询
Gradle 8.7 自动化构建工具
Pmd 6.55.0 静态代码分析工具
Spotless 6.25.0 代码格式化
... ... ...

快速开始 🍉

通过容器启动(推荐)

一、确认默认的环境变量配置。

# env will be applied to compose.yaml
less ${projectRoot}/.env

二、安装 Docker。

三、启动容器。

cd ${projectRoot}
docker-compose up -d

在本机启动(可选)

# confirm .env and make sure process can use it
nano/vim ${projectRoot}/.env
${projectRoot}/gradlew bootRun

创建数据库 Mapping Source

# confirm .env and make sure process can use it
nano/vim ${projectRoot}/.env
# generate schema mapping codes
./gradlew generateJooq
# output ->
# projectRootDir/build/generated-src
# └── jooq
#    └── tables # table mapping
#       ├── daos # Data Access Layer
#       ├── pojos # mapping dto
#       └── records # jooq query record

更多文档请点击...

测试覆盖率 🍓

cover

summary

🔗

portfolio

MIT License Copyright (c) 2023 Chuck Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

简介

现代化 Java Web 脚手架中的最佳实践 展开 收起
Java 等 2 种语言
MIT
取消

发行版 (1)

全部

贡献者

全部

近期动态

加载更多
不能加载更多了
马建仓 AI 助手
尝试更多
代码解读
代码找茬
代码优化