一、微服务项目整合
1、微服务项目结构预览
微服务项目的结构与预览本项目模拟的是一个简单的商城管理系统。
microservice-eureka-server:用于服务注册发现
microservice-gateway-zuul:用于API网关
microservice-orderservice:用于订单管理服务
microservice-userservice:用于用户管理服务
2、微服务项目功能介绍
(1)microservice-eureka-server(Eureka注册中心)
(2)microservice-gateway-zuul(Zuul API网关)
(3)microservice-orderservice(订单管理微服务)
该项目对应的控制类OrderController的具体内容:
(4)microservice-userservice(用户管理微服务)
该项目对应的控制器类UserController的具体内容:
3、微服务项目的启动和测试
必须先启动microservice-eureka-server项目,运行成功后才可启动其他的三个子项目。
SQL脚本的内容:
完成全部子项目的启动并运行成功后,通过地址http://localhost:8761/,即可访问Eureka服务注册中心。
启动成功后,即可对系统的功能进行测试:
<1>测试接口方法。分别通过microservice-orderservice和microservice-userservice两个微服务项目的地址来访问各自暴露的API接口方法(分别为http://localhost:7900/order/findOrders/1和http://localhost:8030/user/findOrders/shitou)进行测试。
<2>测试API网关服务。通过Zuul组件提供的API网关进行对应的接口代理测试(代理访问地址分别为http://localhost:8050/order-service/order/findOrders/1和http://localhost:8050/user-service/user/findOrders/shitou)
如果读者想要查看整个项目的源码,可通过GitHub进行下载查看,具体地址为https://github.com/shi469391tou/microservice-mallmanagement.git。
二、接口可视化工具—Swagger-UI
1、Swagger-UI使用方法
Swagger-UI官网以及其他开发者为其使用提供了多种配置方式。
(1)下载Swagger-UI项目
从GitHub上拉取Swagger-UI项目代码,具体的地址如下:
https://github.com/swagger-api/swagger-ui.git
(2)引入Swagger-UI
(3)加入Swagger依赖
在microservice-userservice项目的pom文件中加入Swagger的依赖。
(4)编写配置类
在项目中创建一个Swagger-UI的配置类SwaggerConfiguration,并在该类中修改一些默认显示的API相关信息,其中最重要的事接口路径,
三、Swagger-UI使用测试
1、整合测试
启动成功后,通过对应“服务地址IP+/swagger-ui.html"请求路径即可进入测试页面。
2、接口测试
以用户管理API接口测试文档为例,先单击user-controller面板,会展示出接口中的所有方法,再单击某个具体的方法会展示出详细信息。
在参数信息输入框中填写username的参数值shitou,然后单击“try it out!按钮即可进行测试。
如果项目的接口方法有所变更,只需要将对应服务重启,并刷新文档页面就会自动更新对应的方法。