swagger:discriminated

Marks an embedded type as a member for allOf and sets the x-class value. On interface definitions there is another annotation on methods allowed swagger:name

The swagger:allOf annotation can be followed by a string. This string will be the value for the x-class vendor extension. This value is used as constant for the discriminator field.

An interface that is embedded expects to have 1 method that is commented with Discriminator: true. That field will be used as discriminator field when marshalling/unmarshalling objects.

Because this is for use with interfaces we can't make use of the json struct tag to allow for spec name overriding. So instead you can annotate method names on an interface with swagger:name and a value this will then provide the json field name.

Syntax:

swagger:allOf org.example.something.TypeName

Example:

// TeslaCar is a tesla car
//
// swagger:model
type TeslaCar interface {
    // The model of tesla car
    //
    // discriminator: true
    // swagger:name model
    Model() string

    // AutoPilot returns true when it supports autopilot
    // swagger:name autoPilot
    AutoPilot() bool
}

// The ModelS version of the tesla car
//
// swagger:model modelS
type ModelS struct {
    // swagger:allOf com.tesla.models.ModelS
    TeslaCar
    // The edition of this Model S
    Edition string `json:"edition"`
}

// The ModelX version of the tesla car
//
// swagger:model modelX
type ModelX struct {
    // swagger:allOf com.tesla.models.ModelX
    TeslaCar
    // The number of doors on this Model X
    Doors int32 `json:"doors"`
}

Result:

---
definitions:
  TeslaCar:
    title: TeslaCar is a tesla car
    type: object
    discriminator: "model"
    properties:
      model:
        description: The model of tesla car
        type: string
        x-go-name: Model
      autoPilot:
        description: AutoPilot returns true when it supports autopilot
        type: integer
        format: int32
        x-go-name: AutoPilot
  modelS:
    allOf:
      - $ref: "#/definitions/TeslaCar"
      - title: The ModelS version of the tesla car
        properties:
          edition:
            description: "The edition of this model S"
            type: string
            x-go-name: Edition
    x-class: "com.tesla.models.ModelS"
    x-go-name: "ModelX"
  modelX:
    allOf:
      - $ref: "#/definitions/TeslaCar"
      - title: The ModelX version of the tesla car
        properties:
          doors:
            description: "The number of doors on this Model X"
            type: integer
            format: int32
            x-go-name: Doors
    x-class: "com.tesla.models.ModelX"
    x-go-name: ModelX