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	用户金钱管理服务	无

架构图(目前待完善)

后续会更新架构图出去，暂时先这样看着... 焦灼中..........

服务中心HA说明

项目名称	端口	描述	URL
genesis-microservices-discovery	8761 8762 8763	服务注册中心)	无

• 1,（C:\Windows\System32\drivers\etc\hosts文件）

127.0.0.1 discovery1
127.0.0.1 discovery2
127.0.0.1 discovery3

• 2,每个配置里面都有一个application.properties，本机为了方便在idea工具启动 所以使用了两个项目

• 3,以后线上可以使用一个工程即可 如下：

application-chengdu-1.properties

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

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

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 -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 -jar discovery-1.0.0.jar

效果图:

访问discovery1

监控视图测试

使用说明：

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

效果图

---

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

确认：

效果图2

服务跟踪监控Zipkin、Sleuth 测试

使用说明：

项目启动

• 启动 Zipkin Server 服务 genesis-microservices-zipkin 端口 8091
• 启动 Zipkin Server 服务demo genesis-microservices-sleuth 端口 8092
• 启动测试 Zipkin、Sleuth 服务提供者 genesis-sleuth-zipkin-demo 端口 8093
• 直接调用 8092 Controller接口即可

跟踪列表效果图

跟踪详细信息效果图

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

分布式事务基于Spring Cloud + LCN

LCN

首先感谢LCN提供

LCN

使用说明：

1,项目启动：

• 首先启动 tx-manager tx-manager

效果图

• 启动 tx-user-ms 和 tx-user-money-ms

测试

• 访问 http://localhost:8011/user/save

Controller

@RequestMapping(value = "/save",method = RequestMethod.POST)
    public int save() {
        return userService.save();
    }

Service

    @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

@FeignClient(name = "genesis-tx-user-money-ms", configuration = TransactionRestTemplateConfiguration.class)
public interface UserMoneyClient {

    @RequestMapping(value = "/user-money/save",method = RequestMethod.POST)
    int save();
}