| // Copyright 2015 go-swagger maintainers |
| // |
| // Licensed under the Apache License, Version 2.0 (the "License"); |
| // you may not use this file except in compliance with the License. |
| // You may obtain a copy of the License at |
| // |
| // http://www.apache.org/licenses/LICENSE-2.0 |
| // |
| // Unless required by applicable law or agreed to in writing, software |
| // distributed under the License is distributed on an "AS IS" BASIS, |
| // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| // See the License for the specific language governing permissions and |
| // limitations under the License. |
| |
| package spec |
| |
| import ( |
| "encoding/json" |
| "strings" |
| |
| "github.com/go-openapi/jsonpointer" |
| "github.com/go-openapi/swag" |
| ) |
| |
| type SimpleSchema struct { |
| Type string `json:"type,omitempty"` |
| Format string `json:"format,omitempty"` |
| Items *Items `json:"items,omitempty"` |
| CollectionFormat string `json:"collectionFormat,omitempty"` |
| Default interface{} `json:"default,omitempty"` |
| Example interface{} `json:"example,omitempty"` |
| } |
| |
| func (s *SimpleSchema) TypeName() string { |
| if s.Format != "" { |
| return s.Format |
| } |
| return s.Type |
| } |
| |
| func (s *SimpleSchema) ItemsTypeName() string { |
| if s.Items == nil { |
| return "" |
| } |
| return s.Items.TypeName() |
| } |
| |
| type CommonValidations struct { |
| Maximum *float64 `json:"maximum,omitempty"` |
| ExclusiveMaximum bool `json:"exclusiveMaximum,omitempty"` |
| Minimum *float64 `json:"minimum,omitempty"` |
| ExclusiveMinimum bool `json:"exclusiveMinimum,omitempty"` |
| MaxLength *int64 `json:"maxLength,omitempty"` |
| MinLength *int64 `json:"minLength,omitempty"` |
| Pattern string `json:"pattern,omitempty"` |
| MaxItems *int64 `json:"maxItems,omitempty"` |
| MinItems *int64 `json:"minItems,omitempty"` |
| UniqueItems bool `json:"uniqueItems,omitempty"` |
| MultipleOf *float64 `json:"multipleOf,omitempty"` |
| Enum []interface{} `json:"enum,omitempty"` |
| } |
| |
| // Items a limited subset of JSON-Schema's items object. |
| // It is used by parameter definitions that are not located in "body". |
| // |
| // For more information: http://goo.gl/8us55a#items-object |
| type Items struct { |
| Refable |
| CommonValidations |
| SimpleSchema |
| VendorExtensible |
| } |
| |
| // NewItems creates a new instance of items |
| func NewItems() *Items { |
| return &Items{} |
| } |
| |
| // Typed a fluent builder method for the type of item |
| func (i *Items) Typed(tpe, format string) *Items { |
| i.Type = tpe |
| i.Format = format |
| return i |
| } |
| |
| // CollectionOf a fluent builder method for an array item |
| func (i *Items) CollectionOf(items *Items, format string) *Items { |
| i.Type = "array" |
| i.Items = items |
| i.CollectionFormat = format |
| return i |
| } |
| |
| // WithDefault sets the default value on this item |
| func (i *Items) WithDefault(defaultValue interface{}) *Items { |
| i.Default = defaultValue |
| return i |
| } |
| |
| // WithMaxLength sets a max length value |
| func (i *Items) WithMaxLength(max int64) *Items { |
| i.MaxLength = &max |
| return i |
| } |
| |
| // WithMinLength sets a min length value |
| func (i *Items) WithMinLength(min int64) *Items { |
| i.MinLength = &min |
| return i |
| } |
| |
| // WithPattern sets a pattern value |
| func (i *Items) WithPattern(pattern string) *Items { |
| i.Pattern = pattern |
| return i |
| } |
| |
| // WithMultipleOf sets a multiple of value |
| func (i *Items) WithMultipleOf(number float64) *Items { |
| i.MultipleOf = &number |
| return i |
| } |
| |
| // WithMaximum sets a maximum number value |
| func (i *Items) WithMaximum(max float64, exclusive bool) *Items { |
| i.Maximum = &max |
| i.ExclusiveMaximum = exclusive |
| return i |
| } |
| |
| // WithMinimum sets a minimum number value |
| func (i *Items) WithMinimum(min float64, exclusive bool) *Items { |
| i.Minimum = &min |
| i.ExclusiveMinimum = exclusive |
| return i |
| } |
| |
| // WithEnum sets a the enum values (replace) |
| func (i *Items) WithEnum(values ...interface{}) *Items { |
| i.Enum = append([]interface{}{}, values...) |
| return i |
| } |
| |
| // WithMaxItems sets the max items |
| func (i *Items) WithMaxItems(size int64) *Items { |
| i.MaxItems = &size |
| return i |
| } |
| |
| // WithMinItems sets the min items |
| func (i *Items) WithMinItems(size int64) *Items { |
| i.MinItems = &size |
| return i |
| } |
| |
| // UniqueValues dictates that this array can only have unique items |
| func (i *Items) UniqueValues() *Items { |
| i.UniqueItems = true |
| return i |
| } |
| |
| // AllowDuplicates this array can have duplicates |
| func (i *Items) AllowDuplicates() *Items { |
| i.UniqueItems = false |
| return i |
| } |
| |
| // UnmarshalJSON hydrates this items instance with the data from JSON |
| func (i *Items) UnmarshalJSON(data []byte) error { |
| var validations CommonValidations |
| if err := json.Unmarshal(data, &validations); err != nil { |
| return err |
| } |
| var ref Refable |
| if err := json.Unmarshal(data, &ref); err != nil { |
| return err |
| } |
| var simpleSchema SimpleSchema |
| if err := json.Unmarshal(data, &simpleSchema); err != nil { |
| return err |
| } |
| var vendorExtensible VendorExtensible |
| if err := json.Unmarshal(data, &vendorExtensible); err != nil { |
| return err |
| } |
| i.Refable = ref |
| i.CommonValidations = validations |
| i.SimpleSchema = simpleSchema |
| i.VendorExtensible = vendorExtensible |
| return nil |
| } |
| |
| // MarshalJSON converts this items object to JSON |
| func (i Items) MarshalJSON() ([]byte, error) { |
| b1, err := json.Marshal(i.CommonValidations) |
| if err != nil { |
| return nil, err |
| } |
| b2, err := json.Marshal(i.SimpleSchema) |
| if err != nil { |
| return nil, err |
| } |
| b3, err := json.Marshal(i.Refable) |
| if err != nil { |
| return nil, err |
| } |
| b4, err := json.Marshal(i.VendorExtensible) |
| if err != nil { |
| return nil, err |
| } |
| return swag.ConcatJSON(b4, b3, b1, b2), nil |
| } |
| |
| // JSONLookup look up a value by the json property name |
| func (p Items) JSONLookup(token string) (interface{}, error) { |
| if token == "$ref" { |
| return &p.Ref, nil |
| } |
| |
| r, _, err := jsonpointer.GetForToken(p.CommonValidations, token) |
| if err != nil && !strings.HasPrefix(err.Error(), "object has no field") { |
| return nil, err |
| } |
| if r != nil { |
| return r, nil |
| } |
| r, _, err = jsonpointer.GetForToken(p.SimpleSchema, token) |
| return r, err |
| } |