<!--引入swagger-->
<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger2</artifactId>
    <version>2.3.1</version>
</dependency>
<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger-ui</artifactId>
    <version>2.3.1</version>
</dependency>

<mvc:resources mapping="/swagger-ui.html" location="classpath:/META-INF/resources/" />
<mvc:resources mapping="/webjars/**" location="classpath:/META-INF/resources/webjars/" />
<bean class="cn.xxxx.index.controller.SwaggerConfig" id="swagger2Config"/>

package cn.xxx.controller;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import springfox.documentation.builders.ApiInfoBuilder;
import springfox.documentation.builders.PathSelectors;
import springfox.documentation.service.ApiInfo;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
import springfox.documentation.swagger2.annotations.EnableSwagger2;

@Configuration
@EnableSwagger2  //启用Swagger2
public class SwaggerConfig {
    @Bean
    public Docket api() {
        return new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(apiInfo())
                .pathMapping("/")
                .select()
                .paths(PathSelectors.regex("/.*"))
                .build();
    }

    private ApiInfo apiInfo() {
        return new ApiInfoBuilder().title("xxx接口文档")
                .contact("aaa@aa.com")
                .description("这是swaggerUI生成的接口文档")
                .version("1.0.0.0")
                .build();
    }
}

package cn.xxx.index.controller;

import io.swagger.annotations.*;
import org.springframework.web.bind.annotation.*;

import javax.servlet.http.HttpServletRequest;
import java.util.ArrayList;
import java.util.List;

/**
 */
@RestController
@Api(value = "电影Controller", tags = { "电影访问接口" })
@RequestMapping("/film")
public class FilmController {

    /**
     * 添加一个电影数据
     *
     * @param
     * @return
     */
    @ApiOperation(value = "添加一部电影",httpMethod = "POST")
    @RequestMapping("/addFilm")
    @ApiResponses(value = { @ApiResponse(code = 200, message = "成功"), @ApiResponse(code = 500, message = "失败"),
            @ApiResponse(code = 502, response = Integer.class,message = "缺少参数") })
    public int addFilm(@ApiParam("电影名称") @RequestParam("filmName") String filmName,
                               @ApiParam(value = "分数") @RequestParam("score") Short score,
                               @ApiParam("发布时间") @RequestParam(value = "publishTime",required = false) String publishTime,
                               @ApiParam("创建者id") @RequestParam("creatorId") Long creatorId) {


        return 1;
    }

    /**
     * 根据电影名字获取电影
     *
     * @param fileName
     * @return
     */
    @RequestMapping("/getFilms")
    @ApiOperation(value = "根据名字获取电影",httpMethod = "GET")
    @ApiResponses(value = { @ApiResponse(code = 200, message = "成功"), @ApiResponse(code = 500, message = "失败"),
            @ApiResponse(code = 502, message = "缺少参数") })
    public List<String> getFilmsByName(@ApiParam("电影名称") @RequestParam("fileName") String fileName) {
        List<String> films = new ArrayList<>();
        return films;

    }

    /**
     * 根据电影名更新
     *
     * @return
     */
    @RequestMapping("/updateScore")
    @ApiOperation(value = "根据电影名修改分数",httpMethod = "POST")
    @ApiResponses(value = { @ApiResponse(code = 200, message = "成功"), @ApiResponse(code = 500, message = "失败"),
            @ApiResponse(code = 502, message = "缺少参数") })
    public int updateFilmScore(@ApiParam("电影名称") @RequestParam("fileName") String fileName,
                                       @ApiParam("分数") @RequestParam("score") Short score) {
        return 1;
    }

    /**
     * 根据电影名删除电影
     *
     * @param request
     * @return
     */
    @RequestMapping("/delFilm")
    @ApiOperation(value = "根据电影名删除电影",httpMethod = "POST")
    @ApiImplicitParams({ @ApiImplicitParam(name = "filmName",
            value = "电影名",
            dataType = "String",
            paramType = "query",
            required = true), @ApiImplicitParam(name = "id", value = "电影id", dataType = "int", paramType = "query") })
    public int deleteFilmByNameOrId(HttpServletRequest request) {
        return 1;
    }

    /**
     * 根据id获取电影
     *
     * @param id
     * @return
     */
    @RequestMapping("/{id}")
    @ApiOperation(value ="根据id获取电影",httpMethod = "GET")
    @ApiImplicitParam(name = "id", value = "电影id", dataType = "long", paramType = "path", required = true)
    public String getFilmById(@PathVariable Long id) {
        return "aaa";
    }

    /**
     * 修改整个电影
     *
     * @param film
     * @return
     */
    @RequestMapping("/insertFilm")
    @ApiOperation(value ="插入一部电影",httpMethod = "POST")
    public int insertFilm(@ApiParam("电影实体对象") @RequestBody String film) {
        return 1;
    }
}

<dependency>
    <groupId>com.github.xiaoymin</groupId>
    <artifactId>swagger-bootstrap-ui</artifactId>
    <version>1.9.6</version>
</dependency>