Swagger-ui: Support oneOf

Created on 20 Mar 2015 · 8Comments · Source: swagger-api/swagger-ui

I used a oneOf and it rendered as an empty object. It seems to be ignored right now.

Source

nickretallack

All 8 comments

oneOf is not supported by the Swagger specification.

webron on 26 Mar 2015

Not even in the part where it delegates to jsonschema?

nickretallack on 27 Mar 2015

Not anywhere. We don't delegate to JSON Schema. The spec is very specific about it. We use an extended subset of JSON Schema, and explicitly don't support oneOf.

webron on 27 Mar 2015

😕9 👎8

Unfortunately no. It uses a subset of the draft-4.
You could adapt the swagger-client.js by adding an extra model type and resolve it accordingly.

hansbeld on 27 Mar 2015

Just curious. Why was oneOf explicitly not supported?

willshulman on 23 Apr 2015

@willshulman - https://github.com/swagger-api/swagger-spec/issues/57

webron on 24 Apr 2015

This way something like defining a tree structure is not possible ..... Really bad news (Thought Swagger is good, but - oh, well ....)

E.g.

    "ModelFolder": {
        "properties": {
            "id": {
                "type": "number",
                "format": "integer"
            },
            "parentId": {
                "type": "number",
                "format": "integer"
            },
            "name": {
                "type": "string"
            },
            "itemType": {
                "type": "string"
            },
            "children": {
                "type": "array",
                "items": {
                    "anyOf":[
                        { "$ref": "#/definitions/ModelFolder"  },
                        { "$ref": "#/definitions/Model" }
                    ]
                }
            }
        },
    "Model": {
        "properties": {
            "id": {
                "type": "number",
                "format": "integer"
            },
            "parentId": {
                "type": "number",
                "format": "integer"
            },
            "name": {
                "type": "string"
            },
            "itemType": {
                "type": "string"
            }
        }

is not possible ?!?!?!?

I don't get it (Please be more pragmatic. But maybe its technically simply not doable in the Swagger implementation).