接口规范swagger

1. 为什么需要

• 接口测试人员要通过接口描述测试接口 --黑盒测试
• 前端开发人员要通过接口描述使用接口.

2. 写接口doc文档

• 直接整理出所有接口,每个接口有访问地址(访问方式),参数及返回值.
• 可以直接通过后端代码产生能够让前台开发或测试人员能够看懂生成的swagger文档

3. 实现

• 引入swagger需要的jar包

<!-- swagger引入包-->
	<properties>
        <!--swagger对应的版本-->
        <springfox.version>2.4.0</springfox.version>
    </properties>
        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger2</artifactId>
            <version>${
   springfox.version}</version