learn-knowlege / manageplatform Goto Github PK

当我看完《深入了解 Spring Cloud 与微服务构建》的时候，我就打算将所学习到的 Spring Cloud 组件使用到项目中做成一个小项目，加深理解。

该项目是在个人 PC 运行，带宽是1M且有可能不稳定，项目也不一定长期启动...（出租房电费太贵了）。正常运行时间为：9:00 ~ 20:00
项目Demo：http://mugglelee.nat300.top/api-b/login.html
项目Github地址：https://github.com/MuggleLee/ManagePlatform
账号：Tourist
密码：123456
（此账号设置了权限，不能对显示的信息删除或者修改，如有疑问，可在评论区与我一起探讨）

• 账号登录
• 微信授权登录（由于是个体测试者，只能通过关注我个人的测试公众号才能微信授权，如有需要，可通过微信关注以下公众号）
• 手机号码登录：使用阿里云短信服务。通过帐号登录后可在页面右上方绑定手机号码，以后登录的话可以直接通过 手机号码+验证码 登录

• 菜单管理：菜单列表、添加菜单、修改菜单、删除菜单、菜单图标设置
• 角色管理：角色查询、添加角色、修改角色、删除角色、分配菜单、分配权限
• 权限管理：权限查询、添加权限、修改权限、删除权限
• 用户管理：用户查询、添加用户、修改用户、给用户分配角色、重置密码
• 文件管理：上传文件、文件列表、文件删除
• 邮件管理：发送邮件、查询邮件
• 注册中心：查看微服务注册情况
• 监控中心：监控微服务信息
• 接口swagger文档
• ip黑名单：查询、添加、删除ip黑名单
• 日志查询
• 个人信息修改
• 修改密码
• 头像修改

系统：Windows10 —— 项目的子项目和运行环境都通过启动 Docker 镜像运行。详情可查看父项目的 docker-compose.yml 配置

Spring Cloud (Finchley)、Spring Security、JDK8、Maven、Mysql 5.6、Mybatis-Plus、Redis5、Rabbitmq、Docker

├─CommonModel：基础Model
├─CommonUnits：工具包
├─ConfigCenter：配置中心
├─FileCenter：文件上传中心
├─GatewayCenter：网关中心
├─LogCenter：日志中心
├─LogStarter：日志配置
├─ManageBackend：门户中心
├─MonitorCenter：监控中心
├─NotificationCenter：通知中心
├─OauthCenter：权限中心
├─RegisterCenter：注册中心
├─UserCenter：用户中心
├─buildImage：将所有子项目都打包后构建成镜像
├─docker-compose.yml：构建容器
├─Starting Sequence.md：查看子项目的启动顺序

Spring Cloud (Finchley)、Spring Security、JDK8、Maven、Mysql 5.6、Mybatis-Plus、Redis5、Rabbitmq、Docker

搭建框架：Spring Boot + Spring Cloud 2.0（Finchley版本） 好处：由于Spring Boot 默认大于配置的原则，可以快速搭建 Spring Cloud 微服务。

常用的注册中心有：Eureka，Zookeeper。那为什么选择使用 Eureka ？（没有实际项目支持说法，如有理解错误望帮助我改正...） 我觉得有以下两点：

1.Eureka是 Spring Cloud 首选推荐的服务注册和发现组件，可以和其它组件无缝对接；
2.分布式系统 CAP（Consistency，Availability，Partition tolerance）理论指出三种特性只能选其二。
Zookeeper 属于CP，所以对于 Zookeeper 来说，一致性高于可用性，优点是可以保证当前的节点信息是最新的，但当 master 节点故障会导致重新选举，而选举过程太长可能会导致整个zk集群不可用，导致瘫痪；
Eureka 属于AP，使用 Eureka 则不会因为几个节点挂掉而影响其他节点，但缺点也很明显，Eureka不保证强一致性，所以可能其他节点查询的信息并不是最新的。

当前项目我并没有部署集群，也不必要保证当前的节点信息是最新的，另外为了能够与其他 Spring Cloud 组件无缝对接，我选择使用 Eureka。

常见可以作为配置中心的组件还有Spring Cloud 提供的 Config 组件、携程开源的 Apollo 组件、阿里开源的 Nacos 的组件。 由于都没有试用过，了解也不深，因此我使用了 Spring Cloud 提供的 Config 组件，因为可以无缝的和其它微服务组件对接。不过以后有时间的话，还是需要了解一下这几个组件的区别和优缺点才行...

常用的网关有 Nginx、OpenResty、Zuul 和 Spring Cloud Gateway。由于该项目对性能要求不高，所以没有使用高性能的 Nginx 和 Opensty。 而 Spring Cloud Gateway 作为了官方的网关组件，可以与 Spring Cloud 其它组件无缝对接。但现在网上相关的资料还是相对 Zuul 少。虽然 Zuul 是阻塞式，不支持长连接的，但现在网上的相关资料较多，出了问题还是比较容易找到解决办法，因此该项目选择了 Zuul 作为网关组件。 （不过正在考虑接下来将Zuul组件替代为Spring Cloud Gateway，据说配置更简单...）

Spring Cloud 提供了带有熔断机制的框架——Hystrix。熔断器的作用是当某个服务节点出现故障可以通过快速失败机制保证其他远程调用服务不会导致系统卡死。因此在微服务中，熔断器是十分重要的，而 Spring Cloud 提供的 Hystrix 是当前比较热门的熔断器组件。

Spring Boot Admin 是一个针对 Spring Boot 的 Actuator 接口进行 UI 美化封装的监控工具。可以在列表中浏览所有被监控 Spring Boot 项目的基本信息，详细的 Health 信息、内存信息、JVM 信息、垃圾回收信息、各种配置信息（比如数据源、缓存列表和命中率）等，还可以直接修改 logger 的 level。 甚至根据监控的服务状况发送邮件或者短信通知管理员，譬如某个节点或者某个服务挂了，可以立即通知管理员上线解决问题。

Zipkin 是 Twitter 的一个开源项目，致力于手机分布式系统的链路数据，提供持久化策略，也提供UI页面方便开发人员查看接口，查询服务之间的调用链路信息。

常见的消息队列有 RabbitMQ、RocketMQ、ActiveMQ、Kafka。在实际项目中如何选型呢？这要根据各种 MQ 的特性和使用场景决定。 ActiveMQ维护越来越少，即使出问题也不容易解决；Kafka适合流计算和大数据场景，而且延迟相对RabbitMQ和RocketMQ较高，因此该项目不使用ActiveMQ和Kafka。至于RabbitMQ和RocketMQ的选型上，在本项目中我个人认为没什么差别，但RabbitMQ提供了非常完善便捷的后台管理界面，因此我选用RabbitMQ。

项目一开始是使用 Mybatis 作为持久层框架，项目完成之后看到一些文章介绍 Mybatis 的升级版——Mybatis-Plus。 打开Mybatis-Plus的官网，最吸引眼球的就是其 slogan ——“为简化开发而生”。原先的 Mybatis 框架虽然能够很灵活的操作 SQL 语句，但弊端是要创建大量的 XML 文件，后期也不容易维护。而Mybatis-Plus不再需要创建XML文件，只需要定义一些接口，直接调用CRUD的方法，也很方便的使用注释自定义SQL语句，热加载、代码生成、分页、性能分析等功能一应俱全。不仅如此，Mybatis-Plus 还有函数式编程的特性，可以发现项目中大量的使用 Stream 流，拼装对象属性和CRUD不再是几十行冗长的代码，而是简简单单的几行甚至一行代码就能搞掂，大大提高了开发效率！更多 Mybatis-Plus 使用参考官方。（力推学习！）