【发布时间】：2018-04-27 06:08:51
【问题描述】：
我刚刚实现了与 spring-data-rest 捆绑的 HAL 浏览器。它可以从我的 API 根目录访问并且工作正常。但我发现没有办法定制任何关于它的东西。是否可以更改主要用于生产用途的浏览器外观和感觉？也可以把它放在不同的网址上吗？是否建议首先用于生产？我正在使用 Spring Boot 2.0。
【问题讨论】：
标签： spring-boot spring-data-rest
【发布时间】：2018-04-27 06:08:51
【问题描述】：
我不建议在生产环境中启用 HAL 浏览器。你为什么需要它？它是一种在浏览器中轻松遍历 HATEOAS API 的工具。您可以在开发/测试环境中使用它。生产 API 可以参考 Postman、Insomnia 之类的工具。
话虽如此，可以修改 HAL 浏览器的外观。所有与 HAL 浏览器相关的 Web 文件都位于 META-INF/spring-data-rest/hal-browser。要修改这些文件中的任何一个，您可以通过在 src/main/resources 目录中创建相同的文件夹结构来覆盖它们，复制您要修改的文件并更新它。
【讨论】：
-
业务需求需要完整的 REST API 文档，而使用 Postman/Insomnia 并不是我想要的 API 文档。 HAL 浏览器与 Swagger 非常相似，但我不确定 Swagger 是否可以像 HAL 浏览器那样直接与 HATEOAS API 集成。是否有任何替代方法来记录 HATEOAS API？
-
我会推荐 Spring Rest Docs 获取 HATEOAS API 的 API 文档。它与 Spring MockMvc 很好地集成，并为您提供与测试紧密集成的体面的文档。我不会推荐 Swagger，因为它本质上与 HATEOAS 的原则相反。 API 文档也不一定需要支持主动 API 调用。
-
谢谢，会调查的。