我们使用Swagger editor为我们的API规范创建了一个Yaml文件,其中包括基本URL,端点,请求,响应和标头信息等。现在我想为这些API实现RESTful Web服务。为此,我正在考虑从这个Yaml文件生成我的Request和Response Java类,并且正在寻找某种代码生成器,最好是我可以在我的Maven项目中使用的maven插件/依赖项。我遇到了rest client with swagger,其中讨论了如何使用swagger-codegen Maven plugin,但这是为了生成client
我认为是生成客户端代码以使用这些RESTful API,但我需要的是生成用于服务实现的类。我将使用Java和Spring框架。
我的问题是,当我们有Yaml文件(使用Swagger编辑器创建的API规范)以及可以使用哪些代码生成工具/插件时,在Java中实现RESTful Web服务的最佳实践是什么。
编辑:刚刚遇到这个Server stub generator HOWTO,进一步研究它。
答案 0 :(得分:5)
Swagger-codegen maven插件是一个不错的选择,但我建议你使用jhipster生成你的java项目。它使用包括spring框架在内的最新技术堆栈生成项目。您可以在案例中选择API-First development。我使用它,它非常有效。你已经有了Yaml文件。将其放入src/main/resources/swagger/api.yml
并运行
./mvnw generate-sources
将生成所有Java代码。