# genesis **Repository Path**: mirrors_gspandy/genesis ## Basic Information - **Project Name**: genesis - **Description**: Spring cloud Example - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2020-09-24 - **Last Updated**: 2026-05-23 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README ## Genesis. Is a Spring Cloud Project ------ ## 技术架构 genesis 是一个基于Spring cloud(Camden.SR1) Spring Boot(1.4.1.RELEASE) Mybatis(3.3.0) 通用Mapper 通用分页Pagehelper完成的一个基础组件架构， 使用Spring Cloud Eureka、Feign、Zuul、Spring config、Zipkin、Sleuth、Hystrix Turbine、Hystrix Dashboard... ## MAVEN模块说明 #### 1. 基础组件说明 | 项目名称 | 端口 | 描述 | URL | | ---------------------------------------- | ---- | ---------------------- | --------------- | | genesis-common | 无 | 公共模块（工具类,资源......） | 无 | | genesis-core | 无 | 核心代码 | 无 | | genesis-model | 无 | 公共实体对象 | spar_generator | 无 | 生成mybatis mapper model实体 | spar_mapper | 无 | 抽离的mapper mapper.xml ------ #### 2. Spring Cloud(genesis-microservices)组件说明 | 项目名称 | 端口 | 描述 | URL | | ---------------------------------------- | ---- | ---------------------- | --------------- | | genesis-microservices-discovery | 8761 8762 8763 | 服务注册中心(用作和8762 8763实现高可用注册中心) | 无 | | genesis-microservices-config | 8040 | 服务配置中心服务 | 无 | | genesis-microservices-config-client | 8041 | 服务配置客户端测试启动访问(ip:port/message打印) | 无 | | genesis-microservices-gateway | 8050 | 服务网关 | 无 | | genesis-microservices-hystrix-dashboard | 8051 | 服务监控(Hystrix Dashboard) | 无 | | genesis-microservices-hystrix-turbine | 8052 | 服务监控(Hystrix Turbine) | 无 | | genesis-microservices-monitor | 8060 | 服务监控(spring boot admin) | 无 | | genesis-microservices-security | 无 | security | 无 | | genesis-microservices-sleuth | 8092 | 提供测试Zipkin 服务 提供本地、远程调用API | 无 | | genesis-microservices-zipkin | 8091 |Zipkin Server 对Spring Cloud应用进行服务追踪分析(主要和Sleuth) | 无 | | genesis-microservices-bus-kafka | 无 |bus-kafka | 无 | | genesis-microservices-bus-amqp | 无 |bus-amqp | 无 | ------ #### 3. Spring(genessis-spring)扩展组件说明 | 项目名称 | 端口 | 描述 | URL | | ---------------------------------------- | ---- | ---------------------- | --------------- | | genesis-spring-extends | 无 | Spring 扩展(更新中...) | 无 | | genesis-spring-plugins | 无 | Spring 插件(更新中...) | 无 | | genesis-spring-plugins-mybatis | 无 | Spring boot mybatis stater自定义(在genesis-provider-goods使用测试) | 无 | ------ #### 4. Examples(genesis-examples) 提供真是服务使用 | 项目名称 | 端口 | 描述 | URL | | ---------------------------------------- | ---- | ---------------------- | --------------- | | genesis-common-config | 无 | 通用配置 | 无 | | genesis-provider-by-feign | 8080 | API接口(使用Feign 负载均衡) | 无 | | genesis-provider-by-ribbon | 8084 | API接口(使用 Ribbon 负载均衡) | 无 | | genesis-provider-by-zuul | 8085 | API接口网关(使用Zuul) | 无 | | genesis-provider-goods | 8081 | Goods服务提供者(此服务使用了genesis-spring-plugins-mybatis stater) | 无 | | genesis-provider-goods2 | 8082 | Goods服务提供者(用于启动测试 API goods模块Feign Client负载均衡) | 无 | genesis-provider-order | 8083 | Order服务提供者 | 无 | | genesis-sleuth-zipkin-demo | 8093 | sleuth-zipkin-demo 接口 | 无 | ------ #### 5. 分布式事务Example(更新中....)(genesis-transaction-examples) 提供LCN分布式事务功能实现 | | 项目名称 | 端口 | 描述 | URL | | ---------------------------------------- | ---- | ---------------------- | --------------- | | tx-manager | 8010 | 事务管理 | 无 | | tx-user-ms | 8011 | 用户服务 | 无 | | tx-userMoney-ms | 1012 | 用户金钱管理服务 | 无 | ## 架构图(目前待完善) 后续会更新架构图出去，暂时先这样看着... 焦灼中.......... ![Markdown](http://p1.bqimg.com/1949/744b75531ed0a198.png) ## 服务中心HA说明 | 项目名称 | 端口 | 描述 | URL | | ---------------------------------------- | ---- | ---------------------- | --------------- | | genesis-microservices-discovery | 8761 8762 8763| 服务注册中心) | 无 | > * 1,（C:\Windows\System32\drivers\etc\hosts文件） ```java 127.0.0.1 discovery1 127.0.0.1 discovery2 127.0.0.1 discovery3 ``` > * 2,每个配置里面都有一个application.properties，本机为了方便在idea工具启动 所以使用了两个项目 > * 3,以后线上可以使用一个工程即可 如下： #### application-chengdu-1.properties ```java spring.application.name=eureka-server-clustered server.port=8761 eureka.instance.hostname=discovery1 eureka.client.serviceUrl.defaultZone=http://${security.user.name}:${security.user.password}@discovery2:8762/eureka/,http://${security.user.name}:${security.user.password}@discovery3:8763/eureka/ ``` #### application-chengdu-2.properties ```java spring.application.name=eureka-server-clustered server.port=8762 eureka.instance.hostname=discovery2 eureka.client.serviceUrl.defaultZone=http://${security.user.name}:${security.user.password}@discovery1:8761/eureka/,http://${security.user.name}:${security.user.password}@discovery3:8763/eureka/ ``` #### application-chengdu-3.properties ```java spring.application.name=eureka-server-clustered server.port=8763 eureka.instance.hostname=discovery3 eureka.client.serviceUrl.defaultZone=http://${security.user.name}:${security.user.password}@discovery1:8761/eureka/,http://${security.user.name}:${security.user.password}@discovery2:8762/eureka/ ``` ### 命令启动格式1： ```java java -jar discovery-1.0.0.jar --spring.profiles.active=chengdu-1 java -jar discovery-1.0.0.jar --spring.profiles.active=chengdu-2 java -jar discovery-1.0.0.jar --spring.profiles.active=chengdu-3 ``` 命令修改为： ```java java -jar discovery-1.0.0.jar ``` ### 效果图: ### [访问discovery1](http://discovery1:8761) ![discovery1](http://i4.buimg.com/1949/c1c8bed93bd1e784s.jpg) ## 监控视图测试 ### 使用说明： #### Spring boot Admin 监控 > * 数据库脚本 genesis-common-config resources/db/下面spring-cloud-test.sql > * 首先启动：genesis-microservices-monitor 端口 8060 > * 启动 genesis-provider-goods 端口 8081 访问 http://localhost:8060 admin UI 访问 http://localhost:8081/goods #### 效果图 ----- #### Hystrix-dashboard 监控 > * 数据库脚本 genesis-common-config resources/db/下面spring-cloud-test.sql > * 首先启动：genesis-microservices-discovery > * 启动genesis-microservices-hystrix-dashboard 端口 8051 > * 启动genesis-provider-by-feign 端口8080 访问 http://localhost:8051 在地址栏输入:http://localhost:8080/hystrix.stream #### 效果图 ![效果图](http://i4.buimg.com/1949/0b6e7467b99a1e00.jpg) ----- #### Hystrix Turbine 监控 > * 数据库脚本 genesis-common-config resources/db/下面spring-cloud-test.sql > * 首先启动：genesis-microservices-discovery > * genesis-provider-goods,genesis-provider-order > * genesis-provider-by-feign,genesis-provider-by-ribbon > * genesis-microservices-hystrix-dashboard 端口 8051 > * 启动genesis-microservices-hystrix-turbine 端口 8052 > * 分别启动 genesis-provider-goods 端口8081 、genesis-provider-order 端口 8083 访问http://localhost:8051 输入框输入：http://localhost:8052/turbine.stream 分别访问 feign ribbon #### 效果图1 ![效果图1](http://i4.buimg.com/1949/38ae38087f6ff6cd.jpg) 确认： #### 效果图2 ![效果图2](http://i4.buimg.com/1949/d4bc21c6f96033b3.jpg) ## 服务跟踪监控Zipkin、Sleuth 测试 ### 使用说明： #### 项目启动 > * 启动 Zipkin Server 服务 genesis-microservices-zipkin 端口 8091 > * 启动 Zipkin Server 服务demo genesis-microservices-sleuth 端口 8092 > * 启动测试 Zipkin、Sleuth 服务提供者 genesis-sleuth-zipkin-demo 端口 8093 > * 直接调用 8092 Controller接口即可 #### 跟踪列表效果图 ![跟踪列表](http://i2.bvimg.com/607995/f0d7b6f6dfcaca6d.jpg) #### 跟踪详细信息效果图 ![跟踪详细信息](http://i2.bvimg.com/607995/e99769c237cb33b6.jpg) ## Zuul 和 Feign 测试 ### 使用说明： #### 1,项目启动： > * 数据库脚本 genesis-common-config resources/db/下面spring-cloud-test.sql > * 首先启动：genesis-microservices-discovery > * 测试Fegin可以启动genesis-provider-by-feign。前提启动genesis-provider-good、genesis-provider-order > * 测试Zuul可以启动genesis-provider-by-zuul 。前提启动genesis-provider-good、genesis-provider-order > * genesis-provider-by-feign提供swgger UI 通过API文档Try 就可以了 ## API 文档访问测试 ### 使用说明： #### 1,项目启动： > * 启动API genesis-provider-by-feign访问http://localhost:8080/swagger-ui.html ![Markdown](http://i2.bvimg.com/607995/7d2dd1afb7ee0104.jpg) ## 分布式事务基于Spring Cloud + LCN ### LCN 首先感谢LCN提供 [LCN](https://github.com/1991wangliang/tx-lcn) ### 使用说明： #### 1,项目启动： > * 首先启动 tx-manager [tx-manager](http://localhost:8100/index) 效果图 ![manager](http://i1.bvimg.com/607995/10d7b69bf61f4e10.jpg) > * 启动 tx-user-ms 和 tx-user-money-ms #### 测试 > * 访问 http://localhost:8011/user/save Controller ```java @RequestMapping(value = "/save",method = RequestMethod.POST) public int save() { return userService.save(); } ``` Service ```java @TxTransaction @Transactional public int save() { User user = new User(); user.setUserName("Test Tx"); user.setPassword("11111"); int rs1 = userMapper.insert(user); /** * 保存 余额 分布式服务 */ int rs2 = userMoneyClient.save(); /** * 抛出异常 */ int v = 100 / 0; return rs1 + rs2; } ``` UserMoneyClient ```java @FeignClient(name = "genesis-tx-user-money-ms", configuration = TransactionRestTemplateConfiguration.class) public interface UserMoneyClient { @RequestMapping(value = "/user-money/save",method = RequestMethod.POST) int save(); } ```