1

Flask-RESTful基于 API 中,我希望允许客户端通过参数部分检索 JSON 响应。?fields=...它列出了字段名称(JSON 对象的键),这些名称将用于构造较大原始文件的部分表示。

这可能是最简单的形式,一个逗号分隔的列表:

GET /v1/foobar?fields=name,id,date

这可以通过 webargs 的DelimitedList模式字段轻松完成,对我来说没有问题。


但是,为了允许嵌套对象的键被表示,分隔的字段列表可以包括用匹配括号括起来的任意嵌套键:

GET /v1/foobar?fields=name,id,another(name,id),date
{
  "name": "",
  "id": "",
  "another": {
    "name": "",
    "id": ""
  },
  "date": ""
}
GET /v1/foobar?fields=id,one(id,two(id,three(id),date)),date
{
  "id": "",
  "one": {
    "id: "",
    "two": {
      "id": "",
      "three": {
        "id": ""
      },
      "date": ""
    }
  },
  "date": ""
}
GET /v1/foobar?fields=just(me)
{
  "just": {
    "me: ""
  }
}

我的问题有两个:

  1. 有没有办法用原生方式做到这一点(验证和反序列化webargsmarshmallow

  2. 如果没有,我将如何使用解析框架来做到这一点pyparsing?任何关于 BNF 语法应该是什么样子的提示都非常感谢。

4

1 回答 1

1

Pyparsing 有几个有用的内置插件,delimitedList并且nestedExpr. 这是一个带注释的片段,可为您的值构建解析器。(我还包括了一个示例,其中您的列表元素可能不仅仅是简单的字母单词):

import pyparsing as pp

# placeholder element that will be used recursively
item = pp.Forward()

# your basic item type - expand as needed to include other characters or types
word = pp.Word(pp.alphas + '_')
list_element = word

# for instance, add support for numeric values
list_element = word | pp.pyparsing_common.number

# retain x(y, z, etc.) groupings using Group
grouped_item = pp.Group(word + pp.nestedExpr(content=pp.delimitedList(item)))

# define content for placeholder; must use '<<=' operator here, not '='
item <<= grouped_item | list_element

# create parser
parser = pp.Suppress("GET /v1/foobar?fields=") + pp.delimitedList(item)

您可以使用以下命令测试任何 pyparsing 表达式runTests

parser.runTests("""
    GET /v1/foobar?fields=name,id,date
    GET /v1/foobar?fields=name,id,another(name,id),date
    GET /v1/foobar?fields=id,one(id,two(id,three(id),date)),date
    GET /v1/foobar?fields=just(me)
    GET /v1/foobar?fields=numbers(1,2,3.7,-26e10)    
    """,  fullDump=False)

给出:

GET /v1/foobar?fields=name,id,date
['name', 'id', 'date']
GET /v1/foobar?fields=name,id,another(name,id),date
['name', 'id', ['another', ['name', 'id']], 'date']
GET /v1/foobar?fields=id,one(id,two(id,three(id),date)),date
['id', ['one', ['id', ['two', ['id', ['three', ['id']], 'date']]]], 'date']
GET /v1/foobar?fields=just(me)
[['just', ['me']]]
GET /v1/foobar?fields=numbers(1,2,3.7,-26e10)
[['numbers', [1, 2, 3.7, -260000000000.0]]]
于 2020-03-16T13:13:19.067 回答