java rest框架_比较Java REST文档框架

java rest框架

决定在记录REST API时选择哪种Java框架可能很麻烦。 在本博文中，我们将简要比较我们自己使用的REST Web服务的三个文档框架，以及它们如何与Spring框架（这是Foreach中最常用的Java框架）集成。 这些是RESTful API建模语言（RAML），Swagger UI和Spring REST Docs。

在每一部分中，我们将对所讨论的文档框架进行高层概述。 我们将简要描述文档框架如何与Spring集成以及如何在您的文档中使用该框架影响构建周期。

RESTful API建模语言（RAML）

RAML是一个单独的文档，与您作为开发人员需要手动维护的项目一起保存。 在默认的RAML配置中，几乎不会自动执行任何操作。 但是，借助随附的插件生态系统，很容易扩展RAML使其表现出所需的行为。

该文档框架的生态系统非常活跃，其插件启用了各种功能，例如ÿ