# JeeSite4 Spring Cloud
**Repository Path**: sysadm/jeesite4-cloud
## Basic Information
- **Project Name**: JeeSite4 Spring Cloud
- **Description**: ThinkGem 出品必属精品 JeeSite Spring Cloud 是基于 Spring Cloud 的一个分布式系统套件的整合。特点：用经典开发模式，开发分布式应用，两个字【简单】，一个字【快】。具备 JeeSite4 单机版的所有功能，统一身份认证，统一基础数据管理，弱化微服务开发难度
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: http://jeesite.com
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 905
- **Created**: 2020-05-23
- **Last Updated**: 2024-06-07
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
## 引言
[JeeSite Spring Cloud](https://gitee.com/thinkgem/jeesite4-cloud) 具备 [JeeSite 4.x](https://gitee.com/thinkgem/jeesite4) 的所有功能，是在 JeeSite 4.x 基础之上，完成的 [Spring Cloud](https://spring.io/projects/spring-cloud) 分布式系统套件的整合。它利用 JeeSite 4.x 的开发便利性巧妙地简化了分布式系统开发。
JeeSite Spring Cloud 并没有重复制造轮子，它只是将目前比较成熟的、经得起实际考验的服务框架组合起来，通过 Spring Boot 风格进行再封装屏蔽掉了复杂的配置和实现原理，最终给开发者留出了一套简单易懂、易部署和易维护的分布式系统开发工具包。
**特点：用经典开发模式，开发分布式应用，两个字【简单】，一个字【快】。**
## 优势（只写别人没有的）
1. 在 JeeSite 单应用基础之上，完成的 Cloud 功能，使用经典开发模式，就像开发单应用一样开发分布式应用
2. 它提供了微服务模块的代码生成工具，快速生成开发微服务功能，包含微服务的发布和调用接口
3. 我们将 api 和 client 合体为一个工程，自动适应自己调用自己 client 的影响，简化工程数量
4. 如一些通用操作（增删改查）的微服务接口和调用基类实现，这些都不用自己写了，简化代码书写
5. 统一的授权认证、基础数据微服务，都已经提供查询 client 接口，其他微服务应用模块中可直接获取用户、组织、权限、字典等基础数据。微服务之间调用中，出现的会话及缓存的一致性统一得到解决。
6. 如 UserUtils、EmpUtils、EmpUserService、OfficeService 等等众多的基础服务工具类，都可以直接从基础数据的微服务中获取数据，你不必考虑跨 web 服务的数据交互，我们已经帮你做了。
7. 写一个别人有的，使用柔性事务解决，跨 web 服务的情况，入侵性非常小哦。
8. 其它优势（按 Ctrl + Shift 点击链接）：
## 技术选型
* 分布式系统套件版本：Spring Cloud Finchley
* 服务治理注册与发现：Spring Cloud Eureka / Consul / Nacos
* 分布式统一配置中心：Spring Cloud Config / Nacos
* 服务容错保护限流降级：Spring Cloud Hystrix
* 网关路由代理调用：Spring Cloud Gateway
* 声明式服务调用：Spring Cloud OpenFeign
* 分布式链路追踪：Spring Cloud Zipkin (可选组件)
* 分布式事务框架：Codingapi TX-LCN (可选组件)
* 工作流引擎框架：Flowable (可选组件)
## 子项目介绍
* 服务注册：jeesite-cloud-eureka ：
* 配置中心：jeesite-cloud-config ：
* 服务注册和配置中心 **Nacos** 版本 ：
* 网关路由：jeesite-cloud-gateway ：
* 分布式事务管理服务：jeesite-cloud-module-txlcn ：
* 核心模块（**统一授权认证**）：jeesite-cloud-module-core ：
* 测试模块1（单表增删改查示例）：
- 模块1主项目：jeesite-cloud-module-test1 ：
- 模块1客户端项目（提供其它模块调用）：jeesite-cloud-module-test1-client
* 测试模块2（树表增删改查示例）：
- 模块2主项目：jeesite-cloud-module-test2 ：
- 模块2客户端项目（提供其它模块调用）：jeesite-cloud-module-test2-client
* 链路追踪：jeesite-cloud-zipkin ：
## 快速运行
### 初始化数据库
JeeSite Cloud 版本的数据库与 JeeSite 单机版数据库相同，你可以 [下载最新的mysql脚本](https://gitee.com/thinkgem/jeesite4/attach_files)
或者使用 [init-data.bat(sh)](http://jeesite.com/docs/install-deploy/#初始化数据库) 命令完成初始化（支持多种数据库）。
### 安装 Redis
Redis 是一个缓存数据库，主要用来集中式管理共享会话和系统缓存的，如果你已安装 Redis，可以忽略这个步骤。
由于 Windows 版本的 Redis 安装不太方便，所以我们提供了该版本的安装文件和安装脚本。
下载地址： 找到 `Redis-x64-4.0.2.2.zip` 下载文件。
解压 `Redis-x64-4.0.2.2.zip` 压缩包，运行 `service-install.bat` 安装 Windows 系统服务。
默认地址：127.0.0.1；默认端口：6379；默认密码：1234，可根据自己需要修改 conf 文件。
### 部署 Nacos 服务
Nacos 包含 服务注册 和 配置中心，如果使用 Nacos 就不用部署 `jeesite-cloud-eureka` 和 `jeesite-cloud-config` 了。
下载地址： 找到 `nacos-server-1.2.1.zip` 下载文件。
解压 `nacos-server-1.2.1.zip` 压缩包，运行 `/bin/startup.cmd(sh)` 启动服务。
启动完成后，访问： 用户名密码：nacos
登录后，进入菜单 `配置管理 -> 配置列表` 点击 `导入配置` 按钮，选择 `/config/src/main/resources/cloud-config/nacos_config_export.zip` 上传文件。
然后编辑 Data Id 为 `application.yml` 的文件里的 JDBC 和 Redis 信息。
### 启动微服务项目
* 在每个微服务中可以找的 `config/bootstrap.yml` 配置服务注册和配置中心地址。
* 按顺序运行以下启动类的main方法：（因为服务直接有依赖，请启动完成一个再启下一个）
- /jeesite-cloud-gateway/../GatewayApplication.java
- /jeesite-cloud-module-core/../CoreApplication.java
- /jeesite-cloud-module-test1/../Test1Application.java
- /jeesite-cloud-module-test2/../Test2Application.java
* 以上都启动成功后，浏览器访问网关项目地址即可：
- 访问地址： 用户名密码： system admin
- 若访问报错，请再等待一会，可能服务未完全启动完成
## 调用实例演示
### 网关代理模块调用
* 代理 test1 模块（单表）：
- 控制器位置：jeesite-cloud-module-test1/../web/TestData1Controller.java
* 代理 test2 模块（树表）：
- 控制器位置：jeesite-cloud-module-test2/../web/TestTree2Controller.java
### 模块之间互相调用
* test2 模块调用 test1 模块（单表）：
- 服务消费者位置：jeesite-cloud-module-test2/../web/TestData2Controller.java
- 服务提供者位置：/jeesite-cloud-module-test1/../service/TestDataService.java
* test1 模块调用 test2 模块（树表）：
- 服务消费者位置：jeesite-cloud-module-test1/../web/TestTree1Controller.java
- 服务提供者位置：/jeesite-cloud-module-test2/../service/TestTreeService.java
## 新增微服务方法
举例新增一个微服务模块模块叫 `test3`，该模块的所有映射地址均在 `${adminPath}/test3/**` 这个路径下，该模块可以参照 `test1` 进行，步骤如下：
1、在 jeesite-cloud-gateway 配置文件中新增网关路由
```yml
spring:
cloud:
gateway:
routes:
# 测试模块3
- id: test3
uri: lb://jeesite-cloud-module-test3/js/a/test3
predicates:
- Path=/js/a/test3/**
# 基础权限模块
- id: core
uri: lb://jeesite-cloud-module-core/js
predicates:
- Path=/js/**
```
注意：新增的配置请放到 core 基础权限模块之上。
2、在 jeesite-cloud-config 配置文件的微服务列表中，新增微服务：
```yml
# 微服务列表
service:
test3:
name: jeesite-cloud-module-test3
path: ${server.servlet.context-path}
```
3、拷贝 jeesite-cloud-module-test1 项目为 jeesite-cloud-module-test3 文件夹：
1）修改 pom.xml 中的应用名：
```xml
jeesite-cloud-module-test1
替换为：
jeesite-cloud-module-test3
```
```xml
jeesite-cloud-module-test1-client
替换为：
jeesite-cloud-module-test3-client
```
2）修改 application.yml 中的应用名：
```yml
spring:
application:
name: jeesite-cloud-module-test3
```
3）修改 *Client.java 里的应用名：
```
service.test1 替换为 service.test3
```
4）修改 *Controller.java 里的映射路径：
```
${adminPath}/test1 替换为 ${adminPath}/test3
```
## 授权协议声明
1. 您可以免费使用、修改和衍生代码，但不允许修改后和衍生的代码做为闭源软件发布。
2. 修改后和衍生的代码必须也按照当前协议进行流通，对修改后和衍生的代码必须向社会公开。
3. 如果您修改了代码，需要在被修改的文件中进行说明，并遵守代码格式规范，帮助他人更好的理解您的用意。
4. 在延伸的代码中（修改和有源代码衍生的代码中）需要带有原来代码中的协议、版权声明和其他原作者规定
需要包含的说明（请尊重原作者的著作权，不要删除或修改文件中的`@author`信息）。
5. 本项目仅用于学习和交流，未得到官方授权不得用于商业用途。
### 获得技术服务支持：
* 我们深知，没有资金的支撑就很难得到发展，特别是一个好的产品，如果 JeeSite 帮助了您，请为我们点赞。支持我们，您可以得到一些回报，有了这些我们会把开源事业做的更好，回报社区和社会，请给我们一些动力吧，在此非常感谢已支持我们的朋友！
# 技术交流方式
* QQ 群号：`127515876`、`209330483`、`223507718`、`709534275`、`730390092`、`183903863(外包)`
* 问题反馈： [【新手必读】](http://www.dianbo.org/9238/stone/tiwendezhihui.htm)
* 码云Gitee：
* GitHub：
* 作者博客：
* 官方网站：
* 官方论坛：
* 微信公众号：
# Git 全局设置技巧
```
1、提交检出均不转换换行符
git config --global core.autocrlf false
2、拒绝提交包含混合换行符的文件
git config --global core.safecrlf true
```