mrserver

Documentation

Index

• Constants
• func MiddlewareGeneral(tr *mrlang.Translator, ...) func(next http.Handler) http.Handler
• func MiddlewareHandlerAdapter(s ErrorResponseSender) func(next HttpHandlerFunc) http.HandlerFunc
• func MiddlewareHandlerCheckAccess(handlerName string, access mrperms.AccessRightsFactory, ...) func(next HttpHandlerFunc) HttpHandlerFunc
• func MiddlewareHandlerIdempotency(provider mridempotency.Provider, sender ResponseSender) func(next HttpHandlerFunc) HttpHandlerFunc
• func MiddlewareRecoverHandler(isDebug bool, fatalFunc http.HandlerFunc) func(next http.Handler) http.Handler
• func TraceRequest(l mrlog.Logger, start time.Time, sr *StatRequestReader, sw *StatResponseWriter)
• type CacheableResponseWriter
  • func NewCacheableResponseWriter(w http.ResponseWriter) *CacheableResponseWriter
  • func (w *CacheableResponseWriter) Content() []byte
  • func (w *CacheableResponseWriter) StatusCode() int
  • func (w *CacheableResponseWriter) Write(buf []byte) (int, error)
  • func (w *CacheableResponseWriter) WriteHeader(statusCode int)
• type ErrorResponseSender
• type ErrorStatusGetter
• type FileResponseSender
• type HttpController
• type HttpErrorStatusGetter
  • func NewHttpErrorStatusGetter(unexpectedStatus int) *HttpErrorStatusGetter
  • func (g *HttpErrorStatusGetter) ErrorStatus(errorType mrcore.AnalyzedErrorType, err error) int
• type HttpHandler
• type HttpHandlerFunc
• type HttpRouter
• type RequestDecoder
• type RequestParserBool
• type RequestParserDateTime
• type RequestParserFile
• type RequestParserFloat64
• type RequestParserImage
• type RequestParserInt64
• type RequestParserItemStatus
• type RequestParserListPager
• type RequestParserListSorter
• type RequestParserParamFunc
• type RequestParserString
• type RequestParserUUID
• type RequestParserUint64
• type RequestParserValidate
• type ResponseEncoder
• type ResponseSender
• type StatRequestReader
  • func NewStatRequestReader(r *http.Request, bufferSize int) *StatRequestReader
  • func (r *StatRequestReader) Content() []byte
  • func (r *StatRequestReader) HasContent() bool
  • func (r *StatRequestReader) Request() *http.Request
  • func (r *StatRequestReader) Size() int
• type StatResponseWriter
  • func NewStatResponseWriter(w http.ResponseWriter, bufferSize int) *StatResponseWriter
  • func (w *StatResponseWriter) Content() []byte
  • func (w *StatResponseWriter) Size() int
  • func (w *StatResponseWriter) StatusCode() int
  • func (w *StatResponseWriter) Write(buf []byte) (int, error)
  • func (w *StatResponseWriter) WriteHeader(statusCode int)

Constants

const (
	VarRestOfURL = "{{restOfUrl}}" // VarRestOfURL - переменная остатка пути
)

Functions

func MiddlewareGeneral

func MiddlewareGeneral(
	tr *mrlang.Translator,
	observeRequestFunc func(l mrlog.Logger, start time.Time, sr *StatRequestReader, sw *StatResponseWriter),
) func(next http.Handler) http.Handler

MiddlewareGeneral - промежуточный обработчик, который устанавливает в контекст requestId, language, logger. А также другие параметры, которые используются в статистике запросов.

func MiddlewareHandlerAdapter

func MiddlewareHandlerAdapter(s ErrorResponseSender) func(next HttpHandlerFunc) http.HandlerFunc

MiddlewareHandlerAdapter - переходник с HttpHandlerFunc на http.HandlerFunc.

func MiddlewareHandlerCheckAccess

func MiddlewareHandlerCheckAccess(
	handlerName string,
	access mrperms.AccessRightsFactory,
	privilege, permission string,
) func(next HttpHandlerFunc) HttpHandlerFunc

MiddlewareHandlerCheckAccess - промежуточный обработчик проверки доступа к секции и конечному обработчику.

func MiddlewareHandlerIdempotency

func MiddlewareHandlerIdempotency(provider mridempotency.Provider, sender ResponseSender) func(next HttpHandlerFunc) HttpHandlerFunc

MiddlewareHandlerIdempotency - промежуточный обработчик для организации идемпотентных запросов.

func MiddlewareRecoverHandler

func MiddlewareRecoverHandler(isDebug bool, fatalFunc http.HandlerFunc) func(next http.Handler) http.Handler

MiddlewareRecoverHandler - промежуточный обработчик для перехвата panic.

func TraceRequest

func TraceRequest(l mrlog.Logger, start time.Time, sr *StatRequestReader, sw *StatResponseWriter)

TraceRequest - функция трассировки http запроса.

Types

type CacheableResponseWriter

type CacheableResponseWriter struct {
	http.ResponseWriter
	// contains filtered or unexported fields
}

CacheableResponseWriter - comment struct.

func NewCacheableResponseWriter

func NewCacheableResponseWriter(w http.ResponseWriter) *CacheableResponseWriter

NewCacheableResponseWriter - создаёт объект CacheableResponseWriter.

func (*CacheableResponseWriter) Content

func (w *CacheableResponseWriter) Content() []byte

Content - возвращает копию переданных данных.

func (*CacheableResponseWriter) StatusCode

func (w *CacheableResponseWriter) StatusCode() int

StatusCode - возвращает текущий код ответа.

func (*CacheableResponseWriter) Write

func (w *CacheableResponseWriter) Write(buf []byte) (int, error)

Write - записывает переданные данные.

func (*CacheableResponseWriter) WriteHeader

func (w *CacheableResponseWriter) WriteHeader(statusCode int)

WriteHeader - comment method.

type ErrorResponseSender

type ErrorResponseSender interface {
	SendError(w http.ResponseWriter, r *http.Request, err error)
}

ErrorResponseSender - отправляет ответ со списком ошибок полученных в результате обработки запроса.

type ErrorStatusGetter

type ErrorStatusGetter interface {
	ErrorStatus(errorType mrcore.AnalyzedErrorType, err error) int
}

ErrorStatusGetter - возвращает http статус на основе указанной ошибки.

type FileResponseSender

type FileResponseSender interface {
	ResponseSender
	SendFile(ctx context.Context, w http.ResponseWriter, file mrtype.File) error
	SendAttachmentFile(ctx context.Context, w http.ResponseWriter, file mrtype.File) error
}

FileResponseSender - отправляет ответ с данными в виде файла сформированные сервером.

type HttpController

type HttpController interface {
	Handlers() []HttpHandler
}

HttpController - http контроллер со списком его обработчиков.

type HttpErrorStatusGetter

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

HttpErrorStatusGetter - only for: 401, 403, 404, 418, 422, 5XX.

func NewHttpErrorStatusGetter

func NewHttpErrorStatusGetter(unexpectedStatus int) *HttpErrorStatusGetter

NewHttpErrorStatusGetter - создаёт объект HttpErrorStatusGetter.

func (*HttpErrorStatusGetter) ErrorStatus

func (g *HttpErrorStatusGetter) ErrorStatus(errorType mrcore.AnalyzedErrorType, err error) int

ErrorStatus - возвращает http код ответа на основе типа ошибки и самой ошибки.

type HttpHandler

type HttpHandler struct {
	Method     string
	URL        string
	Permission string
	Func       HttpHandlerFunc
}

HttpHandler - http обработчик, к которому привязаны метод, URL и разрешение контролирующее запуск этого обработчика.

type HttpHandlerFunc

type HttpHandlerFunc func(w http.ResponseWriter, r *http.Request) error

HttpHandlerFunc - изменённый дизайн стандартного HTTP обработчика с возможностью возврата ошибки вместо её обработки в самом обработчике.

type HttpRouter

type HttpRouter interface {
	RegisterMiddleware(handlers ...func(next http.Handler) http.Handler)
	Register(controllers ...HttpController)
	HandlerFunc(method, path string, handler http.HandlerFunc)
	ServeHTTP(w http.ResponseWriter, r *http.Request)
}

HttpRouter - роутинг запросов с их регистрацией и запуском.

type RequestDecoder

type RequestDecoder interface {
	ParseToStruct(ctx context.Context, content io.Reader, structPointer any) error
}

RequestDecoder - преобразователь данных в указанную go структуру.

type RequestParserBool

type RequestParserBool interface {
	FilterNullableBool(r *http.Request, key string) *bool
}

RequestParserBool - парсер данных запроса для преобразования их в *bool.

type RequestParserDateTime

type RequestParserDateTime interface {
	FilterDateTime(r *http.Request, key string) time.Time
}

RequestParserDateTime - парсер данных запроса для преобразования их в time.Time.

type RequestParserFile

type RequestParserFile interface {
	FormFile(r *http.Request, key string) (mrtype.File, error)
	FormFileContent(r *http.Request, key string) (mrtype.FileContent, error)
	FormFiles(r *http.Request, key string) ([]mrtype.FileHeader, error)
}

RequestParserFile - парсер данных запроса для преобразования их в файловую структуру.

type RequestParserFloat64

type RequestParserFloat64 interface {
	FilterFloat64(r *http.Request, key string) float64
	FilterRangeFloat64(r *http.Request, key string) mrtype.RangeFloat64
}

RequestParserFloat64 - парсер данных запроса для преобразования их во float64.

type RequestParserImage

type RequestParserImage interface {
	FormImage(r *http.Request, key string) (mrtype.Image, error)
	FormImageContent(r *http.Request, key string) (mrtype.ImageContent, error)
	FormImages(r *http.Request, key string) ([]mrtype.ImageHeader, error)
}

RequestParserImage - парсер данных запроса для преобразования их в файловую структуру изображения.

type RequestParserInt64

type RequestParserInt64 interface {
	FilterInt64(r *http.Request, key string) int64
	FilterRangeInt64(r *http.Request, key string) mrtype.RangeInt64
	FilterInt64List(r *http.Request, key string) []int64
}

RequestParserInt64 - парсер данных запроса для преобразования их в int64.

type RequestParserItemStatus

type RequestParserItemStatus interface {
	FilterStatusList(r *http.Request, key string) []mrenum.ItemStatus
}

RequestParserItemStatus - парсер данных запроса для преобразования их в []mrenum.ItemStatus.

type RequestParserListPager

type RequestParserListPager interface {
	PageParams(r *http.Request) mrtype.PageParams
}

RequestParserListPager - парсер данных запроса для преобразования их в mrtype.PageParams.

type RequestParserListSorter

type RequestParserListSorter interface {
	SortParams(r *http.Request, sorter mrview.ListSorter) mrtype.SortParams
}

RequestParserListSorter - парсер данных запроса для преобразования их в mrtype.SortParams.

type RequestParserParamFunc

type RequestParserParamFunc func(r *http.Request, key string) string

RequestParserParamFunc - функция для парсинга URL для извлечения из него параметров.

type RequestParserString

type RequestParserString interface {
	PathParamString(r *http.Request, name string) string
	RawParamString(r *http.Request, key string) *string // returns nil if the param not found
	FilterString(r *http.Request, key string) string
}

RequestParserString - парсер данных запроса для преобразования их в string.

type RequestParserUUID

type RequestParserUUID interface {
	PathParamUUID(r *http.Request, name string) uuid.UUID
	FilterUUID(r *http.Request, key string) uuid.UUID
}

RequestParserUUID - парсер данных запроса для преобразования их в uuid.UUID.

type RequestParserUint64

type RequestParserUint64 interface {
	PathParamUint64(r *http.Request, name string) uint64
	FilterUint64(r *http.Request, key string) uint64
	FilterUint64List(r *http.Request, key string) []uint64
}

RequestParserUint64 - парсер данных запроса для преобразования их в mrtype.Uint64.

type RequestParserValidate

type RequestParserValidate interface {
	Validate(r *http.Request, structPointer any) error
	ValidateContent(ctx context.Context, content []byte, structPointer any) error
}

RequestParserValidate - парсер данных запроса для преобразования их в go структуру.

type ResponseEncoder

type ResponseEncoder interface {
	ContentType() string
	ContentTypeProblem() string
	Marshal(structure any) ([]byte, error)
}

ResponseEncoder - формирует ответ сервера из go структуры в необходимом формате.

type ResponseSender

type ResponseSender interface {
	Send(w http.ResponseWriter, status int, structure any) error
	SendBytes(w http.ResponseWriter, status int, body []byte) error
	SendNoContent(w http.ResponseWriter) error
}

ResponseSender - отправляет ответ с данными сформированные сервером.

type StatRequestReader

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

StatRequestReader - псевдо декоратор http.Request для сбора статистики (кол-во прочитанных байт) и возможности логирования считанных данных.

func NewStatRequestReader

func NewStatRequestReader(r *http.Request, bufferSize int) *StatRequestReader

NewStatRequestReader - создаёт объект StatRequestReader. WARNING: the Body of the original http.Request can be replaced.

func (*StatRequestReader) Content

func (r *StatRequestReader) Content() []byte

Content - возвращает копию прочитанных данных.

func (*StatRequestReader) HasContent

func (r *StatRequestReader) HasContent() bool

HasContent - имеется ли у запроса тело.

func (*StatRequestReader) Request

func (r *StatRequestReader) Request() *http.Request

Request - возвращает оригинальный запрос.

func (*StatRequestReader) Size

func (r *StatRequestReader) Size() int

Size - возвращает размер считанных данных (bytes).

type StatResponseWriter

type StatResponseWriter struct {
	http.ResponseWriter
	// contains filtered or unexported fields
}

StatResponseWriter - декоратор http.ResponseWriter для сбора статистики (статуса, кол-во записанных байт) и возможности логирования записанных данных.

func NewStatResponseWriter

func NewStatResponseWriter(w http.ResponseWriter, bufferSize int) *StatResponseWriter

NewStatResponseWriter - создаёт объект StatResponseWriter.

func (*StatResponseWriter) Content

func (w *StatResponseWriter) Content() []byte

Content - возвращает копию переданных данных.

func (*StatResponseWriter) Size

func (w *StatResponseWriter) Size() int

Size - возвращает размер переданных данных (bytes).

func (*StatResponseWriter) StatusCode

func (w *StatResponseWriter) StatusCode() int

StatusCode - возвращает текущий код ответа.

func (*StatResponseWriter) Write

func (w *StatResponseWriter) Write(buf []byte) (int, error)

Write - записывает переданные данные, подсчитывая их размер в байтах.

func (*StatResponseWriter) WriteHeader

func (w *StatResponseWriter) WriteHeader(statusCode int)

WriteHeader - устанавливает код ответа.