微服务项目的整合与测试

学习目标
掌握微服务项目的整合使用
掌握Swarrger-UI的简单使用
一、微服务项目结构预览
本项目模拟的是一个简单的商城管理系统，其项目整体结构如图所示。
microservice-eureka-server: 用于服务注册发现
microservice-gateway-zuul: 用于API网关
microservice-orderservice: 用于订单管理服务
microservice-userservice: 用于用户管理服务

二、微服务项目功能介绍
1、microservice-eureka-server（Eureka注册中心）
其对应的配置文件application.yml的具体内容如图所示。

2、microservice-gateway-zuul（Zuul API网关）
其对应的配置文件application.yml的具体内容如图所示。

3、microservice-orderservice（订单管理微服务）
其对应的配置文件application.yml的具体内容如图所示。
该项目对应的控制类OrderController的具体内容如图所示。

4、microservice-userservice（用户管理微服务）
其对应的配置文件application.yml的具体内容如图所示。

该项目对应的控制类UserController的具体内容如图所示。

三、微服务项目的启动和测试
商城管理系统的启动说明:
项目中的microservice-gateway-zuul 、microservice-orderservice和
microservice-userservice都注册到了microservice-eureka-server项目的服务注册中心上，所以必须先启动microservice-eureka-server项目，运行成功后I才可启动其他三个子项目。

由于microservice-orderservice（订单微服务）和microservice-userservice（用户微服务）都涉及了MySQL数据库的连接使用，所以在启动这两个微服务项目之前必须先创建好对应的数据库和表，并初始化相关数据。
SQL脚本内容如图。
查看：



以上创建了一个名为microservice_mallmanagement的数据库，同时在该数据库中分别创建tb_order表和tb_user表，并插入了一些初始化数据。
完成全部子项目的启动并运行成功后，通过地址http://localhost:8761/,即可访问Eureka服务注册中心，效果如图。

系统的功能测试
（1）测试接口方法。分别通过microservice-orderservice和microservice-
userservice两个微服务项目的地址来访问各自暴露的API接口方法(分别为http://localhost:7900/order/findOrders/1和http://localhost:8030/user /findOrders/shitou)进行测试

（2）测试API网关服务。针对上面的microservice-orderservice和microservice-userservice两个微服务项目，可以通过Zuul组件提供的API网关进行对应的接口代理测试(代理访问地址分别为http://localhost:8050/order-service/order/findOrders/1和http://localhost:8050/user-service/user/findOrders/shitou)。


从上图的访问地址和显示结果可以看出，使用Spring Cloud的Zuul组件实现API网关服务时，只需要访问microservice-gateway-zuul的服务地址并连接其他微服务映射的路径即可访问其他注册到Eureka注册中心的服务。

四、Swagger-UI使用方法
1.下载Swagger-UI项目
先从GitHub.上拉取Swagger-UI项目代码到本地，具体地址:
https://github. com/swagger-apilswagger-uigit。

2.引入Swagger-UI
找到本地下载好的Swagger-UI项目，进入项目并找到dist目录，将整个dist目录复制到需要使用Swagger-UIT具项目的resources目录下。

3.加入Swagger-UI依赖
在microservice-userservice项目的pom文件中加入Swagger的依赖。

4.编写配置类
在项目中创建一-?个Swagger-UI的配置类SwaggerConfiguration，并在该类中修改一些默认显示的API相关信息，其中最主要的是接口路径。

五、Swagger-UI使用测试
分别完成微服务项目microservice userservice和microservice
orderservice与Swagger-UI接口文档工具的整合后，只需要重新启动项目即可查看整合效果。
1.整合测试
重新启动所有整合了Swagger-UI接口文档工具的微服务项目，通过对应“服务地址IP+端口+/swagger-ui.html”请求路径即可进入测试页面。

2.接口测试
以用户管理接口文档为例，先单击user-controller面板，会展示出接口中的所有方法(项目只有一一个GET方法)，再单击某个具体的方法会展示出详细信息。
![在这里插入图片描述](https://img-blog.csdnimg.cn/2019060609260530.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NTE1ODIyOA==,size_16,color_FFFFFF,t_70
根据标注，在参数输入框中填写username的参数值shitou (之前MySQL数据库初始化时插入的数据)，然后单击“Try it out!”按钮即可进行测试。


从上图可以看出，该方法正确查询了username为shiyou的用户订单信息，同时在结果上方还提供了另外的Curl和URL两种请求方法，如果项目的接口方法有所变更，只需要将对应服务重启，并刷新文档页面就会自动更新对应的方法。