swagger

type APIDefinition struct {
	Swagger     string            `yaml:"swagger" json:"swagger"`
	Info        Info              `yaml:"info" json:"info"`
	Host        string            `yaml:"host,omitempty" json:"host,omitempty"`
	Schemes     []string          `yaml:"schemes,omitempty" json:"schemes,omitempty"`
	BasePath    string            `yaml:"basePath" json:"basePath"`
	Produces    []string          `yaml:"produces,omitempty" json:"produces,omitempty"`
	Paths       map[string]*Path  `yaml:"paths" json:"paths"`
	Definitions map[string]*Items `yaml:"definitions,omitempty" json:"definitions,omitempty"`
	Parameters  map[string]*Items `yaml:"parameters,omitempty" json:"parameters,omitempty"`
}

type ApiDeclarationList struct {
	List []APIDefinition
}

type Config struct {
	// url where the services are available, e.g. http://localhost:8080
	// if left empty then the basePath of Swagger is taken from the actual request
	WebServicesUrl string
	// path where the JSON api is avaiable , e.g. /apidocs
	ApiPath string
	// [optional] path where the swagger UI will be served, e.g. /swagger
	SwaggerPath string
	// [optional] location of folder containing Swagger HTML5 application index.html
	SwaggerFilePath string
	// [optional] location of schema file
	OutFilePath string
	//是否开启显示契约的服务，默认不开启
	OpenService bool
	//写入本地磁盘的格式，json or yaml 默认yaml
	FileStyle string
	// api listing is constructed from this list of restful WebServices.
	WebServices []*restful.WebService
	// will serve all static content (scripts,pages,images)
	StaticHandler http.Handler
	// [optional] on default CORS (Cross-Origin-Resource-Sharing) is enabled.
	DisableCORS bool
	// Top-level API version. Is reflected in the resource listing.
	ApiVersion string
	// If set then call this handler after building the complete ApiDeclaration Map
	PostBuildHandler PostBuildDeclarationMapFunc
	// Swagger global info struct
	Info Info
	// [optional] If set, model builder should call this handler to get addition typename-to-swagger-format-field conversion.
	SchemaFormatHandler MapSchemaFormatFunc
	// [optional] If set, model builder should call this handler to retrieve the name for a given type.
	ModelTypeNameHandler MapModelTypeNameFunc
}

type Endpoint struct {
	Summary     string              `yaml:"summary,omitempty" json:"summary,omitempty"`
	Description string              `yaml:"description,omitempty" json:"description,omitempty"`
	Tags        []string            `yaml:"tags,omitempty" json:"tags,omitempty"`
	OperationId string              `yaml:"operationId,omitempty" json:"operationId,omitempty"`
	Parameters  Parameters          `yaml:"parameters,omitempty" json:"parameters,omitempty"`
	Consumes    []string            `yaml:"consumes,omitempty" json:"consumes,omitempty"`
	Produces    []string            `yaml:"produces,omitempty" json:"produces,omitempty"`
	Responses   map[string]Response `yaml:"responses,omitempty" json:"responses,omitempty"`
}

type Info struct {
	Title       string `yaml:"title" json:"title"`
	Description string `yaml:"description,omitempty" json:"description,omitempty"`
	Version     string `yaml:"version" json:"version"`
}

type Items struct {
	Name        string      `yaml:"name,omitempty" json:"name,omitempty"`
	In          string      `yaml:"in,omitempty" json:"in,omitempty"`
	Description string      `yaml:"description,omitempty" json:"description,omitempty"`
	Required    bool        `yaml:"required,omitempty" json:"required,omitempty"`
	Type        interface{} `yaml:"type,omitempty" json:"type,omitempty"`
	Format      interface{} `yaml:"format,omitempty" json:"format,omitempty"`
	Enum        []string    `yaml:"enum,omitempty" json:"enum,omitempty"`

	ProtoTag int `yaml:"x-proto-tag,omitempty" json:"x-proto-tag,omitempty"`
	// Map type
	AdditionalProperties *Items `yaml:"additionalProperties,omitempty" json:"additionalProperties,omitempty"`
	// ref another Model
	Ref string `yaml:"$ref,omitempty" json:"$ref,omitempty"`
	// is an array
	Items      *Items            `yaml:"items,omitempty" json:"items,omitempty"`
	Schema     *Items            `yaml:"schema,omitempty" json:"schema,omitempty"`
	Properties map[string]*Items `yaml:"properties,omitempty" json:"properties,omitempty"`
}

type MapModelTypeNameFunc func(t reflect.Type) (string, bool)

type MapSchemaFormatFunc func(typeName string) string

type Parameters []*Items

type Path struct {
	Get        *Endpoint  `yaml:"get,omitempty" json:"get,omitempty"`
	Put        *Endpoint  `yaml:"put,omitempty" json:"put,omitempty"`
	Post       *Endpoint  `yaml:"post,omitempty" json:"post,omitempty"`
	Delete     *Endpoint  `yaml:"delete,omitempty" json:"delete,omitempty"`
	Patch      *Endpoint  `yaml:"patch,omitempty" json:"patch,omitempty"`
	Options    *Endpoint  `yaml:"options,omitempty" json:"options,omitempty"`
	Head       *Endpoint  `yaml:"head,omitempty" json:"head,omitempty"`
	Parameters Parameters `yaml:"parameters,omitempty" json:"parameters,omitempty"`
}

type PostBuildDeclarationMapFunc func(apiDeclarationMap *ApiDeclarationList)

type Response struct {
	Description string            `yaml:"description" json:"description"`
	Schema      *Items            `yaml:"schema,omitempty" json:"schema,omitempty"`
	Headers     map[string]*Items `yaml:"headers,omitempty" json:"headers,omitempty"`
}

type SwaggerService struct {
	// contains filtered or unexported fields
}