使用swagger自动生成html文档

本节内容

• 使用swagger自动生成html文档
• 使用WireMock快速伪造restful服务

前后分离并行开发的时候（当然不是一个人从前到后都干那种）；那么提供文档就很有必要了。

光看文档不是那么的直观。伪造服务可能更直观（个人感觉而言，文档详细，自己在postman这种工具中去调用也是一样的）

初体验

添加两个依赖

    // 扫描程序生成文档数据
    // http://springfox.github.io/springfox/docs/current/
    // https://mvnrepository.com/artifact/io.springfox/springfox-swagger2
    compile group: 'io.springfox', name: 'springfox-swagger2', version: '2.9.2'
    // 提供可视化界面
    // https://mvnrepository.com/artifact/io.springfox/springfox-swagger-ui
    compile group: 'io.springfox', name: 'springfox-swagger-ui', version: '2.9.2'

添加注解开启swagger

    @EnableSwagger2
    public class DemoApplication {

启动程序后，访问：http://localhost:8080/swagger-ui.html 就能看到一个界面。里面会显示该程序中所有的的controller断点。并扫描该断点的注解等信息进行分析一些有关断点的信息；

可以点击Try it out按钮发起请求，然后在界面上会把响应结果返回；

这样看的确挺方便的；

使用注解自定义信息

定义api描述

    @ApiOperation(value = "用户查询服务")  // 方法描述
    public List<User> query(UserQueryCondition condition) {

定义请求字段信息，如果参数是一个对象，则需要在对象字段上添加注解

    public class UserQueryCondition {
        @ApiModelProperty(value = "用户名")
        private String username;

不是对象的字段描述

    @JsonView(User.UserDetailView.class)
    public User getInfo(@ApiParam(value = "用户id") @PathVariable String id) {

上面是3个常用的注解，其他的官网文档查看；

个人感觉：相对于spring-restdocs-asciidoctor代码入侵太严重，我个人是不太愿意用的；但是的确很方便能看到所有提供的服务；包括spring框架提供的

下一节：使用WireMock快速伪造restful服务

Java 面试宝典是大明哥全力打造的 Java 精品面试题，它是一份靠谱、强大、详细、经典的 Java 后端面试宝典。它不仅仅只是一道道面试题，而是一套完整的 Java 知识体系，一套你 Java 知识点的扫盲贴。

它的内容包括：

• 大厂真题：Java 面试宝典里面的题目都是最近几年的高频的大厂面试真题。
• 原创内容：Java 面试宝典内容全部都是大明哥原创，内容全面且通俗易懂，回答部分可以直接作为面试回答内容。
• 持续更新：一次购买，永久有效。大明哥会持续更新 3+ 年，累计更新 1000+，宝典会不断迭代更新，保证最新、最全面。
• 覆盖全面：本宝典累计更新 1000+，从 Java 入门到 Java 架构的高频面试题，实现 360° 全覆盖。
• 不止面试：内容包含面试题解析、内容详解、知识扩展，它不仅仅只是一份面试题，更是一套完整的 Java 知识体系。
• 宝典详情：https://www.yuque.com/chenssy/sike-java/xvlo920axlp7sf4k
• 宝典总览：https://www.yuque.com/chenssy/sike-java/yogsehzntzgp4ly1
• 宝典进展：https://www.yuque.com/chenssy/sike-java/en9ned7loo47z5aw

目前 Java 面试宝典累计更新 400+ 道，总字数 42w+。大明哥还在持续更新中，下图是大明哥在 2024-12 月份的更新情况：

想了解详情的小伙伴，扫描下面二维码加大明哥微信【daming091】咨询

同时，大明哥也整理一套目前市面最常见的热点面试题。微信搜[大明哥聊 Java]或扫描下方二维码关注大明哥的原创公众号[大明哥聊 Java] ，回复【面试题】 即可免费领取。