0

我是 Java 中 FHIR 的新手。

我注意到这个库非常重......它为所有 REST 端点定义了自己的注释 - 例如:它有 @Search 而不是 @GetMapping,以及 @Create 而不是 @PostMapping。它有自己的 JSON 解析器,显然不支持杰克逊——基本上是在重新发明轮子。

我已经习惯了新服务的简单设置——使用 springdoc-openapi-ui 和 RestControllers。

这有一个巨大的优势,因为它会自动建立一个招摇页面来与 API 交互。

ETC:

http://localhost:8080/swagger-ui.html

OpenAPI 3.0 json 将在运行时以 /v3/api-docs 相对 URI 路径提供。

不幸的是,据我所知,没有办法让 springdoc-openapi-ui 与 FHIR 一起工作......我已经搜索了他们的所有文档,但还没有找到任何东西。我发现最接近的是 r5 服务器库有一个 OpenApiGenerator:

https://hapifhir.io/hapi-fhir/apidocs/hapi-fhir-structures-r5/org/hl7/fhir/r5/openapi/package-summary.html

广泛搜索 Google 和 FHIR 文档并没有找到任何我能找到的关于如何使用 openapi 生成器的示例。我还需要了解如何让这些 @Search 或 @Create API 显示在 swagger-ui.html 页面中(如果可能的话)。由于此 UI 是从 spring-doc 库生成的 openapi 3.0 json 自动生成的,因此您可以从 /v3/api-docs/ 端点检索,该端点也是在运行时创建的。

感谢您提供有关使用 FHIR 端点的 openapi 的任何信息,以及是否可以使其与现有的行业标准 springdoc 库一起使用。

4

0 回答 0