带有 Swagger UI 的 Apache Wicket REST

Posted 2023-02-16

【中文标题】带有 Swagger UI 的 Apache Wicket REST

【英文标题】：Apache Wicket REST with Swagger UI

【发布时间】：2022-01-12 14:13:03

【问题描述】：

我的一个项目正在使用 Apache Wicket 6.x，我有一些使用 wicketstuff-rest 的 API（资源），它运行良好。

但是对于我的 API 文档，我正在为这些 API 维护一个谷歌文档。问题是，每当任何 API 甚至新 API 发生变化时……我都需要更新这个 API 文档。很有可能，此文档可能不会更新。

在我的其他springboot项目中，我使用的是swagger，API文档可以通过swagger-ui查看。

我想知道我是否可以将 swagger-ui 与现有的 apache wicket 6.x 项目一起使用，以便每当有新的 API 或现有 API 的任何更改时......它都会反映在 swagger-ui无需维护任何 API 文档。

我目前搜索的是 swagger2markup，但这似乎很旧，而且我在设置方面遇到问题，而且关于如何设置的资源很少。

任何成功设置 swagger-ui 和 apache wicket rest 的人？

愿意分享有关教程的资源/链接或如何在 apache wicket rest 上设置 swagger-ui？

谢谢！

【参考方案1】：

我没有使用 Swagger 为您提供简单的解决方案，但如果您已经使用 Spring，那么您可以使用 Spring REST Docs 从单元测试中生成文档。