rest

type API interface {
	// Получение информации о методе
	Info() *Info

	// Вызывается перед обращением к базе, используется, например, для добавления дополнительных параметров или проверок
	// Если возвращает code != 0 или data != nil, то они и будут результатом
	Before(proc *ProcOptions) (result any, code int, err error)

	// Вызывается почле обращения к базе, используется, например, для обогащения результата
	// Если возвращает code != 0 или data != nil, то они и будут результатом
	After(proc *ProcOptions) (result any, code int, err error)
}

type Enumerator func(path string, info *Info) (err error)

type ExecResult struct {
	AffectedRows int64  `json:"affectedRows" comment:"Количеcтво затронутых записей"`
	Notice       string `json:"notice,omitempty" comment:"Предупреждения и замечания"`
}

type FieldDef struct {
	JSONname string
	DBname   string
	Type     reflect.Kind
}

type FuncAfter func(proc *ProcOptions) (result any, code int, err error)

type FuncBefore func(proc *ProcOptions) (result any, code int, err error)

type FuncInit func(info *Info) (err error)

type Info struct {
	Path          string        // Относительный (от базового) путь в URL
	Name          string        // Имя, желательно  чтобы по правилам имен переменных
	Summary       string        // Краткое описание
	Description   string        // Описание, по умолчанию сформированное из Summary и query параметров
	Flags         path.Flags    // Флаги
	Methods       *path.Set     // Цепочки обработки
	Config        any           // Кастомные параметры в конфиг файле
	CacheLifetime time.Duration // Время жизни кэша, если 0, то не использовать
	DBtype        string        // Тип базы. Если пусто, то по умолчанию из конфига
	DBidx         int           // Индекс базы
	QueryPrefix   string        // Префикс имени запроса в базу
	Init          FuncInit      // User defined Init
	Before        FuncBefore    // User defined Before query
	After         FuncAfter     // User defined After query

}

type ProcOptions struct {
	LogFacility      *log.Facility       // Предпочтительная facility для логирования
	H                *stdhttp.HTTP       // HTTP листенер
	LogSrc           string              // Строка с ID запроса для MessageWithSource
	Info             *Info               // Информация о методе
	ID               uint64              // ID запроса
	Prefix           string              // Префикс пути запроса (при работе через прокси)
	Path             string              // Путь запроса
	R                *http.Request       // Запрос
	W                http.ResponseWriter // Интерфейс для ответа
	Chain            *path.Chain         // Обрабатываемая цепочка
	Scope            string              // Обрабатываемый Scope
	RawBody          []byte              // Тело запроса. В R.Body уже nil!
	PathParams       any                 // Path параметры
	QueryParams      any                 // Query параметры
	RequestParams    any                 // Request параметры
	DBqueryName      string              // Имя запроса к базе данных
	RequestBodyNames []string            // Для запросов в телом - полученные имена полей
	RequestBodyVals  []any               // и соответствующие им значения
	DBqueryVars      []any               // Переменные для заполнения запроса
	DBqueryResult    any                 // Результат выполненеия Query (слайс)
	Fields           misc.InterfaceMap   // Поля для insert или update
	Notices          *misc.Messages      // Предупреждения и замечания обработчика
	ExecResult       sql.Result          // Результат выполнения Exec
	Custom           any                 // Произвольные пользовательские данные
	// contains filtered or unexported fields
}