Function TypeSchemaWithPrefix

http/codegen/openapi/json_schema.go:315–399

TypeSchemaWithPrefix produces the JSON schema corresponding to the given data type and adds the provided prefix to the type name

(api *expr.APIExpr, t expr.DataType, prefix string)

// TypeSchemaWithPrefix produces the JSON schema corresponding to the given data type
// and adds the provided prefix to the type name
func TypeSchemaWithPrefix(api *expr.APIExpr, t expr.DataType, prefix string) *Schema {
	s := NewSchema()
	switch actual := t.(type) {
	case expr.Primitive:
		s.Type = Type(actual.Name())
		switch actual.Kind() {
		case expr.AnyKind:
			// A schema without a type matches any data type.
			// See https://swagger.io/docs/specification/data-models/data-types/#any.
			s.Type = Type("")
		case expr.IntKind, expr.Int64Kind,
			expr.UIntKind, expr.UInt64Kind:
			// Use int64 format for IntKind and UIntKind because the OpenAPI
			// generator produced int32 by default.
			s.Type = Type("integer")
			s.Format = "int64"
		case expr.Int32Kind, expr.UInt32Kind:
			s.Type = Type("integer")
			s.Format = "int32"
		case expr.Float32Kind:
			s.Type = Type("number")
			s.Format = "float"
		case expr.Float64Kind:
			s.Type = Type("number")
			s.Format = "double"
		case expr.BytesKind:
			s.Type = Type("string")
			s.Format = "byte"
		}
	case *expr.Array:
		s.Type = Array
		s.Items = NewSchema()
		buildAttributeSchema(api, s.Items, actual.ElemType)
	case *expr.Object:
		s.Type = Object
		for _, nat := range *actual {
			if !MustGenerate(nat.Attribute.Meta) {
				continue
			}
			prop := NewSchema()
			buildAttributeSchema(api, prop, nat.Attribute)
			s.Properties[nat.Name] = prop
		}
	case *expr.Map:
		s.Type = Object
		if actual.KeyType.Type == expr.String && actual.ElemType.Type != expr.Any {
			// Use free-form objects when elements are of type "Any"
			additionalProperties := NewSchema()
			s.AdditionalProperties = buildAttributeSchema(api, additionalProperties, actual.ElemType)
		} else {
			s.AdditionalProperties = true
		}
	case *expr.Union:
		// Unions are represented as an object with a discriminated value.
		// The field names are configurable via Meta tags (defaults: "type" and "value").
		typeKey := actual.GetTypeKey()
		valueKey := actual.GetValueKey()