web

May 30, 2024

Changes in this version

type Context

+ func (ctx *Context) SetLocation(l *time.Location)

May 27, 2024

Changes in this version

type RouterOption

+ func WithAllowedCORS(maxAge int) RouterOption

+ func WithAnyInterceptor(rule string) RouterOption

+ func WithCORS(origin, allowHeaders, exposedHeaders []string, maxAge int, ...) RouterOption

+ func WithDenyCORS() RouterOption

+ func WithDigitInterceptor(rule string) RouterOption

+ func WithInterceptor(f mux.InterceptorFunc, rule ...string) RouterOption

+ func WithRecovery(status int, l *Logger) RouterOption

+ func WithTrace(body bool) RouterOption

+ func WithURLDomain(prefix string) RouterOption

+ func WithWordInterceptor(rule string) RouterOption

Apr 25, 2024

Changes in this version

+ func SprintError(p *localeutil.Printer, detail bool, err error) string

type Problems

+ func (ps *Problems) Exists(id string) bool

Apr 18, 2024

Changes in this version

type Problem

+ XMLName struct{}

Mar 27, 2024

Changes in this version

+ func IsProblem(status int) bool

Mar 26, 2024

Changes in this version

+ func GetCacheItemOrInit[T any](c Cache, key string, v *T, ttl time.Duration, init func() (T, error)) error

Mar 22, 2024

Changes in this version

type LocaleProblem

+ func (p *LocaleProblem) Type() string

Mar 21, 2024

Changes in this version

type Context

+ func (ctx *Context) DelVar(key any)

Mar 8, 2024

Changes in this version

type InternalServer

+ func (s *InternalServer) OnContext(f ...OnContextFunc)

+ func (s *InternalServer) OnExitContext(f ...OnExitContextFunc)

+ type OnContextFunc = func(http.ResponseWriter, *http.Request, types.Route) (http.ResponseWriter, *http.Request)

+ type OnExitContextFunc = func(ctx *Context, status int)

type Server

+ OnContext func(...OnContextFunc)

+ OnExitContext func(...OnExitContextFunc)

Feb 28, 2024

Changes in this version

+ type AttrLogs = logs.AttrLogs

type Cache

+ func NewCache(prefix string, c Cache) Cache

type Context

+ func (ctx *Context) NewFilterContext(exitAtError bool) *FilterContext

+ type InternalServer struct

+ func InternalNewServer(s Server, name, ver string, loc *time.Location, logs *Logs, ...) *InternalServer

+ func (s *InternalServer) Cache() cache.Cleanable

+ func (s *InternalServer) CanCompress() bool

+ func (s *InternalServer) Close()

+ func (s *InternalServer) Config() *config.Config

+ func (s *InternalServer) FreeContext(ctx *Context)

+ func (s *InternalServer) Locale() Locale

+ func (s *InternalServer) Location() *time.Location

+ func (s *InternalServer) Logs() *Logs

+ func (s *InternalServer) Name() string

+ func (s *InternalServer) NewClient(c *http.Client, sel selector.Selector, m string, ...) *Client

+ func (s *InternalServer) NewContext(w http.ResponseWriter, r *http.Request, route types.Route) *Context

+ func (s *InternalServer) Now() time.Time

+ func (s *InternalServer) OnClose(f ...func() error)

+ func (s *InternalServer) ParseTime(layout, value string) (time.Time, error)

+ func (s *InternalServer) Problems() *Problems

+ func (s *InternalServer) Routers() *Routers

+ func (s *InternalServer) ServeHTTP(w http.ResponseWriter, r *http.Request)

+ func (s *InternalServer) Services() *Services

+ func (s *InternalServer) SetCompress(enable bool)

+ func (s *InternalServer) UniqueID() string

+ func (s *InternalServer) Uptime() time.Time

+ func (s *InternalServer) Use(p ...Plugin)

+ func (s *InternalServer) Vars() *sync.Map

+ func (s *InternalServer) Version() string

+ type Plugin interface

+ Plugin func(Server)

+ type PluginFunc func(Server)

+ func (f PluginFunc) Plugin(s Server)

type Problem

+ Detail string

+ Extensions any

+ Instance string

+ Status int

+ Title string

+ Type string

+ func (p *Problem) Error() string

+ type ProblemBuilder = func() *Problem

+ type RouterMatcherFunc = group.MatcherFunc

type RouterOption

+ func AllowedCORS(maxAge int) RouterOption

+ func CORS(origin, allowHeaders, exposedHeaders []string, maxAge int, ...) RouterOption

+ func DenyCORS() RouterOption

+ func Recovery(l *logs.Logger) RouterOption

+ func URLDomain(prefix string) RouterOption

+ type Routers struct

+ func (r *Routers) Get(name string) *Router

+ func (r *Routers) New(name string, matcher RouterMatcher, o ...RouterOption) *Router

+ func (r *Routers) Remove(name string)

+ func (r *Routers) Routers() []*Router

+ func (r *Routers) Use(m ...Middleware)

type Server

+ Use func(...Plugin)

Nov 21, 2023

Changes in this version

+ func SelectorRewrite(s Selector, l Logger) func(*httputil.ProxyRequest)

+ type Codec struct

+ func NewCodec() *Codec

+ func (e *Codec) AddCompressor(c Compressor, t ...string) *Codec

+ func (e *Codec) AddMimetype(name string, m MarshalFunc, u UnmarshalFunc, problem string) *Codec

type Compressor

+ Name func() string

+ NewDecoder func(r io.Reader) (io.ReadCloser, error)

+ NewEncoder func(w io.Writer) (io.WriteCloser, error)

type Context

+ func (ctx *Context) Free()

+ func (ctx *Context) Wrap(f func(http.ResponseWriter) http.ResponseWriter)

+ type ContextBuilder struct

+ func NewContextBuilder(s Server, codec *Codec, requestIDKey string) *ContextBuilder

+ func (b *ContextBuilder) NewContext(w http.ResponseWriter, r *http.Request, route types.Route) *Context

type Filter

+ Filter func(*FilterContext)

+ type FilterContext struct

+ func (v *FilterContext) Add(f FilterFunc) *FilterContext

+ func (v *FilterContext) AddError(name string, err error) *FilterContext

+ func (v *FilterContext) AddFilter(name string, f Filter) *FilterContext

+ func (v *FilterContext) AddReason(name string, reason LocaleStringer) *FilterContext

+ func (v *FilterContext) Context() *Context

+ func (v *FilterContext) New(name string, f func(f *FilterContext)) *FilterContext

+ func (v *FilterContext) Problem(id string) Problem

+ func (v *FilterContext) When(cond bool, f func(v *FilterContext)) *FilterContext

+ type FilterFunc = func() (string, LocaleStringer)

+ type FilterFuncOf func(name string, v *T) FilterFunc

+ func NewFilterFromVS[T any](msg LocaleStringer, v func(T) bool, s ...func(*T)) FilterFuncOf[T]

+ func NewMapFilter[K comparable, V any, M ~map[K]V](rule RuleFuncOf[V], s ...func(*V)) FilterFuncOf[M]

+ func NewSliceFilter[T any, S ~[]T](rule RuleFuncOf[T], s ...func(*T)) FilterFuncOf[S]

type Locale

+ ID func() language.Tag

+ LoadMessages func(glob string, fsys ...fs.FS) error

+ NewPrinter func(tag language.Tag) *message.Printer

+ Printer func() *message.Printer

+ Set func(tag language.Tag, key string, msg ...catalog.Message) error

+ SetMacro func(tag language.Tag, name string, msg ...catalog.Message) error

+ SetString func(tag language.Tag, key, msg string) error

+ Sprintf func(string, ...any) string

+ type LocaleProblem struct

+ Detail LocaleStringer

+ ID string

+ Title LocaleStringer

+ type Problems interface

+ Add func(status int, p ...LocaleProblem) Problems

+ Init func(problem *RFC7807, id string, p *message.Printer)

+ Prefix func() string

+ Visit func(visit func(id string, status int, title, detail LocaleStringer))

type RFC7807

+ func (p *RFC7807) Init(id, title, detail string, status int)

+ type RuleFuncOf func(string, T) (string, LocaleStringer)

+ func NewMapRule[K comparable, V any, M ~map[K]V](v func(V) bool, msg LocaleStringer) RuleFuncOf[M]

+ func NewMapRules[K comparable, V any, M ~map[K]V](r ...RuleFuncOf[V]) RuleFuncOf[M]

+ func NewRules[T any](r ...RuleFuncOf[T]) RuleFuncOf[T]

+ func NewSliceRule[T any, S ~[]T](v func(T) bool, msg LocaleStringer) RuleFuncOf[S]

+ func NewSliceRules[T any, S ~[]T](r ...RuleFuncOf[T]) RuleFuncOf[S]

+ type Selector interface

+ Next func() string

+ func RingSelector(u ...string) Selector

+ func URLSelector(u string) Selector

+ type SelectorFunc func() string

+ func (s SelectorFunc) Next() string

type Server

+ CanCompress func() bool

+ Locale func() Locale

+ Problems func() Problems

+ SetCompress func(enable bool)

Oct 15, 2023

Changes in this version

+ func NewError(status int, err error) error

+ type BuildMarshalFunc func(*Context) MarshalFunc

+ type Client struct

+ func NewClient(client *http.Client, url, marshalName string, mt []*Mimetype, ...) *Client

+ func (c *Client) Client() *http.Client

+ func (c *Client) Delete(path string, resp any, problem *RFC7807) error

+ func (c *Client) Do(method, path string, req, resp any, problem *RFC7807) error

+ func (c *Client) Get(path string, resp any, problem *RFC7807) error

+ func (c *Client) NewRequest(method, path string, body any) (resp *http.Request, err error)

+ func (c *Client) ParseResponse(rsp *http.Response, resp any, problem *RFC7807) (err error)

+ func (c *Client) Patch(path string, req, resp any, problem *RFC7807) error

+ func (c *Client) Post(path string, req, resp any, problem *RFC7807) error

+ func (c *Client) Put(path string, req, resp any, problem *RFC7807) error

+ func (c *Client) URL(path string) string

+ type Compress struct

+ Compressor Compressor

+ Name string

+ Types []string

+ func AllCompresses() []*Compress

+ type Compressor = compress.Compressor

+ func NewBrotliCompress(o brotli.WriterOptions) Compressor

+ func NewDeflateCompress(level int, dict []byte) Compressor

+ func NewGzipCompress(level int) Compressor

+ func NewLZWCompress(order lzw.Order, width int) Compressor

+ func NewZstdCompress() Compressor

type Mimetype

+ MarshalBuilder BuildMarshalFunc

type Options

+ Compresses []*Compress

+ Language language.Tag

type Problem

+ WithExtensions func(any) Problem

+ WithInstance func(string) Problem

+ type RFC7807 struct

+ Detail string

+ Extensions any

+ Instance string

+ Params []RFC7807Param

+ Status int

+ Title string

+ Type string

+ func (p *RFC7807) Apply(ctx *Context) Problem

+ func (p *RFC7807) Error() string

+ func (p *RFC7807) WithExtensions(ext any) Problem

+ func (p *RFC7807) WithInstance(instance string) Problem

+ func (p *RFC7807) WithParam(name, reason string) Problem

+ type RFC7807Param struct

+ Name string

+ Reason string

type Responser

+ func KeepAlive(ctx context.Context) Responser

type Server

+ func (srv *Server) Catalog() *catalog.Builder

+ func (srv *Server) CompressIsDisable() bool

+ func (srv *Server) DisableCompress(disable bool)

+ func (srv *Server) LoadLocale(glob string, fsys ...fs.FS) error

+ func (srv *Server) NewClient(client *http.Client, url, marshalName string) *Client

Sep 18, 2023

Changes in this version

+ func ErrUnsupportedSerialization() error

Sep 15, 2023

Changes in this version

+ const DefaultConfigDir

+ const Failed

+ const RequestIDKey

+ const Running

+ const Stopped

type CTXFilter

+ CTXFilter func(*FilterProblem)

type Context

+ func (ctx *Context) Begin() time.Time

+ func (ctx *Context) Charset() string

+ func (ctx *Context) Encoding() string

+ func (ctx *Context) GetVar(key any) (any, bool)

+ func (ctx *Context) Header() http.Header

+ func (ctx *Context) ID() string

+ func (ctx *Context) IsXHR() bool

+ func (ctx *Context) LanguageTag() language.Tag

+ func (ctx *Context) Logs() Logs

+ func (ctx *Context) Mimetype(problem bool) string

+ func (ctx *Context) NewFilterProblem(exitAtError bool) *FilterProblem

+ func (ctx *Context) OnExit(f func(*Context, int))

+ func (ctx *Context) PathID(key, id string) (int64, Responser)

+ func (ctx *Context) PathInt64(key, id string) (int64, Responser)

+ func (ctx *Context) PathString(key, id string) (string, Responser)

+ func (ctx *Context) Paths(exitAtError bool) *Paths

+ func (ctx *Context) Problem(id string) *Problem

+ func (ctx *Context) RequestBody() (body []byte, err error)

+ func (ctx *Context) Route() types.Route

+ func (ctx *Context) SetCharset(charset string)

+ func (ctx *Context) SetCookies(c ...*http.Cookie)

+ func (ctx *Context) SetEncoding(enc string)

+ func (ctx *Context) SetLanguage(tag language.Tag)

+ func (ctx *Context) SetMimetype(mimetype string)

+ func (ctx *Context) SetVar(key, val any)

+ func (ctx *Context) SetWriter(f func(http.ResponseWriter) http.ResponseWriter)

+ func (ctx *Context) Unwrap() http.ResponseWriter

+ func (ctx *Context) Write(bs []byte) (int, error)

+ func (ctx *Context) WriteHeader(status int)

+ func (ctx *Context) Wrote() bool

+ type Encoder interface

+ Reset func(io.Writer)

+ type Encoding struct

+ Builder NewEncoderFunc

+ ContentTypes []string

+ Name string

type FilterProblem

+ func (v *FilterProblem) Add(name string, reason LocaleStringer) *FilterProblem

+ func (v *FilterProblem) AddError(name string, err error) *FilterProblem

+ func (v *FilterProblem) AddFilter(f filter.FilterFunc) *FilterProblem

+ func (v *FilterProblem) Context() *Context

+ func (v *FilterProblem) Problem(id string) Responser

+ func (v *FilterProblem) When(cond bool, f func(v *FilterProblem)) *FilterProblem

+ type IDGenerator = func() string

type Locale

+ Catalog *catalog.Builder

+ Language language.Tag

+ type MarshalFunc func(*Context, any) ([]byte, error)

+ type Mimetype struct

+ Marshal MarshalFunc

+ ProblemType string

+ Type string

+ Unmarshal UnmarshalFunc

+ type NewEncoderFunc func() Encoder

+ func BrotliWriter(o brotli.WriterOptions) NewEncoderFunc

+ func CompressWriter(order lzw.Order, width int) NewEncoderFunc

+ func DeflateWriter(level int) NewEncoderFunc

+ func GZipWriter(level int) NewEncoderFunc

+ func ZstdWriter(o ...zstd.EOption) NewEncoderFunc

type Options

+ Config *config.Config

+ Encodings []*Encoding

+ IDGenerator IDGenerator

+ Init []func(*Server)

+ Locale *Locale

+ Logs *logs.Options

+ Mimetypes []*Mimetype

+ ProblemTypePrefix string

+ RequestIDKey string

+ RoutersOptions []RouterOption

+ type Paths struct

+ func (p *Paths) Bool(key string) bool

+ func (p *Paths) Float64(key string) float64

+ func (p *Paths) ID(key string) int64

+ func (p *Paths) Int64(key string) int64

+ func (p *Paths) Problem(id string) Responser

+ func (p *Paths) String(key string) string

type Problem

+ Fields []ProblemField

+ Params []ProblemParam

+ func (p *Problem) Apply(ctx *Context) *Problem

+ func (p *Problem) MarshalForm() ([]byte, error)

+ func (p *Problem) MarshalHTML() (string, any)

+ func (p *Problem) MarshalJSON() ([]byte, error)

+ func (p *Problem) MarshalXML(e *xml.Encoder, start xml.StartElement) error

+ func (p *Problem) WithField(key string, val any) *Problem

+ func (p *Problem) WithParam(name, reason string) *Problem

+ type ProblemField struct

+ Key string

+ Value any

+ type ProblemParam struct

+ Name string

+ Reason string

type Queries

+ func (q *Queries) Problem(id string) Responser

type Responser

+ Apply func(*Context) *Problem

type ResponserFunc

+ func (f ResponserFunc) Apply(c *Context) *Problem

+ type RouterMatcher = group.Matcher

+ type RouterOption = mux.Option

type Server

+ func (srv *Server) AddProblem(id string, status int, title, detail LocaleStringer) *Server

+ func (srv *Server) CatalogBuilder() *catalog.Builder

+ func (srv *Server) Config() *config.Config

+ func (srv *Server) FileServer(fsys fs.FS, name, index string) HandlerFunc

+ func (srv *Server) GetRouter(name string) *Router

+ func (srv *Server) Language() language.Tag

+ func (srv *Server) LoadLocales(fsys fs.FS, glob string) error

+ func (srv *Server) LocalePrinter() *message.Printer

+ func (srv *Server) NewPrinter(tag language.Tag) *message.Printer

+ func (srv *Server) NewRouter(name string, matcher RouterMatcher, o ...RouterOption) *Router

+ func (srv *Server) OnClose(f ...func() error)

+ func (srv *Server) Open(name string) (fs.File, error)

+ func (srv *Server) RemoveRouter(name string)

+ func (srv *Server) Routers() []*Router

+ func (srv *Server) State() State

+ func (srv *Server) UniqueID() string

+ func (srv *Server) UseMiddleware(m ...Middleware)

+ func (srv *Server) Vars() *sync.Map

+ func (srv *Server) VisitProblems(visit func(prefix, id string, status int, title, detail LocaleStringer))

type Service

+ Serve func(context.Context) error

type ServiceFunc

+ func (f ServiceFunc) Serve(ctx context.Context) error

type Services

+ func (srv *Services) Add(title LocaleStringer, f Service)

+ func (srv *Services) AddAt(title LocaleStringer, job JobFunc, at time.Time, delay bool)

+ func (srv *Services) AddCron(title LocaleStringer, f JobFunc, spec string, delay bool)

+ func (srv *Services) AddFunc(title LocaleStringer, f func(context.Context) error)

+ func (srv *Services) AddJob(title LocaleStringer, job JobFunc, scheduler Scheduler, delay bool)

+ func (srv *Services) AddTicker(title LocaleStringer, job JobFunc, dur time.Duration, imm, delay bool)

+ func (srv *Services) Visit(visit func(title LocaleStringer, state State, err error))

+ func (srv *Services) VisitJobs(visit func(LocaleStringer, time.Time, time.Time, State, bool, error))

+ type State = scheduled.State

+ type UnmarshalFunc func([]byte, any) error

Aug 20, 2023

Changes in this version

+ type Problem = server.Problem

Aug 16, 2023

Changes in this version

+ func NewHTTPError(status int, err error) error

Aug 3, 2023

Changes in this version

+ type Logs = logs.Logs

Jul 20, 2023

Changes in this version

+ type StringPhrase = localeutil.StringPhrase

Mar 20, 2023

Changes in this version

+ func NewFilter(rule filter.RulerFuncOf[T], sanitize ...func(*T)) filter.BuildFilterFuncOf[T]

+ type FilterProblem = server.FilterProblem

Mar 17, 2023

Changes in this version

+ type CTXFilter = server.CTXFilter

Mar 6, 2023

Changes in this version

type Responser

+ func NotModified(etag func() (string, bool), body func() (any, error)) Responser

Feb 1, 2023

Changes in this version

+ type FieldError = errs.FieldError

+ func NewFieldError(field string, msg any) *FieldError

Jan 6, 2023

Changes in this version

+ func NewLocaleError(format string, v ...any) error

Jan 5, 2023

Changes in this version

+ const ProblemAboutBlank

+ const ServiceFailed

+ const ServiceRunning

+ const ServiceStopped

+ func NewConfigError(field string, msg any, path string, val any) *errs.ConfigError

+ func NewStackError(err error) error

Oct 9, 2022

Changes in this version

+ const ProblemBadGateway

+ const ProblemBadRequest

+ const ProblemConflict

+ const ProblemExpectationFailed

+ const ProblemFailedDependency

+ const ProblemForbidden

+ const ProblemGatewayTimeout

+ const ProblemGone

+ const ProblemHTTPVersionNotSupported

+ const ProblemInsufficientStorage

+ const ProblemInternalServerError

+ const ProblemLengthRequired

+ const ProblemLocked

+ const ProblemLoopDetected

+ const ProblemMethodNotAllowed

+ const ProblemMisdirectedRequest

+ const ProblemNetworkAuthenticationRequired

+ const ProblemNotAcceptable

+ const ProblemNotExtended

+ const ProblemNotFound

+ const ProblemNotImplemented

+ const ProblemPaymentRequired

+ const ProblemPreconditionFailed

+ const ProblemPreconditionRequired

+ const ProblemProxyAuthRequired

+ const ProblemRequestEntityTooLarge

+ const ProblemRequestHeaderFieldsTooLarge

+ const ProblemRequestTimeout

+ const ProblemRequestURITooLong

+ const ProblemRequestedRangeNotSatisfiable

+ const ProblemServiceUnavailable

+ const ProblemTeapot

+ const ProblemTooEarly

+ const ProblemTooManyRequests

+ const ProblemUnauthorized

+ const ProblemUnavailableForLegalReasons

+ const ProblemUnprocessableEntity

+ const ProblemUnsupportedMediaType

+ const ProblemUpgradeRequired

+ const ProblemVariantAlsoNegotiates

Aug 29, 2022

Changes in this version

+ type QueryUnmarshaler = query.Unmarshaler

Aug 20, 2022

Changes in this version

+ type ResponserFunc = server.ResponserFunc

Aug 16, 2022

Changes in this version

type Rule

+ func NewRuleFunc(message LocaleStringer, f func(any) bool) *Rule

+ type Validation = validation.Validation

Aug 7, 2022

Changes in this version

+ type Rule = validation.Rule

+ type ValidateFunc = validation.ValidateFunc

Jun 17, 2022

Changes in this version

+ func Errors(err ...error) error

+ func NewRule(v validation.Validator, key message.Reference, val ...any) *validation.Rule

Apr 30, 2022

Changes in this version

+ func StackError(err error) error

+ type Cache = server.Cache

Apr 5, 2022

Changes in this version

+ type Logger = logs.Logger

Apr 1, 2022

Changes in this version

+ type RouterOptions = server.RouterOptions

Mar 22, 2022

Changes in this version

type Responser

+ func Redirect(status int, url string) Responser

Feb 13, 2022

Changes in this version

+ type Response = server.Response

Jan 28, 2022

Changes in this version

+ type MiddlewareFunc = server.MiddlewareFunc

type Responser

+ func RetryAfter(status int, seconds uint64) Responser

+ func RetryAt(status int, at time.Time) Responser

Dec 25, 2021

Changes in this version

type Command

+ Catalog *catalog.Builder

+ ConfigFilename string

+ Files *Files

+ SignalTimeout time.Duration

+ type Files = serialization.Files

type Responser

+ func NotImplemented() Responser

+ func OK(v interface{}) Responser

Oct 8, 2021

Changes in this version

+ type Action = server.Action

type Command

+ Options OptionsFunc

+ type LocaleStringer = localeutil.LocaleStringer

+ type OptionsFunc func(*Options)

type Responser

+ func Created(v interface{}, location string) Responser

+ func NoContent() Responser

+ func NotFound() Responser

Aug 25, 2021

Changes in this version

+ func Phrase(key string, v ...interface{}) localeutil.Phrase

type Command

+ Init func(*Server) error

+ type ConfigError = config.Error

+ type ResultFields = content.ResultFields

Aug 22, 2021

Changes in this version

+ type Command struct

+ CmdFS string

+ CmdTag string

+ CmdVersion string

+ Locale *serialization.Locale

+ LogsFilename string

+ Name string

+ Out io.Writer

+ RegisterModules func(*Server) error

+ ResultBuilder content.BuildResultFunc

+ ServeTags []string

+ Signals []os.Signal

+ Version string

+ WebFilename string

+ func (cmd *Command) Exec()

+ type Locale = serialization.Locale

Aug 12, 2021

Changes in this version

+ type Responser = server.Responser

+ func Object(status int, body interface{}, headers map[string]string) Responser

+ func Status(status int) Responser

Apr 22, 2021

Changes in this version

type Server

+ func DefaultServer(name, version, url string) (*Server, error)

+ func LoadServer(name, version string, f fs.FS, c catalog.Catalog, build result.BuildFunc) (*Server, error)

Apr 7, 2021

Changes in this version

+ func ExitContext(status int)

+ type CTXSanitizer interface

+ CTXSanitize func(*Context) result.Fields

+ type ModuleInfo struct

+ Deps []string

+ Description string

+ ID string

type Server

+ func (srv *Server) Name() string

+ func (srv *Server) SetRecovery(f recovery.RecoverFunc, status int)

+ func (srv *Server) Version() string

Dec 9, 2020

Changes in this version

+ const ModuleFuncName

+ type ModuleFunc func(*Server) (*Module, error)

type Server

+ func (srv *Server) AddModuleFunc(module ...ModuleFunc) error

Dec 7, 2020

Changes in this version

+ const PluginInstallFuncName

+ type PluginInstallFunc func(*Server) error

type Server

+ func (srv *Server) AddModule(module ...*Module) error

Dec 1, 2020

Changes in this version

+ var ContextKeyServer contextKey = 0

+ func Exit(status int)

type Context

+ InputCharset encoding.Encoding

+ InputMimetype content.UnmarshalFunc

+ LocalePrinter *message.Printer

+ Location *time.Location

+ OutputCharset encoding.Encoding

+ OutputCharsetName string

+ OutputMimetype content.MarshalFunc

+ OutputMimetypeName string

+ OutputTag language.Tag

+ Request *http.Request

+ Response http.ResponseWriter

+ Vars map[interface{}]interface{}

+ func (ctx *Context) Body() (body []byte, err error)

+ func (ctx *Context) ClientIP() string

+ func (ctx *Context) Created(v interface{}, location string)

+ func (ctx *Context) Critical(status int, v ...interface{})

+ func (ctx *Context) Criticalf(status int, format string, v ...interface{})

+ func (ctx *Context) Error(status int, v ...interface{})

+ func (ctx *Context) Errorf(status int, format string, v ...interface{})

+ func (ctx *Context) Exit(status int)

+ func (ctx *Context) Fprint(w io.Writer, v ...interface{}) (int, error)

+ func (ctx *Context) Fprintf(w io.Writer, key message.Reference, v ...interface{}) (int, error)

+ func (ctx *Context) Fprintln(w io.Writer, v ...interface{}) (int, error)

+ func (ctx *Context) Marshal(status int, v interface{}, headers map[string]string) error

+ func (ctx *Context) NewResult(code int) *Result

+ func (ctx *Context) NewResultWithFields(code int, fields result.Fields) *Result

+ func (ctx *Context) NoContent()

+ func (ctx *Context) NotFound()

+ func (ctx *Context) NotImplemented()

+ func (ctx *Context) Now() time.Time

+ func (ctx *Context) ParamID(key string) (int64, error)

+ func (ctx *Context) ParamInt64(key string) (int64, error)

+ func (ctx *Context) ParamString(key string) (string, error)

+ func (ctx *Context) Params() *Params

+ func (ctx *Context) ParseTime(layout, value string) (time.Time, error)

+ func (ctx *Context) Print(v ...interface{}) (int, error)

+ func (ctx *Context) Printf(key message.Reference, v ...interface{}) (int, error)

+ func (ctx *Context) Println(v ...interface{}) (int, error)

+ func (ctx *Context) Queries() (*Queries, error)

+ func (ctx *Context) QueryObject(v interface{}, code int) (ok bool)

+ func (ctx *Context) Read(v interface{}, code int) (ok bool)

+ func (ctx *Context) Render(status int, v interface{}, headers map[string]string)

+ func (ctx *Context) ResetContent()

+ func (ctx *Context) ServeContent(buf io.ReadSeeker, name string, headers map[string]string)

+ func (ctx *Context) ServeFile(path string, headers map[string]string)

+ func (ctx *Context) Server() *Server

+ func (ctx *Context) Sprint(v ...interface{}) string

+ func (ctx *Context) Sprintf(key message.Reference, v ...interface{}) string

+ func (ctx *Context) Sprintln(v ...interface{}) string

+ func (ctx *Context) Unmarshal(v interface{}) error

+ func (ctx *Context) Upload(field string, u *upload.Upload) ([]string, error)

type HandlerFunc

+ func FilterHandler(next HandlerFunc, filter ...Filter) HandlerFunc

type Module

+ AddInit func(title string, f func() error)

+ ID func() string

+ Remove func(path string, method ...string) Module

+ Tags func() []string

+ type Options struct

+ Cache cache.Cache

+ Catalog catalog.Catalog

+ DisableHead bool

+ DisableOptions bool

+ HTTPServer func(*http.Server)

+ Location *time.Location

+ ResultBuilder result.BuildFunc

+ Root string

+ SkipCleanPath bool

+ type Params struct

+ func (p *Params) Bool(key string) bool

+ func (p *Params) Errors() result.Fields

+ func (p *Params) Float64(key string) float64

+ func (p *Params) HasErrors() bool

+ func (p *Params) ID(key string) int64

+ func (p *Params) Int64(key string) int64

+ func (p *Params) MustBool(key string, def bool) bool

+ func (p *Params) MustFloat64(key string, def float64) float64

+ func (p *Params) MustID(key string, def int64) int64

+ func (p *Params) MustInt64(key string, def int64) int64

+ func (p *Params) MustString(key, def string) string

+ func (p *Params) Result(code int) *Result

+ func (p *Params) String(key string) string

type Prefix

+ func (p *Prefix) Remove(path string, method ...string)

+ type Queries struct

+ func (q *Queries) Bool(key string, def bool) bool

+ func (q *Queries) Errors() result.Fields

+ func (q *Queries) Float64(key string, def float64) float64

+ func (q *Queries) HasErrors() bool

+ func (q *Queries) Int(key string, def int) int

+ func (q *Queries) Int64(key string, def int64) int64

+ func (q *Queries) Object(v interface{})

+ func (q *Queries) Result(code int) *Result

+ func (q *Queries) String(key, def string) string

type Resource

+ func (r *Resource) Remove(method ...string)

type Result

+ func (rslt *Result) Render()

+ func (rslt *Result) RenderAndExit()

+ type Router struct

+ func (router *Router) Delete(path string, h HandlerFunc) *Router

+ func (router *Router) Get(path string, h HandlerFunc) *Router

+ func (router *Router) Handle(path string, h HandlerFunc, method ...string) error

+ func (router *Router) Mux() *mux.Mux

+ func (router *Router) NewRouter(name string, url *url.URL, matcher mux.Matcher, filter ...Filter) (*Router, bool)

+ func (router *Router) Options(path, allow string) *Router

+ func (router *Router) Patch(path string, h HandlerFunc) *Router

+ func (router *Router) Path(pattern string, params map[string]string) (string, error)

+ func (router *Router) Post(path string, h HandlerFunc) *Router

+ func (router *Router) Prefix(prefix string, filter ...Filter) *Prefix

+ func (router *Router) Put(path string, h HandlerFunc) *Router

+ func (router *Router) Remove(path string, method ...string)

+ func (router *Router) Resource(pattern string, filter ...Filter) *Resource

+ func (router *Router) Static(p, dir string) error

+ func (router *Router) URL(pattern string, params map[string]string) (string, error)

type Server

+ func GetServer(r *http.Request) *Server

+ func NewServer(logs *logs.Logs, o *Options) (*Server, error)

+ func (srv *Server) AddCompressTypes(types ...string)

+ func (srv *Server) AddFilters(filter ...Filter)

+ func (srv *Server) AddMiddlewares(middleware ...middleware.Middleware)

+ func (srv *Server) AddResultMessage(status, code int, key message.Reference, v ...interface{})

+ func (srv *Server) Cache() cache.Cache

+ func (srv *Server) Close(shutdownTimeout time.Duration) error

+ func (srv *Server) DeleteCompressTypes(types ...string)

+ func (srv *Server) Get(key interface{}) interface{}

+ func (srv *Server) InitTag(tag string) error

+ func (srv *Server) LoadPlugin(path string) error

+ func (srv *Server) LoadPlugins(glob string) error

+ func (srv *Server) Location() *time.Location

+ func (srv *Server) Logs() *logs.Logs

+ func (srv *Server) Mimetypes() *content.Mimetypes

+ func (srv *Server) Modules() []dep.Module

+ func (srv *Server) NewContext(w http.ResponseWriter, r *http.Request) *Context

+ func (srv *Server) NewLocalePrinter(tag language.Tag) *message.Printer

+ func (srv *Server) NewModule(id, desc string, deps ...string) (Module, error)

+ func (srv *Server) Now() time.Time

+ func (srv *Server) ParseTime(layout, value string) (time.Time, error)

+ func (srv *Server) ResultMessages(p *message.Printer) map[int]string

+ func (srv *Server) Router() *Router

+ func (srv *Server) Serve() (err error)

+ func (srv *Server) Services() *service.Manager

+ func (srv *Server) Set(key, val interface{})

+ func (srv *Server) SetCompressAlgorithm(name string, w compress.WriterFunc)

+ func (srv *Server) SetDebugger(pprof, vars string) (err error)

+ func (srv *Server) SetErrorHandle(h errorhandler.HandleFunc, status ...int)

+ func (srv *Server) Tags() map[string][]string

+ func (srv *Server) Uptime() time.Time

+ type Validator interface

+ CTXValidate func(*Context) result.Fields

Oct 15, 2020

Changes in this version

+ var ErrInited = errors.New("模块已经初始化")

type Config

+ ErrorHandlers []*ErrorHandler

+ Filters []Filter

+ Middlewares []Middleware

+ type ErrorHandler struct

+ Handler ErrorHandlerFunc

+ Status []int

+ type ErrorHandlerFunc = errorhandler.HandleFunc

+ type Filter = context.Filter

+ type HandlerFunc = context.HandlerFunc

+ type InstallFunc func(*Web)

+ type Job = scheduled.Job

+ type JobFunc = scheduled.JobFunc

+ type Middleware = middleware.Middleware

type Module

+ Deps []string

+ Description string

+ Name string

+ func (m *Module) AddAt(title string, f JobFunc, spec string, delay bool)

+ func (m *Module) AddCron(title string, f JobFunc, spec string, delay bool)

+ func (m *Module) AddFilters(filter ...Filter)

+ func (m *Module) AddJob(title string, f JobFunc, scheduler schedulers.Scheduler, delay bool)

+ func (m *Module) AddService(f ServiceFunc, title string)

+ func (m *Module) AddTicker(title string, f JobFunc, dur time.Duration, imm, delay bool)

+ func (m *Module) Delete(path string, h HandlerFunc) *Module

+ func (m *Module) Get(path string, h HandlerFunc) *Module

+ func (m *Module) Handle(path string, h HandlerFunc, method ...string) *Module

+ func (m *Module) NewTag(tag string) *Tag

+ func (m *Module) Options(path, allow string) *Module

+ func (m *Module) Patch(path string, h HandlerFunc) *Module

+ func (m *Module) Post(path string, h HandlerFunc) *Module

+ func (m *Module) Prefix(prefix string, filter ...Filter) *Prefix

+ func (m *Module) Put(path string, h HandlerFunc) *Module

+ func (m *Module) Resource(pattern string, filter ...Filter) *Resource

+ type Prefix struct

+ func (p *Prefix) Delete(path string, h HandlerFunc) *Prefix

+ func (p *Prefix) Get(path string, h HandlerFunc) *Prefix

+ func (p *Prefix) Handle(path string, h HandlerFunc, method ...string) *Prefix

+ func (p *Prefix) Module() *Module

+ func (p *Prefix) Options(path, allow string) *Prefix

+ func (p *Prefix) Patch(path string, h HandlerFunc) *Prefix

+ func (p *Prefix) Post(path string, h HandlerFunc) *Prefix

+ func (p *Prefix) Put(path string, h HandlerFunc) *Prefix

+ func (p *Prefix) Resource(pattern string, filter ...Filter) *Resource

+ type Resource struct

+ func (r *Resource) Delete(h HandlerFunc) *Resource

+ func (r *Resource) Get(h HandlerFunc) *Resource

+ func (r *Resource) Handle(h HandlerFunc, method ...string) *Resource

+ func (r *Resource) Options(allow string) *Resource

+ func (r *Resource) Patch(h HandlerFunc) *Resource

+ func (r *Resource) Post(h HandlerFunc) *Resource

+ func (r *Resource) Put(h HandlerFunc) *Resource

+ type ServiceState = service.State

type Tag

+ func (t *Tag) AddInit(f func() error, title string) *Tag

type Web

+ func (web *Web) Init(tag string, info *log.Logger) error

+ func (web *Web) Jobs() []*Job

+ func (web *Web) Logs() *logs.Logs

+ func (web *Web) NewModule(name, desc string, deps ...string) *Module

Oct 3, 2020

Changes in this version

+ const ContextKeyWeb

+ type Certificate struct

+ Cert string

+ Key string

+ type Config struct

+ Catalog catalog.Catalog

+ Certificates []*Certificate

+ ContextInterceptor func(*context.Context)

+ Debug *Debug

+ DisableHead bool

+ DisableOptions bool

+ IdleTimeout Duration

+ Logs *lc.Config

+ Marshalers map[string]mimetype.MarshalFunc

+ MaxHeaderBytes int

+ Plugins string

+ ReadHeaderTimeout Duration

+ ReadTimeout Duration

+ ResultBuilder context.BuildResultFunc

+ Results map[int]string

+ Root string

+ ShutdownSignal []os.Signal

+ ShutdownTimeout Duration

+ Static Map

+ TLSConfig *tls.Config

+ Timezone string

+ Unmarshalers map[string]mimetype.UnmarshalFunc

+ WriteTimeout Duration

+ XMLName struct{}

type Debug

+ Pprof string

+ Vars string

+ type Duration time.Duration

+ func (d *Duration) UnmarshalJSON(b []byte) error

+ func (d *Duration) UnmarshalXML(de *xml.Decoder, start xml.StartElement) error

+ func (d *Duration) UnmarshalYAML(u func(interface{}) error) error

+ func (d Duration) Duration() time.Duration

+ func (d Duration) MarshalJSON() ([]byte, error)

+ func (d Duration) MarshalXML(e *xml.Encoder, start xml.StartElement) error

+ func (d Duration) MarshalYAML() (interface{}, error)

+ type MODServer = module.Server

+ type Map map[string]string

+ func (p *Map) UnmarshalXML(d *xml.Decoder, start xml.StartElement) error

+ func (p Map) MarshalXML(e *xml.Encoder, start xml.StartElement) error

+ type Web struct

+ func GetWeb(ctx *Context) *Web

+ func New(conf *Config) (web *Web, err error)

+ func (web *Web) CTXServer() *context.Server

+ func (web *Web) Close() error

+ func (web *Web) HTTPServer() *http.Server

+ func (web *Web) InitModules(tag string) error

+ func (web *Web) Modules() []*Module

+ func (web *Web) Serve() (err error)

+ func (web *Web) Services() []*Service

+ func (web *Web) Tags() map[string][]string

Jun 15, 2019

Changes in this version

+ type ConfigManager = config.Manager

+ func NewConfigManager(dir string) (*ConfigManager, error)

May 30, 2019

Changes in this version

+ func Uptime() time.Time

May 21, 2019

Changes in this version

+ type SchedulerFunc = scheduled.JobFunc

+ type Tag = module.Tag

May 20, 2019

Changes in this version

+ const ConfigFilename

+ const LogsFilename

+ func Scheduled() *scheduled.Server

+ func Schedulers() []*scheduled.Job

+ type Scheduler = scheduled.Job

May 12, 2019

Changes in this version

+ func AddMessages(status int, messages map[int]string)

+ func Jobs() []*module.Job

+ func Location() *time.Location

+ func Now() time.Time

+ func ParseTime(layout, value string) (time.Time, error)

Mar 19, 2019

Changes in this version

+ const DefaultConfigFilename

+ const DefaultLogsFilename

+ func ErrorHandlers() *errorhandler.ErrorHandler

+ type ServiceFunc = module.ServiceFunc

Feb 21, 2019

Changes in this version

+ const CoreModuleName

+ func AddCompresses(m map[string]compress.WriterFunc) error

+ func Classic(dir string) error

+ func Server() *http.Server

+ func Services() []*module.Service

+ type Service = module.Service

Jan 2, 2019

Changes in this version

+ func InitModules(tag string) error

Jan 2, 2019

Changes in this version

+ func Path(path string) string

Dec 27, 2018

Changes in this version

+ func Messages(p *message.Printer) map[int]string

+ func NewMessages(status int, messages map[int]string)

Dec 16, 2018

Changes in this version

+ func Mimetypes() *mimetype.Mimetypes

+ func Tags() []string

Dec 10, 2018

Changes in this version

+ func AddMiddlewares(m ...middleware.Middleware)

+ func App() *app.App

+ func CRITICAL() *log.Logger

+ func Critical(v ...interface{})

+ func Criticalf(format string, v ...interface{})

+ func DEBUG() *log.Logger

+ func Debug(v ...interface{})

+ func Debugf(format string, v ...interface{})

+ func ERROR() *log.Logger

+ func Error(v ...interface{})

+ func Errorf(format string, v ...interface{})

+ func Fatal(v ...interface{})

+ func Fatalf(format string, v ...interface{})

+ func FlushLogs()

+ func INFO() *log.Logger

+ func Info(v ...interface{})

+ func Infof(format string, v ...interface{})

+ func Load(r io.Reader, typ string, v interface{}) error

+ func LoadFile(path string, v interface{}) error

+ func Panic(v ...interface{})

+ func Panicf(format string, v ...interface{})

+ func TRACE() *log.Logger

+ func Trace(v ...interface{})

+ func Tracef(format string, v ...interface{})

+ func WARN() *log.Logger

+ func Warn(v ...interface{})

+ func Warnf(format string, v ...interface{})

Nov 22, 2018

Changes in this version

+ func SetMiddlewares(m ...middleware.Middleware)

Sep 9, 2018

Changes in this version

+ func Mux() *mux.Mux

+ func RegisterOnShutdown(f func())

Sep 4, 2018

Changes in this version

+ const MinimumGoVersion

+ const Version

+ func AddCompress(name string, f compress.WriterFunc) error

+ func AddErrorHandler(f func(http.ResponseWriter, int), status ...int) error

+ func Close() error

+ func File(path string) string

+ func Grace(sig ...os.Signal)

+ func Handler() (http.Handler, error)

+ func Init(configDir string) (err error)

+ func Install(version string) error

+ func IsDebug() bool

+ func LoadConfig(path string, v interface{}) error

+ func Modules() []*module.Module

+ func Run() error

+ func Serve() error

+ func SetCompress(name string, f compress.WriterFunc)

+ func SetErrorHandler(f func(http.ResponseWriter, int), status ...int)

+ func SetMiddleware(m middleware.Middleware)

+ func Shutdown() error

+ func URL(path string) string

+ type Context = context.Context

+ func NewContext(w http.ResponseWriter, r *http.Request) *Context

+ type Module = module.Module

+ func NewModule(name, desc string, deps ...string) *Module

+ type Result = result.Result

+ func NewResult(code int) *Result