sql

type Error struct {
	dic.Errors

	// ConfigurationIsEmpty Конфигурация подключения к базе данных пустая.
	ConfigurationIsEmpty dic.IError

	// UnknownDatabaseDriver Указан неизвестный или не поддерживаемый драйвер базы данных: ...
	UnknownDatabaseDriver dic.IError

	// UsernameIsEmpty Не указано имя пользователя, для подключения к базе данных.
	UsernameIsEmpty dic.IError

	// WrongConnectionType Указан неизвестный или не поддерживаемый способ подключения к базе данных: ...
	WrongConnectionType dic.IError

	// ConnectError Подключение к базе данных завершилось ошибкой: ...
	ConnectError dic.IError

	// DriverUnImplemented Подключение к базе данных с помощью драйвера ... не создано.
	DriverUnImplemented dic.IError

	// ApplyMigration Применение новых миграций базы данных прервано, файл миграции ..., ошибка: ...
	ApplyMigration dic.IError

	// UnknownDialect Применение миграций базы данных, настройка диалекта ... прервано ошибкой: ...
	UnknownDialect dic.IError
}

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

type Interface interface {
	// Close Закрытие соединения с базой данных.
	Close() (err error)

	// E Ошибка соединения с базой данных.
	// Если err==nil - база данных доступна, соединение активно, ошибок нет.
	// Если err!=nil - есть проблема с соединением с базой данных.
	E() (err error)

	// Status Возвращает состояние подключения к базе данных.
	Status() (ret *sql.DBStats)

	// SqlDB Настроенный и готовый к работе бассейн соединений database/sql.
	// Если возвращается nil - есть ошибки, ошибка доступна в функции E()
	SqlDB() (ret *sql.DB)

	// GormDB Настроенный и готовый к работе объект ORM gorm.io/gorm.
	// Если возвращается nil - есть ошибки, ошибка доступна в функции E()
	GormDB() (ret *gorm.DB)

	// SqlxDB Настроенный и готовый к работе объект обёртки над соединением с БД github.com/jmoiron/sqlx.
	// Если возвращается nil - есть ошибки, ошибка доступна в функции E()
	SqlxDB() (ret *sqlx.DB)

	// MigrationUp Применение миграций базы данных.
	MigrationUp() (err error)

	// Errors Справочник ошибок.
	Errors() *Error
}

type ModelGorm interface {
	// TableName Явное указание названия таблицы.
	TableName() string

	// BeforeCreate Функция вызываемая до создания нового объекта в базе данных.
	BeforeCreate(tx *gorm.DB) (err error)

	// BeforeUpdate Функция вызываемая до обновления объекта в базе данных.
	BeforeUpdate(tx *gorm.DB) (err error)
}

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