创建项目

提示

首先要搞清楚要创建的项目是怎样的一个体量，如果不是特别大的项目，就没必要上微服务，再有，如果不确定，也可以是先单体架构，这样前期好修改和维护，后面如果业务量上来了，模块更多了，再考虑升级微服务

使用模板创建项目

新建项目

说明：

1. 项目文件夹的名称
2. 项目存放的路径

注意

文件夹名尽量都使用英文

3. 如果是 2.7.x 就选择 jdk8，如果是 3.2.x+ 就选择 jdk17

4. 添加模板

   

   添加模板

   版本的信息

   1. GroupId: io.github.mangocrisp
      这个是固定的组

   2. ArtifactId: spring-taybct-single-archetype
      这个根据实际需求来，如果是单体架构就是 spring-taybct-single-archetype，如果是微服务就先 spring-taybct-cloud-archetype

   3. Version: 3.2.0-alpha.1
      版本号，目前只有两种版本号：以 3.2.* 开头的 3.2.x 版本，以及 2.7.* 开头的 2.7.x 版本，分别对应了 Spring Boot 3.2.x 和 2.7.x 版本

   填完点 Add

   提示

   或者选择 Catalog，选择 Maven Central,然后输入io.github.mangocrisp:spring-taybct-single-archetype，Version 选择3.2.0-alpha.1

   

   添加模板

5. 这里这个 GroupId,推荐是使用默认的 io.github.mangocrisp，如果使用其他的 GroupId，就需要修改一些依赖相关的代码

6. 项目名

7. 版本号

点击 Create，就能自动创建项目了

创建完成

如果 Maven 提示报错了，可以参考这个

汗，当时提交模板的时候忘了改版本号了，所以这里的 pom.xml 默认一开始是 ${project.version}，新建的项目怎么可能是3.2.0-alpha.1嘛，所以3.2.0-alpha.1版本的模板创建完成之后需要修改一下 pom.xml 文件，也只有 spring-taybct-single 的 3.2.0-alpha.1 和 2.7.0-alpha.1 版本有这样的问题，后面就没这样的问题了

此时需要点击重新加载 Maven 依赖

直接下载源码

Spring TayBct Single

Spring 业务组件基础集成的基础业务（单体架构），对一些常用的系统管理，用户体系等基础功能做了基础的常用的简易的集成，并且提供一些业务开发过程中常用的功能模块集成

GitHubGitLab

Spring TayBct Cloud

Spring 业务组件基础集成的基础业务（微服务架构），对一些常用的系统管理，用户体系等基础功能做了基础的常用的简易的集成，并且提供一些业务开发过程中常用的功能模块集成

GitHubGitLab

启动项目（Single）

1. 启动前先添加启动 JVM 参数（仅 JDK 17）

添加 JVM 参数

-Dmaven.wagon.http.ssl.insecure=true
-Dmaven.wagon.http.ssl.allowall=true
--add-opens
java.base/java.lang=ALL-UNNAMED
--add-opens
java.base/java.util=ALL-UNNAMED
--add-opens
java.base/java.nio=ALL-UNNAMED
--add-opens
java.base/sun.nio.ch=ALL-UNNAMED
--add-opens
java.base/java.lang.reflect=ALL-UNNAMED

点击 OK

2. 启动

启动成功 🎉🎉🎉

启动成功如上图

3. 验证

• swagger 后端接口文档：浏览器打开 http://127.0.0.1:9102/doc.html

• ApiFox 调试登录接口：

  curl --location --request POST 'http://localhost:9102/auth/oauth/login' \
  --header 'User-Agent: Apifox/1.0.0 (https://apifox.com)' \
  --header 'Authorization: Basic dGF5YmN0X3BjOmUxMGFkYzM5NDliYTU5YWJiZTU2ZTA1N2YyMGY4ODNl' \
  --data-urlencode 'grant_type=taybct' \
  --data-urlencode 'scope=all' \
  --data-urlencode 'username=root' \
  --data-urlencode 'password=0475e3dd4c5e90bc3854490e7354b6f10a47dd6e1220a0147e0ad42f4428f5a87828597146cbc3c2b8fd3458cda53e9daf21d3aa5c6da8ed31fd256cdf378e17ade31a708f31158c062214126f7fb863d31147038da24f2d59704fbb7783fc2c1b764efad79319'

  

  登录成功 🎉🎉🎉

启动项目（Cloud）

1. 启动前添加启动 JVM 参数（仅 JDK 17）

参考 Single

2. 启动

启动如下所选的服务

启动

提示

可以只启动服务 1 2 3，以最小化的服务启动

可以不用启动的服务：

• 分布式日志管理（如果添加了 Rabbit MQ 依赖，日志还是会被上传到 Rabbit MQ 上去，可以后面开启日志服务再消费）
• 任务调度管理（初始化项目的任务调度只做了记录任务调度日志，这个日志的记录方式同分布式日志）
• 文件管理（如果要使用的话再开起来）

启动成功 🎉🎉🎉

3. 验证

参考 Single

前端

配置前端项目来使用，目前可以使用的前端项目有：

• https://turtlewxg.github.io/gx-web-doc/