Swager模型架构不包括主体参数的变量名

Question

在我的应用程序的 Swagger UI 中，我有 POST 和 PUT 方法，它们都将 POJO 作为 REST 调用中的主体参数。当我查看 UI 并单击模型架构以自动填充参数框（只是为了节省键入整个 JSON 的时间）时，它不包含参数的名称，因此请求失败。例：

模型架构:

{ 
   "first": "string",
   "last": "string",
   "address": "string",
   "email": "string",
   .
   .
   .
}

但是，要发出请求，我需要包含参数名称条目，如下所示：

{ "entry": {
   "first": "string",
   "last": "string",
   "address": "string",
   "email": "string",
   .
   .
   .
}}

虽然在发出请求之前自己做这件事并不太不方便，但它给其他使用Swagger UI的开发人员带来了问题，他们没有意识到他们需要添加条目。有没有办法修改模型模式？

Answer 1

参数的名称不用作bodyparameter中的属性。为了描述您的模型，您可以使用对象类型定义entryproperty，如下所示：

definitions:
  Entry:
    type: object
    properties:
      entry:
        type: object
        properties:
          first: 
            type: string
          last:
            type: string
          address:
            type: string
          email:
            type: string

您可以将其用作身体模式，如下所示：

post:
  produces:
    - application/json
  parameters:
    - name: body
      in: body
      schema:
        $ref: '#/definitions/Entry'