ContiNew Starter（Continue New Starter）基于“约定优于配置”的理念，再次精简常规配置，提供一个更为完整的配置解决方案，帮助开发人员更加快速的集成常用第三方库或工具到 Spring Boot Web 应用程序中。
ContiNew Starter 包含了一系列经过企业实践优化的依赖包（如 MyBatis-Plus、SaToken），可轻松集成到应用中，为开发人员减少手动引入依赖及配置的麻烦，为 Spring Boot Web 项目的灵活快速构建提供支持。
ContiNew Starter 源自 ContiNew Admin 中后台管理框架/脚手架项目。在 ContiNew Admin 发展到一定程度时，作者发现新手用户上手时需要关注过多的脚手架通用基础能力，而且如果想要在一个全新项目中使用这些基础能力，“迁移”起来也很麻烦。于是，ContiNew Starter 应运而生，作者在 ContiNew Admin 2.x 版本时，将项目中的通用基础能力进行了抽离和深度优化。这样，无论是在 ContiNew Admin 中使用，还是单独使用这些基础能力，都可以更加轻松。
在开发一个 Java Web 项目之前，我们可能需要做如下准备工作：
- 引入 Spring Boot 父项目进行版本锁定（无 Spring 不 Java）
- 引入 Spring Boot Web 依赖
- 根据自身需要引入不同组件的 Starter
- 根据自身需要对引入的 Starter 进行配置（查阅文档或通过搜索引擎查找常用配置）
- 编写 Java 配置
- 编写 application.yml 配置
- 编写各种全局处理器
- 开始使用
在 Spring Boot “约定优于配置” 理念的帮助下，我们开发一个 Spring Java Web 程序已经简化到了不可思议的程度，而且很多设计良好的组件 Starter 提供了极大的扩展性，提供了非常多的配置，给使用者最大的可行性，当你需要处理一些自定义场景时，这些配置简直是太过方便。
然而，极大的扩展性带来的另一面就是配置“混乱”，对于小白用户，初步使用某个组件时，仅配置就足够“吃一壶”。因此，各种脚手架项目应运而生，你可能会想，这基础配置关脚手架项目什么事？脚手架项目的作用不仅仅是提供一系列通用基础功能，更多的是提供了一种通用的解决方案，无论是针对所使用组件的配置，还是实现的某个功能的设计，亦或是开发规范 。即使是一个小白，把脚手架项目拿过来，只需要删减下不需要的功能，改动下品牌元素，就可以继续在其基础上进行开发一个成熟的项目。
ContiNew Starter 就是将脚手架项目中的通用基础配置进行了封装及深度优化，从企业通用实践层面精简配置，让一个完全从头开始或已有的项目，在使用部分组件时变得更轻松。
| 开源平台 | 源码地址 |
|---|---|
| Gitee（码云） | https://gitee.com/continew/continew-starter |
| GitCode | https://gitcode.com/continew/continew-starter |
| GitHub | https://github.com/continew-org/continew-starter |
1.在项目 pom.xml 中锁定版本（下方两种方式请任选其一）
第一种方式：如您使用的是 Spring Boot Parent 的方式，则替换 Spring Boot Parent 为 ContiNew Starter
最新稳定版（latest-version）
<parent>
<groupId>top.continew</groupId>
<artifactId>continew-starter</artifactId>
<version>{latest-version}</version>
</parent>第二种方式：如您使用的是引入 Spring Boot Dependencies 的方式，则替换 Spring Boot Dependencies 为 ContiNew Starter Dependencies
<properties>
<java.version>17</java.version>
<maven.compiler.source>${java.version}</maven.compiler.source>
<maven.compiler.target>${java.version}</maven.compiler.target>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>
<dependencyManagement>
<dependencies>
<!-- ContiNew Starter Dependencies -->
<dependency>
<groupId>top.continew</groupId>
<artifactId>continew-starter-dependencies</artifactId>
<version>{latest-version}</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>2.在项目 pom.xml 中引入所需模块依赖
<dependencies>
<!-- Web 模块 -->
<dependency>
<groupId>top.continew</groupId>
<artifactId>continew-starter-web</artifactId>
</dependency>
</dependencies>3.在 application.yml 中根据引入模块，添加所需配置
e.g. 跨域配置
--- ### 跨域配置
continew-starter.web:
cors:
enabled: true
# 配置允许跨域的域名
allowed-origins: '*'
# 配置允许跨域的请求方式
allowed-methods: '*'
# 配置允许跨域的请求头
allowed-headers: '*'
# 配置允许跨域的响应头
exposed-headers: '*'continew-starter
├─ continew-starter-core（核心模块：包含线程池等自动配置）
├─ continew-starter-json（JSON 模块）
│ └─ continew-starter-json-jackson
├─ continew-starter-api-doc（接口文档模块：Spring Doc + Knife4j）
├─ continew-starter-web（Web 开发模块：包含跨域、全局异常+响应、链路追踪等自动配置）
├─ continew-starter-auth（认证模块）
│ ├─ continew-starter-auth-satoken（国产轻量认证鉴权）
│ └─ continew-starter-auth-justauth（第三方登录）
├─ continew-starter-data（数据访问模块）
│ ├─ continew-starter-data-core（通用模块）
│ ├─ continew-starter-data-mp（MyBatis Plus）
│ └─ continew-starter-data-mf（MyBatis Flex）
├─ continew-starter-cache（缓存模块）
│ ├─ continew-starter-cache-redisson（Redisson）
│ ├─ continew-starter-cache-jetcache（JetCache 多级缓存）
│ └─ continew-starter-cache-springcache（Spring 缓存）
├─ continew-starter-security（安全模块）
│ ├─ continew-starter-security-crypto（加密：字段加解密）
│ ├─ continew-starter-security-mask（脱敏：JSON 数据脱敏）
│ ├─ continew-starter-security-limiter（限流）
│ └─ continew-starter-security-password（密码编码器）
├─ continew-starter-captcha（验证码模块）
│ ├─ continew-starter-captcha-graphic（静态验证码）
│ └─ continew-starter-captcha-behavior（动态验证码）
├─ continew-starter-messaging（消息模块）
│ ├─ continew-starter-messaging-mail（邮件）
│ └─ continew-starter-messaging-websocket（WebSocket）
├─ continew-starter-log（日志模块）
│ ├─ continew-starter-log-core（通用模块）
│ └─ continew-starter-log-interceptor（拦截器版（Spring Boot Actuator HttpTrace 增强版））
├─ continew-starter-file（文件处理模块）
│ └─ continew-starter-file-excel（Easy Excel）
├─ continew-starter-storage（存储模块）
│ └─ continew-starter-storage-local（本地存储）
└─ continew-starter-extension（扩展模块）
├─ continew-starter-extension-datapermission（数据权限模块）
│ ├─ continew-starter-extension-datapermission-core（通用模块）
│ └─ continew-starter-extension-datapermission-mp（MyBatis Plus）
├─ continew-starter-extension-tenant（多租户模块）
│ ├─ continew-starter-extension-tenant-core（通用模块）
│ └─ continew-starter-extension-tenant-mp（MyBatis Plus）
└─ continew-starter-extension-crud（CRUD 模块）
├─ continew-starter-extension-crud-core（通用模块）
├─ continew-starter-extension-crud-mp（MyBatis Plus）
└─ continew-starter-extension-crud-mf（MyBatis Flex）
ContiNew Starter 的分支目前分为下个大版本的开发分支和上个大版本的维护分支，PR 前请注意对应分支是否处于维护状态。
| 分支 | 说明 |
|---|---|
| dev | 开发分支，默认为下个大版本的 SNAPSHOT 版本，接受新功能或新功能优化 PR |
| x.x.x | 维护分支，在 vx.x.x 版本维护期终止前（一般为下个大版本发布前），用于修复上个版本的 Bug，只接受已有功能修复，不接受新功能 PR |
如果您想提交新功能或优化现有代码，可以按照以下步骤操作：
- 首先，在 Gitee 或 Github 上将项目 fork 到您自己的仓库
- 然后，将 fork 过来的项目（即您的项目）克隆到本地
- 切换到当前仍在维护的分支（请务必充分了解分支使用说明，可进群联系维护者确认）
- 开始修改代码，修改完成后，将代码 commit 并 push 到您的远程仓库
- 在 Gitee 或 Github 上新建 pull request（pr），选择好源和目标，按模板要求填写说明信息后提交即可（多多参考 已批准合并的 pr 记录，会大大增加批准合并率）
- 最后，耐心等待维护者合并您的请求即可
请记住，如果您有任何疑问或需要帮助，我们将随时提供支持。
Important
欢迎大家为 ContiNew Starter 贡献代码，我们非常感谢您的支持！为了更好地管理项目，维护者有一些要求：
- 请确保代码、配置文件的结构和命名规范良好，完善的代码注释，并遵循阿里巴巴的 《Java开发手册(黄山版)》 中的代码规范，保证代码质量和可维护性
- 在提交代码前，请按照 Angular 提交规范 编写 commit 的 message（建议在 IntelliJ IDEA 中下载并安装 Git Commit Template 插件，以便按照规范进行 commit）
- 提交代码之前，请关闭所有代码窗口，执行
mvn compile命令（代码格式化插件会在项目编译时对全局代码进行格式修正），编译通过后，不要再打开查看任何代码窗口，直接提交即可
💬 欢迎各位小伙伴儿扫描下方二维码加好友，备注 cnadmin，拉你进群，探讨技术、提提需求~
加入交流群后，你将会：
- 第一时间收到框架动态
- 第一时间收到框架更新通知
- 第一时间收到框架 Bug 通知
- 和众多大佬互相 (huá shuǐ) 交流 (mō yú)
无加群意愿
💬 如无加群意愿，欢迎在 Issues 中反馈交流~ 🍻感谢参与贡献的每一位小伙伴🥰
- 感谢 JetBrains 提供的 非商业开源软件开发授权
- 感谢 MyBatis Plus、Sa-Token 、JetCache、Crane4j、Knife4j、Hutool 等开源组件作者为国内开源世界作出的贡献
- 感谢 ELADMIN、RuoYi-Vue-Plus、Dante-Engine，致敬各位作者为开源脚手架领域作出的贡献
- e.g. 起源于 ELADMIN 项目开源的 QueryHelper 组件
- e.g. 扩展于 Dante-Engine 项目封装的 Redisson 相关配置
- 感谢项目使用或未使用到的每一款开源组件，致敬各位开源先驱 🔥
