Packages

  • package root
    Definition Classes
    root
  • package endpoints
    Definition Classes
    root
  • package openapi

    Interpreters producing an OpenAPI model of endpoints.

    Interpreters producing an OpenAPI model of endpoints.

    Definition Classes
    endpoints
  • trait JsonSchemas extends algebra.JsonSchemas with TuplesSchemas

    An interpreter for endpoints.algebra.JsonSchemas that produces a JSON schema for a given algebraic data type description.

    An interpreter for endpoints.algebra.JsonSchemas that produces a JSON schema for a given algebraic data type description.

    The encoding of the schemas of sealed traits (obtained with the operation orElse or via generic derivation) can be configured by overriding JsonSchemas.coproductEncoding.

    Definition Classes
    openapi
  • object CoproductEncoding

    This object contains the options for how to encode coproduct JSON schemas.

    This object contains the options for how to encode coproduct JSON schemas.

    The following Scala coproduct is the candidate example. Each encoding option includes the schema that it would generate for that example.

    sealed trait Pet
    case class Cat(name: String) extends Pet
    case class Lizard(lovesRocks: Boolean) extends Pet
    Definition Classes
    JsonSchemas
  • OneOf
  • OneOfWithBaseRef

object OneOf extends CoproductEncoding with Product with Serializable

Strategy defining the base type schema in terms of oneOf and the variant schemas. The variants themselves don't refer to the base type, but they do include the discriminator field.

  • simpler looking schemas in Swagger UI
  • some OpenAPI clients don't handle oneOf properly

Using the Pet example above, this strategy yields the following:

"schemas": {
  "Pet": {
    "oneOf": [
      { "$ref": "#/components/schemas/Cat" },
      { "$ref": "#/components/schemas/Lizard" }
    ],
    "discriminator": {
      "propertyName": "type",
      "mapping": {
        "Cat": "#/components/schemas/Cat",
        "Lizard": "#/components/schemas/Lizard"
      }
    }
  },

  "Cat": {
    "type": "object",
    "properties": {
      "type": {
        "type": "string",
        "enum": [ "Cat" ]
      },
      "name": {
        "type": "string"
      }
    },
    "required": [
      "type",
      "name"
    ]
  },

  "Lizard": {
    "type": "object",
    "properties": {
      "type": {
        "type": "string",
        "enum": [ "Lizard" ]
      },
      "lovesRocks": {
        "type": "boolean"
      }
    },
    "required": [
      "type",
      "lovesRocks"
    ]
  }
}
Source
JsonSchemas.scala
Linear Supertypes
Ordering
  1. Alphabetic
  2. By Inheritance
Inherited
  1. OneOf
  2. Serializable
  3. Product
  4. Equals
  5. CoproductEncoding
  6. AnyRef
  7. Any
  1. Hide All
  2. Show All
Visibility
  1. Public
  2. Protected

Value Members

  1. final def !=(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  2. final def ##(): Int
    Definition Classes
    AnyRef → Any
  3. final def ==(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  4. final def asInstanceOf[T0]: T0
    Definition Classes
    Any
  5. def clone(): AnyRef
    Attributes
    protected[lang]
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.CloneNotSupportedException]) @native()
  6. final def eq(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef
  7. def equals(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef → Any
  8. def finalize(): Unit
    Attributes
    protected[lang]
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.Throwable])
  9. final def getClass(): Class[_ <: AnyRef]
    Definition Classes
    AnyRef → Any
    Annotations
    @native()
  10. final def isInstanceOf[T0]: Boolean
    Definition Classes
    Any
  11. final def ne(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef
  12. final def notify(): Unit
    Definition Classes
    AnyRef
    Annotations
    @native()
  13. final def notifyAll(): Unit
    Definition Classes
    AnyRef
    Annotations
    @native()
  14. def productElementName(n: Int): String
    Definition Classes
    Product
  15. def productElementNames: Iterator[String]
    Definition Classes
    Product
  16. final def synchronized[T0](arg0: => T0): T0
    Definition Classes
    AnyRef
  17. final def wait(): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.InterruptedException])
  18. final def wait(arg0: Long, arg1: Int): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.InterruptedException])
  19. final def wait(arg0: Long): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws(classOf[java.lang.InterruptedException]) @native()

Inherited from Serializable

Inherited from Product

Inherited from Equals

Inherited from CoproductEncoding

Inherited from AnyRef

Inherited from Any

Ungrouped