mhttp

type Config struct {
	// Address is the address of the server.
	Address string `mconv:"address"`
	// ServerName is the name of the server.
	ServerName string `mconv:"server_name"`
	// ServerRoot is the root directory of the server.
	ServerRoot string `mconv:"server_root"`
	// ServerLocale is the locale of the server.
	ServerLocale string `mconv:"server_locale"`
	// ReadTimeout is the timeout for reading the request.
	ReadTimeout time.Duration `mconv:"read_timeout"`
	// WriteTimeout is the timeout for writing the response.
	WriteTimeout time.Duration `mconv:"write_timeout"`
	// IdleTimeout is the timeout for idle connections.
	IdleTimeout time.Duration `mconv:"idle_timeout"`
	// MaxHeaderBytes is the maximum number of bytes in the request header.
	MaxHeaderBytes int `mconv:"max_header_bytes"`
	// HealthCheck is the health check config.
	HealthCheck bool `mconv:"health_check"`
	// TLSEnable is the tls config.
	TLSEnable bool `mconv:"tls_enable"`
	// TLSCertFile is the path to the tls certificate file.
	TLSCertFile string `mconv:"tls_cert_file"`
	// TLSKeyFile is the path to the tls key file.
	TLSKeyFile string `mconv:"tls_key_file"`
	// TLSServerName is the server name for tls.
	TLSServerName string `mconv:"tls_server_name"`
	// GracefulEnable is the graceful shutdown config.
	GracefulEnable bool `mconv:"graceful_enable"`
	// GracefulTimeout is the timeout for graceful shutdown.
	GracefulTimeout time.Duration `mconv:"graceful_timeout"`
	// GracefulWaitTime is the wait time for graceful shutdown.
	GracefulWaitTime time.Duration `mconv:"graceful_wait_time"`
	// OpenapiPath is the path to the openapi file.
	OpenapiPath string `mconv:"openapi_path"`
	// SwaggerPath is the path to the swagger file.
	SwaggerPath string `mconv:"swagger_path"`
	// SwaggerTemplate is the template for the swagger file.
	SwaggerTemplate string `mconv:"swagger_template"`
	// PrintRoutes is the print routes config.
	PrintRoutes bool `mconv:"print_routes"`
	// Logger is the logger config.
	Logger *mlog.Logger
}

type DefaultResponse struct {
	Code    int    `json:"code"`    // business code
	Message string `json:"message"` // prompt information
	Data    any    `json:"data"`    // business data
}

type HandlerFunc func(*Request)

type Info struct {
	Title   string `json:"title"`
	Version string `json:"version"`
}

type MediaType struct {
	Schema Schema `json:"schema"`
}

type MiddlewareFunc func(*Request)

type OpenAPI struct {
	Openapi string              `json:"openapi"`
	Info    Info                `json:"info"`
	Paths   map[string]PathItem `json:"paths"`
}

type Operation struct {
	Tags        []string            `json:"tags,omitempty"`
	Summary     string              `json:"summary,omitempty"`
	Description string              `json:"description,omitempty"`
	Parameters  []Parameter         `json:"parameters,omitempty"`
	RequestBody *RequestBody        `json:"requestBody,omitempty"`
	Responses   map[string]Response `json:"responses"`
}

type Parameter struct {
	Name        string `json:"name"`
	In          string `json:"in"`
	Required    bool   `json:"required"`
	Schema      Schema `json:"schema"`
	Description string `json:"description,omitempty"`
}

type PathItem struct {
	Get    *Operation `json:"get,omitempty"`
	Post   *Operation `json:"post,omitempty"`
	Put    *Operation `json:"put,omitempty"`
	Delete *Operation `json:"delete,omitempty"`
	Patch  *Operation `json:"patch,omitempty"`
	Head   *Operation `json:"head,omitempty"`
}

type RateLimitConfig struct {
	// Rate defines the number of requests allowed per second
	Rate float64
	// Burst defines the maximum number of requests that can be processed at once
	Burst int
	// SkipFunc is an optional function to determine if rate limiting should be skipped
	SkipFunc func(*Request) bool
	// ErrorHandler is an optional function to handle rate limit errors
	ErrorHandler func(*Request)
}

type Request struct {
	*gin.Context
	// contains filtered or unexported fields
}

type RequestBody struct {
	Required bool                 `json:"required"`
	Content  map[string]MediaType `json:"content"`
}

type Response struct {
	Description string               `json:"description"`
	Content     map[string]MediaType `json:"content"`
}

type Route struct {
	Method           string
	Path             string
	HandlerFunc      HandlerFunc
	Type             routeType
	Controller       any            // controller object
	ControllerMethod reflect.Method // controller method
	ReqType          reflect.Type   // request parameter type
	RespType         reflect.Type   // response type
}

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

type RouterGroupOption func(*RouterGroup)

type RuleFunc func(fl validator.FieldLevel) bool

type Schema struct {
	Type                 string            `json:"type,omitempty"`
	Format               string            `json:"format,omitempty"`
	Properties           map[string]Schema `json:"properties,omitempty"`
	Items                *Schema           `json:"items,omitempty"`
	AdditionalProperties *Schema           `json:"additionalProperties,omitempty"`
	Description          string            `json:"description,omitempty"`
	Required             []string          `json:"required,omitempty"`
}

type Server struct {
	RouterGroup
	// contains filtered or unexported fields
}