56 lines
1.5 KiB
Go
56 lines
1.5 KiB
Go
package openapi3
|
|
|
|
import (
|
|
"context"
|
|
)
|
|
|
|
// Callback is specified by OpenAPI/Swagger standard version 3.
|
|
// See https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#callback-object
|
|
type Callback struct {
|
|
Extensions map[string]any `json:"-" yaml:"-"`
|
|
Origin *Origin `json:"-" yaml:"-"`
|
|
|
|
m map[string]*PathItem
|
|
}
|
|
|
|
// NewCallback builds a Callback object with path items in insertion order.
|
|
func NewCallback(opts ...NewCallbackOption) *Callback {
|
|
Callback := NewCallbackWithCapacity(len(opts))
|
|
for _, opt := range opts {
|
|
opt(Callback)
|
|
}
|
|
return Callback
|
|
}
|
|
|
|
// NewCallbackOption describes options to NewCallback func
|
|
type NewCallbackOption func(*Callback)
|
|
|
|
// WithCallback adds Callback as an option to NewCallback
|
|
func WithCallback(cb string, pathItem *PathItem) NewCallbackOption {
|
|
return func(callback *Callback) {
|
|
if p := pathItem; p != nil && cb != "" {
|
|
callback.Set(cb, p)
|
|
}
|
|
}
|
|
}
|
|
|
|
// Validate returns an error if Callback does not comply with the OpenAPI spec.
|
|
func (callback *Callback) Validate(ctx context.Context, opts ...ValidationOption) error {
|
|
ctx = WithValidationOptions(ctx, opts...)
|
|
|
|
for _, key := range callback.Keys() {
|
|
v := callback.Value(key)
|
|
if err := v.Validate(ctx); err != nil {
|
|
return err
|
|
}
|
|
}
|
|
|
|
return validateExtensions(ctx, callback.Extensions, callback.Origin)
|
|
}
|
|
|
|
// UnmarshalJSON sets Callbacks to a copy of data.
|
|
func (callbacks *Callbacks) UnmarshalJSON(data []byte) (err error) {
|
|
*callbacks, err = unmarshalStringMapP[CallbackRef](data)
|
|
return
|
|
}
|