# lx-boot

**Repository Path**: LanyXP/lx-boot

## Basic Information

- **Project Name**: lx-boot
- **Description**: lx-boot 整合springboot + dubbo 
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-02-23
- **Last Updated**: 2022-06-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# lx-boot

#### 介绍
lx-boot 是一个基于SpringBoot + Dubbo + MybatisPlus + TX-LCN的分布式微服务框架
项目层次明了 结构清晰 贴合企业实战项目 lx-boot 也是一个易扩展的框架 可以无缝衔接至其他的优秀开源组件 开发者可根据实际进行配置 
#### 软件架构
> 1.  核心框架 SpringBoot 2.1.6
> 2.  服务中间件 Dubbo 2.6.1
> 3.  数据持久层 Mybatis-Plus 3.2.0
> 4.  连接数据 Druid 1.1.10
> 5.  校验框架 HibernateValidator6.0.7
> 6.  代码简化插件 Lombok1.18.2
> 7.  分布式事务框架 TX-LCN 4.1.0
> 9.  通用基础工具类 Hutool 5.5.8
> 10. 服务注册发现 Zookeeper 3.4.6
> 11. 分布式全局配置 Apollo1.0.0
> 12. 分布式缓存 Redis 3.2.5 
> 13. 在线api文档 swagger2
#### 安装教程
1.  本地安装Mysql 保证数据库使用正常 (必须)
2.  安装Redis (必须)
3.  安装zookeeper (必须)
4.  安装Apollo 详细参考携程官方(非必须)
#### 使用说明
##### 项目结构
* 项目整体结构

![](./doc/项目整体结构.png)
* 模块说明
> 1. 为了微服务化和结构化 我将项目 主要划分成lx-boot-web 这一模块 主要对接前端的服务工程 通俗意义来讲
  只写Controller相关的业务逻辑代码 但是该工程也支持提供Dubbo服务
> 2. lx-boot-demo-service 这一模块 主要提供dubbo服务 后端的服务端工程
> 3. tx-manager 是Tx-lcn 提供的事务管理器 方便在本地调试
> 4. lx-boot-common 公共组件 提供包括自定义异常 全局请求参数规范等相关 
##### 配置说明
* 修改zookeeper 以及redis 和mysql地址
> 1. tx-manager 修改application.properties zk地址为自己的地址 
spring.cloud.zookeeper.connect-string=192.168.37.133:2181
redis地址可根据实际配置成单机或集群
> 2. lx-boot-web 修改application.yml zk地址为自己的地址
  mysql redis地址为实际地址
 注意：
 > 1. Apollo 目前没有使用 如要使用 请修改一下配置 以lx-boot-web 为列 
 > apollo.bootstrap.enabled: ture 
 > apollo.meta: http://192.168.0.153:8080 为服务实际地址 
##### 启动说明
> 1. 先启动Tx-manager
> 2. 启动 lx-boot-demo-service 模块
> 3. 启动lx-boot-web 模块
##### 特别说明 
> 1. 项目中为了集成演示LCN分布式事务用法Demo项目已集成
> 2. Zookeeper 版本为兼容Dubbo LCN 不建议轻易变换版本
> 3. Demo B 是复制版Demo 调用链路如图

![](./doc/调用流程图.png)


#### 特技

1.  使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md
2.  Gitee 官方博客 [blog.gitee.com](https://blog.gitee.com)
3.  你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解 Gitee 上的优秀开源项目
4.  [GVP](https://gitee.com/gvp) 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目
5.  Gitee 官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help)
6.  Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)