知识储备：

1.Swagger ui 封装

Swagger是一个Restful风格接口的文档在线自动生成和测试的框架
官网：http://swagger.io
官方描述：The World’s Most Popular Framework for APIs.

Swagger ui 的原生UI界面如下：

2.现在市面上的UI不足之处

1、原生UI显示的有些不够漂亮和清晰，特别是request 的model部分

2、每个服务都需要引入一套资源文件，不能作为一个中间件为其他API使用

3、默认通用配置繁琐，每个项目都需要复制重新配置一份swagger信息

3.关于Swagger

Swagger能成为最受欢迎的REST APIs文档生成工具之一，有以下几个原因：

Swagger 可以生成一个具有互动性的API控制台，开发者可以用来快速学习和尝试API。
Swagger 可以生成客户端SDK代码用于各种不同的平台上的实现。
Swagger 文件可以在许多不同的平台上从代码注释中自动生成。
Swagger 有一个强大的社区，里面有许多强悍的贡献者。

Swagger 文档提供了一个方法，使我们可以用指定的 JSON 或者 YAML 摘要来描述你的 API，包括了比如 names、order 等 API 信息。

你可以通过一个文本编辑器来编辑 Swagger 文件，或者你也可以从你的代码注释中自动生成。各种工具都可以使用 Swagger 文件来生成互动的 API 文档。

注：注意：用 Swagger 文件生成互动的 API 文档是最精简的，它展示了资源、参数、请求、响应。但是它不会提供你的API如何工作的其他任何一个细节。

实验目标

掌握微服务项目的整合使用
掌握Swagger-UI的简单使用

实验步骤

项目一、微服务项目整合

1.微服务项目预览

在https://github.com/shi469391tou/microservice-mallmanagement.git地址下载，并导入eclipse

查看项目整体结构

2.微服务项目功能介绍

microservice-eureka-server（Eureka注册中心），搭建服务注册中心，子项目将通过配置注册到注册中心。

修改配置application文件如图所示：

microservice-gateway-zuul，作为其他微服务项目的API网关，实现其他微服务接口的动态代理。

配置application文件如图所示：

microservice-orderservice，主要用于商品订单管理，并提供有关订单管理的RESTFUL风格和API接口。

配置application文件如图所示：

在microservice-orderservice中写对应的控制器类：

microservice-userservice，主要用于商品用户管理，并提供有关用户管理的RESTFUL风格和API接口。

配置application文件如图所示：

在microservice-userservice中写对应的控制器类：

3.微服务项目启动与测试

创建数据库，并插入数据

CREATE DATABASE microservice_mallmanagement;

USE microservice_mallmanagement;



DROP TABLE IF EXISTS `tb_order`;

CREATE TABLE `tb_order` (

  `id` int(11) NOT NULL AUTO_INCREMENT,

  `createtime` datetime DEFAULT NULL,

  `number` varchar(255) DEFAULT NULL,

  `userid` int(11) DEFAULT NULL,

  PRIMARY KEY (`id`)

) ENGINE=InnoDB AUTO_INCREMENT=3 DEFAULT CHARSET=UTF8;

INSERT INTO `tb_order` VALUES ('1', '2017-10-09 10:15:44', '201709181459001', '1');

INSERT INTO `tb_order` VALUES ('2', '2017-10-24 18:22:12', '201709181459008', '1');



DROP TABLE IF EXISTS `tb_user`;

CREATE TABLE `tb_user` (

  `id` int(11) NOT NULL AUTO_INCREMENT,

  `address` varchar(255) DEFAULT NULL,

  `username` varchar(255) DEFAULT NULL,

  PRIMARY KEY (`id`)

) ENGINE=InnoDB AUTO_INCREMENT=2 DEFAULT CHARSET=UTF8;

INSERT INTO `tb_user` VALUES ('1', 'beijing', 'shitou');

查看订单表