19

我想定义请求和响应模型。我将无服务器框架与 AWS 一起使用，我看到的所有内容都建议使用serverless-aws-documentation

自述文件说我需要在其中加入这一行custom.documentation.models.MODELNAME

schema: ${file(models/error.json)}

但是他们没有models/error.json用作基准的示例文件。

在实际示例serverless.yml中，它们的定义如下：

-
  name: DoSomethingRequest
  contentType: "application/json"
  schema:
    type: array
    items:
      type: string

这没有为我正在尝试做的事情提供足够的细节。

我的目标是为字符串对象数组、消息和状态码定义一个模式。但是，消息和状态代码是可选的。这些也可能是其他模型的一部分，如果可能的话，我不想对每个模型重复它们的定义。

我目前的尝试是：

-
  name: ReturnArrayResponse
  contentType: "application/json"
  schema:
    type: array
    itemsArray:
      type: string
    message:
      type: string
    statusCode:
      type: number

我认为这会做我想做的事，但我怎么能拥有message并且statusCode是可选的并在我的其他模型中重复这两个项目？

我对可以放入 serverless.yml 文件的 yml 解决方案或可以引用的 json 文件感到满意。

4

2 回答 2

5

包括一个文件

在给出的示例中，error.json可以包含任何有效的模式。所以像这样简单的事情就可以了：

{"type":"object","properties":{"message":{"type":"string"}}}

$schema包含和之类的属性也很好title：

{
  "$schema" : "http://json-schema.org/draft-04/schema#",
  "title" : "Error Schema",
  "type" : "object",
  "properties" : {
    "message" : { "type" : "string" },
    "statusCode": { "type": "number" },
    "itemsArray": {
        "type": "array",
        "items": {
            "type": "string"
        }
    }
  }
}

当您已经在 AWS 中定义了模型但没有无服务器 yaml 来构建它们时，这尤其方便。您可以简单地将架构复制出 AWS 控制台，将 json 粘贴到文件中，然后使用schema: ${file()}问题中提到的语法。据我所知，您可以让 AWS 控制台接受的任何内容都可以。

干燥

我不知道如何从无服务器文件中的其他模型中引用模型，但您可以使用与插件作者相同的方法，只需将需要重用的任何内容models放在更容易重用的地方。插件作者使用commonModelSchemaFragments.

所以如果你有一些像这样的片段：

  commonModelSchemaFragments:
    # defining common fragments means you can reference them with a single line
    StringArrayFragment:
        type: array
        items:
          type: string
    HttpResponse:
      type: object
      properties:
        message:
          type: string
        statusCode:
          type: number

您可以像这样在模型中引用这些片段：

  - 
    name: HttpStatusResponse
    contentType: "application/json"
    schema:
      type: object
      properties:
          serverResponse: 
            ${self:custom.commonModelSchemaFragments.HttpResponse}
          messageArray: 
            ${self:custom.commonModelSchemaFragments.StringArrayFragment}

标记属性可选

您可以通过将属性标记为 来完成此操作required。只需提供所有属性的列表，除了您希望成为optional的那些。它的 json 模式如下所示：

{
    "type": "object",
    "required": ["message"],
    "properties": {
        "optionalMessage": {
            "type": "string"
        },
        "message": {
            "type": "string"
        }
    }
}

您可以在无服务器文件中使用这样的 yaml 来构建它：

  -
    name: OptionalResponse
    contentType: "application/json"
    schema:
      type: object
      required: 
      - "message"
      properties:
        message:
          type: string
        optionalMessage:
          type: string

关于请求验证的说明

标记属性required或optional仅在打开请求正文验证时才重要：

AWS 控制台中的请求正文验证选项

我不知道使用任何特殊的无服务器语法打开请求验证的方法。看起来您可以在该resources部分中执行此操作，但我还没有尝试过。 来源。

于 2017-11-23T23:08:23.683 回答
1

只是一个猜测（将其发布为保留格式的答案）-您在架构中的顶级实体应该是 an object，而不是 an array，如下所示：

    schema:
      type: object
      properties:
        items:
          type: array
          items:
            type: string
        message:
          type: string
        statusCode:
          type: number
于 2017-11-22T15:03:57.930 回答