スワッガーコントラクトのoneOfと$ refを使用してJSONschemを定義します。

Question

私はスージー契約を書いていますが、私のデータモデルはJSONSchemasで定義されています。

私のモデルを作成した後、私はそれらのモデルをすばらしいUIでテストしています。今、私は参考のために 'oneOf'を使うのに問題があります。続くように...

... 
"socio":{ 
      "type":{ 
       "oneOf":[ 
        { 
         "properties":{ 
           "pessoaFisica":{ 
           //"pessoaFisica": "object", 
           "$ref":"http://soa-mds/XXXXXX/apps/SOA/JSONSchemas/Corporativo/pessoaFisica.json" 
          }, 
          "pessoaJuridica":{ 
            //"pessoaJuridica": "object", 
           "$ref":"http://soa-mds/dataprev.gov.br/apps/SOA/JSONSchemas/Corporativo/pessoaJuridica.json" 
          }, 
          "estrangeiro":{ 
           //"estrangeiro": "object", 
           "$ref":"http://soa-mds/XXXXXX/apps/SOA/JSONSchemas/Corporativo/estrangeiro.json" 
          } 
         } 
        }   
       ] 
      } 
     }   
    }, 
.... 

私は研究の後、$ refでoneOFを使用する正しい方法を見つけません。

誰でも助けてくれますか？

おかげで、 MMR

Answer 1

oneOfの正しい構文は次のとおりです。

"socio": { 
    "oneOf": [ 
     { 
     "$ref": "http://soa-mds/XXXXXX/apps/SOA/JSONSchemas/Corporativo/pessoaFisica.json" 
     }, 
     { 
     "$ref": "http://soa-mds/dataprev.gov.br/apps/SOA/JSONSchemas/Corporativo/pessoaJuridica.json" 
     }, 
     { 
     "$ref": "http://soa-mds/XXXXXX/apps/SOA/JSONSchemas/Corporativo/estrangeiro.json" 
     } 
    ] 
    } 

は、あなたのスペックは "openapi": "3.0.0"ない "swagger": "2.0"を使用していることを確認します（ oneOfのみOpenAPIの3.0でサポートされています）。

すべての参照スキーマは、OpenAPI Schema objectと互換性がなければなりません。 OpenAPIスキーマオブジェクトはJSONスキーマに基づいていますが、OpenAPIの一部のJSONスキーマキーワードwork differentlyと一部のキーワード（idおよびpatternPropertiesなど）はサポートされていません。