python - Flask-Restplus：如何建模字符串或对象？

Question

在 Flask-Restplus 中，我需要对可能是字符串列表或对象列表的属性值进行建模。

那就是它看起来像这样：

{
    'my_attribute': [
         'value1',
          'value2'
     ]
}

或者它可能如下所示：

{
    'my_attribute': [
        {
             'name': 'value1',
              'foo': 'something'
         },
         {
              'name': 'value2',
               'foo': 'something else'
          }
     ]
}

我应该如何在 Flask-Restplus' 中建模api.model？

Answer 1

我自己才弄清楚这一点。简而言之，创建一个自定义字段类来发出自己的 JSON 模式。反过来，模式使用oneOf类型来指定它是字符串还是对象。

from flask_restplus import fields

element_object = api.model('Element_Object', {
    'name': fields.String(),
    'foo': fields.String()
})

class StringOrObjectElement(fields.Nested):
    __schema_type__ = ['string','object']

    def output(self, key, obj):
        if isinstance(obj, str):
            if key == 'name':
                return obj
            else:
                return 'default_value'
        return super().output(key, obj)

    def schema(self):
        schema_dict = super().schema()
        schema_dict.pop('type')
        nested_ref = schema_dict.pop('$ref')
        schema_dict['oneOf'] = [
            {
                'type': 'string'
            },
            {
                '$ref': nested_ref
            }
        ]
        return schema_dict

root_object = api.model('Root_Object', {
    'my_attribute': fields.List(fields.StringOrObjectElement(element_object))