如何將 HAL JSON 轉換為 OpenAPI JSON 以生成 JavaScript 客戶端 API

Question

我們有一個生成 HAL JSON 的 Spring Data Rest 項目。 我們希望基於 HAL JSON 自動生成 JavaScript 客戶端 API。 我們可以非常簡單地使用 OpenAPITools/openapi-generator 將 OpenAPI JSON 轉換為 JS 客戶端 API，但是我們一直無法找到類似的 HAL JSON 工具。 作為一種解決方法，我們正在探索將 HAL JSON 轉換為 OpenAPI JSON 以利用 OpenAPITools/openapi-generator 項目。

是否存在 HAL JSON 到 OpenAPI JSON 轉換器？

是否有 HAL JSON 到 JavaScript 客戶端 API 生成器？

有沒有辦法跳過 HAL JSON 步驟並從 Spring Data Repository 類生成 OpenAPI JSON？

Answer 1

要啟用對 spring-data-rest 類型的支持：@RepositoryRestResource 和 QuerydslPredicate 注釋，您應該使用：

<dependency>
      <groupId>org.springdoc</groupId>
      <artifactId>springdoc-openapi-data-rest</artifactId>
      <version>1.4.8</version>
</dependency> 

您可以在此處獲得演示：

• https://github.com/springdoc/springdoc-openapi-demos/tree/master/sample-springdoc-openapi-data-rest