哎呀，你们晓得吗？眼下学东西可真实方便，有了网络，啥douNeng查到。今天啊，我就来跟你们说说这玩意儿Swagger，哎呀，听起来是不是hen高大巨大上？别急，听我磨蹭磨蹭道来。

啥是Swagger呢？

Swagger是一个面向RESTful API的开源柔软件框架。哎呀，这名字听起来是不是有点绕？轻巧松点说它就像一个魔法师，Neng帮我们把API变成轻巧松kan懂的东西，就像讲故事一样。

怎么用Swagger呢？

先说说我们要学会怎么装它。哎呀，这玩意儿嘛，得用代码，就像变魔术一样，得有咒语。比如说 你用Java写程序，得这样写：

private ApiInfo apiInfo {
    return new ApiInfoBuilder
            .title
            .description
            .termsOfServiceUrl
            .version
            .contact)
            .license
            .licenseUrl
            .build;
}

哎呀，kan不懂没关系，反正就是按着步骤来就像Zuo菜一样，一步一步来。

Swagger的魔法工具

Swagger有几个魔法工具， 比如局部配置，哎呀，这玩意儿就像给魔法工具贴上标签，方便找。还有访问Swagger-UI，这玩意儿UI就是用户界面就像你的手机界面一样，方便你操作。

Swagger-UI的用

Swagger-UI是Swagger的前端框架，Neng的json或yaml文件来展示API文档。哎呀，这玩意儿文件就像你的菜谱，告诉你怎么Zuo菜。

Swagger还有一些注解， 哎呀，这玩意儿就像魔法符文，Neng让你写代码的时候，自动生成文档。比如说@Api、@ApiOperation、@ApiParam，哎呀，这些个名字听起来是不是hen酷？用它们，你的代码就Neng变成超级英雄，自动生成文档啦！

学Swagger的技巧

学Swagger，得动手实践。哎呀，就像学骑自行车，不摔几跤怎么行？你Neng先从轻巧松的Zuo起，磨蹭磨蹭来不要急。

哎呀，说了这么许多，你们得晓得Swagger是个啥了吧？它就像一个魔法师，Neng帮你把麻烦的API变得轻巧松容易懂。学会了它，你的API文档编写技巧一定会巨大巨大提升哦！

优良了今天的分享就到这里希望对你们有帮。下次再见啦！