database/define/api2sql.go

// Package define ...
//
// Description : define ...
//
// Author : go_developer@163.com<白茶清欢>
//
// Date : 2024-08-21 16:05
package define

import "gorm.io/gorm"

// Api2SqlParam 接口转sql的输入配置
//
// Author : go_developer@163.com<白茶清欢>
//
// Date : 16:06 2024/8/21
//
// 一个合法的 sql 配置格式 :
//
// select 语句 : SELECT {FIELD_LIST} FROM {TABLE} WHERE {WHERE} ORDER BY {ORDER_FIELD} {ORDER_RULE} LIMIT {LIMIT} OFFSET {OFFSET}
//
// insert 语句 : INSERT INTO {TABLE} ({FIELD_LIST}) VALUES ({VALUE_LIST})
//
// update 语句 : UPDATE {TABLE} SET {SET} WHERE {WHERE} LIMIT {LIMIT} OFFSET {OFFSET} ORDER BY {ORDER_FIELD} {ORDER_RULE}
//
// delete 语句 : DELETE FROM {TABLE} WHERE {WHERE} LIMIT {LIMIT} OFFSET {OFFSET} ORDER BY {ORDER_FIELD} {ORDER_RULE}
//
// count 语句 : SELECT COUNT(*) as count FROM {TABLE} WHERE {WHERE}
type Api2SqlParam struct {
	DatabaseFlag      string               `json:"database_flag"`       // 数据库标识
	Table             string               `json:"table"`               // 操作的数据表
	ForceMaster       bool                 `json:"force_master"`        // 针对查询语句, 是否强制读主, 如果查询语句在事务中, 默认强制读主
	InputSql          string               `json:"input_sql"`           // 输入的sql模板, 仅依赖 ValueList 解析字段值, 依赖 split 相关解析分表配置
	TableSplit        bool                 `json:"table_split"`         // 是否分表
	SplitField        string               `json:"split_field"`         // 分表字段, 仅分表时有效, 分表字段要求在 ValueList 必须存在
	SplitStrategy     string               `json:"split_strategy"`      // 分表策略, 仅分表时有效, 支持注册自动以策略
	SqlType           string               `json:"sql_type"`            // sql语句类型 : detail - 查询详情 list - 查询列表  count - 查询数量 update - 更新 insert - 插入 delete - 删除
	ColumnTable       map[string]string    `json:"column_list"`         // 仅针对 select / detail 有效, 查询的字段列表, 字段名 => 字段别名, 不设置, 则以字段名输出
	Limit             int64                `json:"limit"`               // 操作数据量
	Offset            int64                `json:"offset"`              // 操作偏移量
	ForceNoLimit      bool                 `json:"force_no_limit"`      // 强制允许不限制 : 正常操作 select / delete / update 均需要指定本次操作数据量, 如果确定不限制, 此参数设置为 `true` , sqlType = list , 且 ForceNoLimit = true 时,  WithCount 参数无效
	OrderField        string               `json:"order_field"`         // 排序字段, 仅 sqlType = list 生效
	OrderRule         string               `json:"order_rule"`          // 排序规则, Asc / Desc
	WithCount         bool                 `json:"with_count"`          // 是否返回数据总量, 仅 sqlType = list 生效
	ValueList         []*Api2SqlParamValue `json:"value_list"`          // 字段列表
	TableColumnConfig []*ColumnInfo        `json:"table_column_config"` // 表字段配置
	Tx                *gorm.DB             `json:"-"`                   // 前后已有的数据库连接, 直接复用
}

// Api2SqlParamValue ...
//
// Author : go_developer@163.com<白茶清欢>
//
// Date : 16:11 2024/8/21
type Api2SqlParamValue struct {
	Column   string `json:"column"`  // 表字段
	Value    any    `json:"value"`   // 数据字段的值
	Operate  string `json:"operate"` // 操作符 : Equal , NotEqual , In , NotIn , Like, NotLike
	Alias    string `json:"alias"`   // 字段对外输出的名字, 不配置, 默认 与 Field 一致, 仅查询语句生效
	Default  any    `json:"-"`       // 默认值 TODO : 配置默认值生成策略
	DataMask any    `json:"-"`       // 数据脱敏策略
}

const (
	SqlSelectBaseTpl = `SELECT {FIELD_LIST} FROM {TABLE}`                         // select 语句基础模板
	SqlInsertBaseTpl = `INSERT INTO {TABLE} ({FIELD_LIST}) VALUES ({VALUE_LIST})` // Insert语句基础模板
	SqlUpdateBaseTpl = `UPDATE {TABLE} SET {SET}`                                 // Update语句基础模板
	SqlDeleteBaseTpl = `DELETE FROM {TABLE}`                                      // Delete语句基础模板
	SqlCountBaseTpl  = `SELECT COUNT(*) as count FROM {TABLE}`                    // Count语句基础模板
	SqlWhereTpl      = "WHERE {WHERE}"                                            // where 语句
	SqlOrder         = "ORDER BY {ORDER_FIELD} {ORDER_RULE}"                      // 排序语句
	SqlLimit         = "LIMIT {LIMIT}"                                            // limit 语句
	SqlOffset        = "OFFSET {OFFSET}"                                          // offset 语句
)