Swagger 是一个规范和完整的框架，用于生成、描述、调用和可视化 RESTful 风格的 Web 服务。总体目标是使客户端和文件系统作为服务器以同样的速度来更新。文件的方法，参数和模型紧密集成到服务器端的代码，允许 API 来始终保持同步。
swagger 官方 Demo 供参考
https://petstore.swagger.io/
swagger 通过注解表明该接口会生成文档，包括接口名、请求方法、参数、返回信息的等等。
@Api(tags = “收付费方式变更”) 常用
@ApiOperation(“获取用户列表”) 常用
@ApiParam(value = “用户Id”) 常用
@ApiImplicitParam：
作用在方法上，表示单独的请求参数, 一个非常强大且重要的注解, 作用和 ApiParam 类似
Maven 翻译为"专家"、“内行”，是 Apache 下的一个纯 Java 开发的开源项目。基于项目对象模型（缩写：POM）概念，Maven 利用一个中央信息片断能管理一个项目的构建、报告和文档等步骤。
Maven 是一个项目管理工具，可以对 Java 项目进行构建、依赖管理。
Maven 也可被用于构建和管理各种项目，例如 C#，Ruby，Scala 和其他语言编写的项目。Maven 曾是 Jakarta 项目的子项目，现为由 Apache 软件基金会主持的独立 Apache 项目。
Maven is a software project management and comprehension tool. Based on the concept of a Project Object Model (POM), Maven can manage a project’s build, reporting and documentation from a central piece of information.
mac 下已经自带了 svn 软件 。使用svn –version 查看是否安装。
如果你有安装 XCode，只需要在 code > Preferences > download > Command Line Tools > Install 即可，速度很快，基本 1 分钟搞定。
如果没有，不建议手动查找安装包，应该是在 Apple Developer 网站 下载 Command_Line_Tools_for_Xcode.dmg 安装包。
当然也可以命令行安装 xcode-select --install。
也可使用 brew 安装 svn
1 | brew install svn |
https://www.jetbrains.com/idea/download/other.html
版本选择：根据我的观察，每年五月份过后获取的上个年度的最新版本应该是最终版本，可下载之。
${user.home}/. IntelliJIdea2020.3 目录中初始化一系列的配置文件。附原文：