1 Swagger

  1.1 简述

    前后端分离的项目需要前后端开发人员协同工作,后台开发人员需要给到前端开发者一套API文档;利用Swagger可以简单高效的帮助后台开发者生成RestfulAPI开发文档

    官网地址:点击前往

  1.2 使用步骤

    1.2.1 引入swagger相关依赖

        <!-- 自动生成restfulAPI文档相关 -->
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger2</artifactId>
<version>2.7.0</version>
</dependency>
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger-ui</artifactId>
<version>2.7.0</version>
</dependency>

    1.2.3 支持注解

      在SpringBoot项目的启动类上标注 @EnableSwagger2 使项目支持 swagger 注解

    1.2.4 文档注解

      在需要生成API文档的地方标注相应注解即可

      》方法级别

        @ApiOperation(value = "查询所有用户信息")

          

      》参数级别(单个参数)

        @ApiParam(value = "订单ID")  

      》参数级别(参数是一个实体类)

        @ApiModelProperty(value = "用户ID")

        技巧01:直接在实体类中的某个字段上添加 @ApiModelProperty(value = "用户ID")

          

    1.2.5 访问 swagger-ui.html

      技巧01:如果项目设置了 上下文路径,那么就需要在前面添加 上下文路径,例如

        

http://127.0.0.1:9999/dev/swagger-ui.html

      

2 WireMock

  前端开发人员需要一些后天的模拟数据,后台开发人员可以利用WireMock模拟一些数据供前端人员调用

  技巧01:WireMock 是一个单独的服务器

  2.1 单独使用WireMock

    直接将数据放到指定文件,在进行一些配置后再启动WireMock服务器就可以啦

    技巧01:这种方法使用简单但是对于后台开发人员不太方便,详细使用方法请参见百度

    技巧02:这种方法适合前端人员使用(PS:前端人员拿到了后台给他的JSON文件)

  2.2 在项目中集成WireMock

    2.2.1 下载WireMock的jar包

      到WireMock的官网把jar包下载到本地

      WierMock官网:点击前往

      

    2.2.2 启动WierMock

      下载的WireMock就相当于一个项目的jar包,我们只需要在JVM上运行这个jar包即可

      技巧01:进入到WireMock的jar包所在的文件夹,然后运行这个jar包

      技巧02:在运行这个jar包时可以指定端口等信息,详情参见官方文档

java -jar wiremock-standalone-2.17.0.jar --port=8062

      

    2.2.3 在SpringBoot项目中集成(简单)

      2.2.3.1 下载先关jar包

        <dependency>
<groupId>com.github.tomakehurst</groupId>
<artifactId>wiremock</artifactId>
<version>2.14.0</version>
</dependency>

      2.2.3.2 发布信息

        》连接配置

          技巧01:需要配置WireMock的IP地址以及端口,如果是本地就不需要配置IP地址,直接配置端口即可

        》清空上一次的发布信息

        》执行main方法进行消息发布

package com.example.wiremock.util;

import org.apache.commons.io.FileUtils;
import org.apache.commons.lang3.StringUtils;
import org.springframework.core.io.ClassPathResource; import java.io.IOException; import static com.github.tomakehurst.wiremock.client.WireMock.*; /**
* @author 王杨帅
* @create 2018-05-11 9:29
* @desc
**/
public class WireMockServerUtil02 {
public static void main(String[] args) throws IOException { // 01 连接配置
configureFor(8062); // 配置连接信息(PS:这个端口必须和启动WireMock的端口保持一致) // 02 清空发布信息
removeAllMappings(); // 清空上一次的发布信息 // 03 发布新信息
stubFor(
get(urlPathEqualTo("/wiremock/test")) // 设置请求路径
.willReturn(
aResponse() // 设置响应信息
.withBody("{\"id\":12,\"name\":null,\"password\":null}") // 响应数据
.withStatus(200) // 响应状态码
)
); } }

WireMockServerUtil02.java

      2.2.3.3 请求WireMock中的模拟数据

        技巧01:IP地址、端口、请求路径都是WireMock的,不是SpringBoot项目的

        

    2.2.4 在SpringBoot项目中集成(实用)

      将需要发布的数据放到一个txt文件中去,需要发布某个txt文件中的数据时直接调用某个方法即可

      2.2.4.1 下载相关jar包

        <dependency>
<groupId>com.github.tomakehurst</groupId>
<artifactId>wiremock</artifactId>
<version>2.14.0</version>
</dependency>
<dependency>
<groupId>commons-io</groupId>
<artifactId>commons-io</artifactId>
<version>2.4</version>
</dependency>

      2.2.4.2 发布信息

        》在resources目录下创建一个文件夹

          

        》在里面创建txt文件来存放你需要发布的后台模拟数据(PS:数据要以JSON格式书写)

          技巧01:一个文件只能存放一个请求对应的后台模拟数据

{
"name": "王杨帅",
"age": 24,
"address": "chongqingyuzu"
"gender": "F"
}

user.txt

        》工具类

          》》 WireMock连接信息配置

          》》 清空发布信息

          》》 发布工具方法

    public static void mock(String filename, String url) throws IOException {
ClassPathResource classPathResource = new ClassPathResource("mock/response/" + filename);
String data = StringUtils.join(FileUtils.readLines(classPathResource.getFile(), "UTF-8").toArray(), "\n");
stubFor(
get(urlPathEqualTo(url))
.willReturn(
aResponse()
.withBody(data)
.withStatus(200)
)
);
}

发布方法

          》》调用发布方法发布信息

            技巧01:只需要传入 文件名 和 请求路径即可

package com.example.wiremock.util;

import org.apache.commons.io.FileUtils;
import org.apache.commons.lang3.StringUtils;
import org.springframework.core.io.ClassPathResource; import java.io.IOException; import static com.github.tomakehurst.wiremock.client.WireMock.*; /**
* @author 王杨帅
* @create 2018-05-11 9:29
* @desc
**/
public class WireMockServerUtil {
public static void main(String[] args) throws IOException { configureFor(8062);
removeAllMappings();
mock("user.txt", "/user");
mock("teacher.txt", "/teacher"); } public static void mock(String filename, String url) throws IOException {
ClassPathResource classPathResource = new ClassPathResource("mock/response/" + filename);
String data = StringUtils.join(FileUtils.readLines(classPathResource.getFile(), "UTF-8").toArray(), "\n");
stubFor(
get(urlPathEqualTo(url))
.willReturn(
aResponse()
.withBody(data)
.withStatus(200)
)
);
}
}

WireMockServerUtil.java

          》》执行main方法进行消息发布

      2.2.4.3 请求WireMock中的模拟数据

        

SpringBoot18 Swagger、API接口文档生成、WireMock、模拟后台数据的更多相关文章

  1. ASP.NET Core 3.1使用Swagger API接口文档

    Swagger是最流行的API开发工具,它遵循了OpenAPI规范,可以根据API接口自动生成在线文档,这样就可以解决文档更新不及时的问题.它可以贯穿于整个API生态,比如API的设计.编写API文档 ...

  2. Api接口文档管理工具,你知道哪些呢?

    上周看到有人在我的Github开源项目中提了个issue,说是否考虑接入swagger.那今天我就用swagger与其他接口文档工具做对比,同时说说Api接口文档工具的那点事.如今,在前后端分离开发的 ...

  3. Swagger 生成 PHP API 接口文档

    Swagger 生成 PHP API 接口文档 Lumen微服务生成Swagger文档 1.概况 有同学反馈写几十个接口文档需要两天的工作量, 随着多部门之间的协作越来越频繁, 维护成本越来越高, 文 ...

  4. spring boot使用swagger生成api接口文档

    前言 在之前的文章中,使用mybatis-plus生成了对应的包,在此基础上,我们针对项目的api接口,添加swagger配置和注解,生成swagger接口文档 具体可以查看本站spring boot ...

  5. 整合swagger2生成Restful Api接口文档

    整合swagger2生成Restful Api接口文档 swagger Restful文档生成工具 2017-9-30 官方地址:https://swagger.io/docs/specificati ...

  6. Swagger解决你手写API接口文档的痛

    首先,老规矩,我们在接触新事物的时候, 要对之前学习和了解过的东西做一个总结. 01 痛     苦 不做.不行 之前,前后端分离的系统由前端和后端不同的编写,我们苦逼的后端工程师会把自己已经写完的A ...

  7. SpringBoot + Swagger2 自动生成API接口文档

    spring-boot作为当前最为流行的Java web开发脚手架,相信越来越多的开发者会使用其来构建企业级的RESTFul API接口.这些接口不但会服务于传统的web端(b/s),也会服务于移动端 ...

  8. Spring Boot(九)Swagger2自动生成接口文档和Mock模拟数据

    一.简介 在当下这个前后端分离的技术趋势下,前端工程师过度依赖后端工程师的接口和数据,给开发带来了两大问题: 问题一.后端接口查看难:要怎么调用?参数怎么传递?有几个参数?参数都代表什么含义? 问题二 ...

  9. 在.Net Core中使用Swagger制作接口文档

    在实际开发过程中后台开发人员与前端(移动端)接口的交流会很频繁.所以需要一个简单的接口文档让双方可以快速定位到问题所在. Swagger可以当接口调试工具也可以作为简单的接口文档使用. 在传统的asp ...

随机推荐

  1. Python虚拟环境设置

    Python2环境 首先,我们用pip安装virtualenv: pip3 install virtualenv 然后,假定我们要开发一个新的项目,需要一套独立的Python运行环境,可以这么做: 第 ...

  2. HDU2032 杨辉三角

    解题思路:不要小看这题水题,如果数据类型没有用long long, 当n开为35时,会出现TLE,而且会报非法内存访问,现在还 不理解为什么,若有高手,请不吝赐教. 上代码: #include< ...

  3. BZOJ - 2141 排队 (动态逆序对,区间线段树套权值线段树)

    题目链接 交换两个数的位置,只有位于两个数之间的部分会受到影响,因此只需要考虑两个数之间有多少数对a[l]和a[r]产生的贡献发生了变化即可. 感觉像是个带修改的二维偏序问题.(修改点$(x,y)$的 ...

  4. python学习-实现用户密码登录,输错三次锁定

    作业需求: 输入用户名密码 认证成功后显示欢迎信息 输错三次后锁定 实现思路: 判断用户是否在黑名单,若在黑名单,则将用户锁定 判断用户是否存在,若不存在,提示用户不存在 若用户存在,判断登录密码是否 ...

  5. oracle alter table

    oracle alter table ALTER TABLE (表名) ADD (列名 数据类型); ALTER TABLE (表名) MODIFY (列名 数据类型); ALTER TABLE (表 ...

  6. SPOJ1812 Longest Common Substring II

    题意 A string is finite sequence of characters over a non-empty finite set Σ. In this problem, Σ is th ...

  7. 洛谷P2661 信息传递

    传送门 题目大意:每个人每一轮可以把消息传给另一个人,问几轮后某个人可以从人 听到自己的消息. 题解:tarjian缩点,求缩点后缩的点包含的最少的点个数. 代码: 正解 #include<io ...

  8. poj 3590 The shuffle Problem——DP+置换

    题目:http://poj.org/problem?id=3590 bzoj 1025 的弱化版.大概一样的 dp . 输出方案的时候小的环靠前.不用担心 dp 时用 > 还是 >= 来转 ...

  9. Java 引用类型变量的声明和使用

    引用类型变量的声明和使用 (1)把类名当作是一种类型来声明变量,这种变量叫引用类型变量.如:People people; (2)引用类型变量保存对象的“引用”,即对象的地址. (3)对象的创建 new ...

  10. ubuntu下安装ros出现“无法下载-package.ros.org中某个包-校验和不符”的解决方法

    新安装的Ubuntu14.04,为了科研马上准备装ros indigo,却困难重重,一步一个坎. 比如说按照ros wiki里面一步一步来,当运行sudoapt-get update 然后出现下列情况 ...