JeeSite 4.x

Spring Boot 最好的快速开发平台

JeeSite Cloud 分布式架构、微服务

引言

JeeSite Spring Cloud 具备 JeeSite 4.x 的所有功能,是在 JeeSite 4.x 基础之上,完成的 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 点击链接):http://jeesite.com/docs/feature/

技术选型

  • 分布式系统套件版本: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 版本的数据库与 JeeSite 单机版数据库相同,你可以 下载最新的mysql脚本 或者使用 init-data.bat(sh) 命令完成初始化(支持多种数据库)。

安装 Redis

Redis 是一个缓存数据库,主要用来集中式管理共享会话和系统缓存的,如果你已安装 Redis,可以忽略这个步骤。

由于 Windows 版本的 Redis 安装不太方便,所以我们提供了该版本的安装文件和安装脚本。

下载地址:https://gitee.com/thinkgem/jeesite4-cloud/attach_files 找到 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-eurekajeesite-cloud-config 了。

下载地址:https://gitee.com/thinkgem/jeesite4-cloud/attach_files 找到 nacos-server-1.2.1.zip 下载文件。

解压 nacos-server-1.2.1.zip 压缩包,运行 /bin/startup.cmd(sh) 启动服务。

启动完成后,访问:http://127.0.0.1:8848/nacos/index.html 用户名密码: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
  • 以上都启动成功后,浏览器访问网关项目地址即可:
    • 访问地址:http://127.0.0.1:8980/js 用户名密码: system admin
    • 若访问报错,请再等待一会,可能服务未完全启动完成

调用实例演示

网关代理模块调用

模块之间互相调用

  • test2 模块调用 test1 模块(单表):http://127.0.0.1:8980/js/a/test2/testData/list
    • 服务消费者位置:jeesite-cloud-module-test2/../web/TestData2Controller.java
    • 服务提供者位置:/jeesite-cloud-module-test1/../service/TestDataService.java
  • test1 模块调用 test2 模块(树表):http://127.0.0.1:8980/js/a/test1/testTree/list
    • 服务消费者位置:jeesite-cloud-module-test1/../web/TestTree1Controller.java
    • 服务提供者位置:/jeesite-cloud-module-test2/../service/TestTreeService.java

新增微服务方法

举例新增一个微服务模块模块叫 test3,该模块的所有映射地址均在 ${adminPath}/test3/** 这个路径下,该模块可以参照 test1 进行,步骤如下:

1、在 jeesite-cloud-gateway 配置文件中新增网关路由

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 配置文件的微服务列表中,新增微服务:

# 微服务列表
service:
  test3:
    name: jeesite-cloud-module-test3
    path: ${server.servlet.context-path}

3、拷贝 jeesite-cloud-module-test1 项目为 jeesite-cloud-module-test3 文件夹:

1)修改 pom.xml 中的应用名:

<artifactId>jeesite-cloud-module-test1</artifactId>
替换为:
<artifactId>jeesite-cloud-module-test3</artifactId>
<artifactId>jeesite-cloud-module-test1-client</artifactId>
替换为:
<artifactId>jeesite-cloud-module-test3-client</artifactId>

2)修改 application.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. 本项目仅用于学习和交流,未得到官方授权不得用于商业用途。

获得技术服务支持:http://s.jeesite.com

  • 我们深知,没有资金的支撑就很难得到发展,特别是一个好的产品,如果 JeeSite 帮助了您,请为我们点赞。支持我们,您可以得到一些回报,有了这些我们会把开源事业做的更好,回报社区和社会,请给我们一些动力吧,在此非常感谢已支持我们的朋友!

技术交流方式

JeeSite4微信公众号

Git 全局设置技巧

1、提交检出均不转换换行符

git config --global core.autocrlf false

2、拒绝提交包含混合换行符的文件

git config --global core.safecrlf true

关注 JeeSite 公众号,了解最新动态