当前位置: 首页 > 知识库问答 >
问题:

手动描述Swagger输入/输出模型(没有Java域类)

徐英锐
2023-03-14

我们有一个带有Spring MVC的现有REST API版本。我们现在正在飙升,看看我们是否可以使用Swagger(快速)生成内部文档。

我们的 REST 实现的问题在于,我们确实使用 Spring MVC 将业务对象转换为 json,但是我们有自定义的 json 转换器,它们基本上从业务对象创建 Jettison json 对象(键/值)。不幸的是,目前没有办法改变这一点。顺便说一句,输入也是如此。它基本上总是我们发送给客户端的哈希映射。

因为我们可以使用Springfox生成控制器和它的方法是一个很好的开始。但是我们也想记录输入/输出。有没有办法使用Swagger注释手动记录输入/输出模型而不引用Java域类?

另一种选择是,我们完全编写自己的低层Swagger规范,或者研究其他解决方案。

共有1个答案

张承颜
2023-03-14

为什么不使用spring rest-docs?我认为当你的服务模型不是真正的强类型时,这正是你可能需要的。它有几个优点

    < li >您可以为每个endpoint编写测试 < li >模型将始终反映现实,而不是有办法从外部描述您的模型并将其提供给springfox基础架构。 < li >如果模型是外部提供的,无论如何,如果没有某种测试,就不可能跟上现实的变化。

这可能不是你所能控制的,这就是为什么你会有这个问题,但是重申一个显而易见的选择是让你的模型反映客户的期望,而不是松散的json-key-value转换。

 类似资料:
  • 模板输出 模型数据的模板输出可以直接把模型对象实例赋值给模板变量,在模板中可以直接输出,例如: <?php namespace app\index\controller; use app\index\model\User; use think\Controller; class Index extends Controller { public function index()

  • 我训练了一个模型,输入了张量:输入形状:[150]输入类型: 在输出中,该张量为:输出形状:[1 50 17]输出类型: 如何在Java中创建这些?在Android设备上使用它?谢谢

  • 最终目标是我想在本地运行一个功能应用程序进行自动化测试。我不知道如何在不使用的情况下做到这一点。这是我的尝试: 这在输出时失败 未设置工作运行时。自2.0.1β。26需要工作运行时设置。请运行<code>函数设置添加函数_WORKER_RUNTIME Azure Functions核心工具(2.6.666提交哈希:2ea98edb55cd2fc249765fcf3f5e30829c7c9932)函

  • 由于某些原因,在运行此代码时,我没有得到输出。我不明白为什么。我肯定这是基本的原因,但在我看来一切都是正确的。 下面是输出:

  • 本小节将会介绍基本输入输出的 Java 标准类,通过本小节的学习,你将了解到什么是输入和输入,什么是流;输入输出流的应用场景,File类的使用,什么是文件,Java 提供的输入输出流相关 API 等内容。 1. 什么是输入和输出(I / O) 1.1 基本概念 输入/输出这个概念,对于计算机相关专业的同学并不陌生,在计算中,输入/输出(Input / Output,缩写为 I / O)是信息处理系

  • 我试图用Swagger来描述我正在构建的web-api。问题是我无法理解如何描述复杂的json对象? 比如如何描述这个对象: