API文档生成

leap可以根据代码自动按照swagger的标准生成api文档，当我们配置好一个api之后，leap会自动在该api的base-path下增加一个/swagger.json的接口，访问这个接口即可看到生成的swagger文档，路由表示例如下：

METHOD PATH                   ACTION                                       DEFAULT VIEW
------ ---------------------- -------------------------------------------- ------------------------------
GET    /demo-api/swagger.json SwaggerProcessor$$Lambda$93/331422133.handle (none)

在浏览器中访问这个url，可以得到如下json:

http://{host}:{port}/{context}/{base-path}/swagger.json

{
    swagger: "2.0",
    info: {
        title: "demo-api",
        description: "",
        version: "1.0"
    },
    host: "localhost:8080",
    basePath: "/demo/demo-api",
    consumes: ["application/json"],
    produces: ["application/json"],
    paths: {},
    definitions: {}
}

这个时候paths为空，表示没有任何接口，我们可以打开swagger ui的官方示例页面，并把leap自动生成swagger的url传入示例应用，可以看到如下界面：

这个时候还没有接口，所以文档是空的，在API开发章节，我们将会看到，随着api开发，这里的文档逐渐生成的过程。