Documentation ¶
Index ¶
- Constants
- func Count(db DBer, tableName string, dest interface{}, where string, args ...interface{}) error
- func DeleteWhere(db DBer, tableName string, where string, args ...interface{}) (sql.Result, error)
- func DistinctIds(ids []string) []string
- func DistinctIdsStr(s string, split string) string
- func ExecForSql(db DBer, sql interface{}) (sql.Result, error)
- func FindAll(db DBer, sql interface{}, dest interface{}, fn ...SelectCallBackFn) error
- func FindOne(db DBer, sql interface{}, dest ...interface{}) error
- func FindOneFn(db DBer, sql interface{}, dest interface{}, fn ...SelectCallBackFn) error
- func FindWhere(db DBer, tableName string, dest interface{}, where string, args ...interface{}) error
- func FmtSqlStr(sqlStr string, args ...interface{}) string
- func GetLikeSqlStr(likeType uint8, sqlStr, fieldName, value string, printLog ...bool) string
- func GetSqlStr(sqlStr string, args ...interface{}) string
- func IndexForBF(isFont2End bool, s, substr string) int
- func InsertForObj(db DBer, tableName string, src ...interface{}) (sql.Result, error)
- func IsNullRow(err error) bool
- func NewCjLogger() *defaultLogger
- func SelectFindAll(db DBer, fields interface{}, tableName string, where string, dest interface{}, ...) error
- func SelectFindOne(db DBer, fields interface{}, tableName string, where string, ...) error
- func SelectFindOneFn(db DBer, fields interface{}, tableName string, where string, dest interface{}, ...) error
- func SelectFindOneIgnoreResult(db DBer, fields interface{}, tableName string, where string, dest interface{}, ...) error
- func SelectFindWhere(db DBer, fields interface{}, tableName string, dest interface{}, where string, ...) error
- func SetLogger(logger Logger)
- func Str(src interface{}) string
- func UpdateForObj(db DBer, tableName string, src interface{}, where string, args ...interface{}) (sql.Result, error)
- type DBer
- type Logger
- type SelectCallBackFn
- type SqlStrObj
- func (s *SqlStrObj) Append(sqlStr string, args ...interface{}) *SqlStrObj
- func (s *SqlStrObj) Clone() *SqlStrObj
- func (s *SqlStrObj) GetSqlStr(title ...string) (sqlStr string)
- func (s *SqlStrObj) GetTotalSqlStr(title ...string) (findSqlStr string)
- func (s *SqlStrObj) Int2Str(num int64) string
- func (s *SqlStrObj) LimitIsEmpty() bool
- func (s *SqlStrObj) SetAllLike(fieldName string, val string) *SqlStrObj
- func (s *SqlStrObj) SetBetween(fieldName string, leftVal, rightVal interface{}) *SqlStrObj
- func (s *SqlStrObj) SetCallerSkip(skip uint8) *SqlStrObj
- func (s *SqlStrObj) SetGroupByStr(groupByStr string) *SqlStrObj
- func (s *SqlStrObj) SetHaving(having string, args ...interface{}) *SqlStrObj
- func (s *SqlStrObj) SetInsertValues(args ...interface{}) *SqlStrObj
- func (s *SqlStrObj) SetInsertValuesArgs(sqlStr string, args ...interface{}) *SqlStrObj
- func (s *SqlStrObj) SetJoin(tableName string, on string, joinType ...uint8) *SqlStrObj
- func (s *SqlStrObj) SetLeftLike(fieldName string, val string) *SqlStrObj
- func (s *SqlStrObj) SetLimit(page, size int32) *SqlStrObj
- func (s *SqlStrObj) SetLimitStr(limitStr string) *SqlStrObj
- func (s *SqlStrObj) SetOrWhere(fieldName string, args ...interface{}) *SqlStrObj
- func (s *SqlStrObj) SetOrWhereArgs(sqlStr string, args ...interface{}) *SqlStrObj
- func (s *SqlStrObj) SetOrderByStr(orderByStr string) *SqlStrObj
- func (s *SqlStrObj) SetPrintLog(isPrint bool) *SqlStrObj
- func (s *SqlStrObj) SetRightLike(fieldName string, val string) *SqlStrObj
- func (s *SqlStrObj) SetUpdateValue(fieldName string, arg interface{}) *SqlStrObj
- func (s *SqlStrObj) SetUpdateValueArgs(sqlStr string, arg ...interface{}) *SqlStrObj
- func (s *SqlStrObj) SetWhere(fieldName string, args ...interface{}) *SqlStrObj
- func (s *SqlStrObj) SetWhereArgs(sqlStr string, args ...interface{}) *SqlStrObj
- func (s *SqlStrObj) SqlIsEmpty() bool
- func (s *SqlStrObj) SqlStrLen() int
- func (s *SqlStrObj) UInt2Str(num uint64) string
- func (s *SqlStrObj) ValueIsEmpty() bool
- func (s *SqlStrObj) ValueStrLen() int
- func (s *SqlStrObj) WhereIsEmpty() bool
- func (s *SqlStrObj) WhereStrLen() int
- type Table
- func (t *Table) Between(filedName string, leftVal, rightVal interface{}) *Table
- func (t *Table) Count(total interface{}) error
- func (t *Table) Delete(deleteObj ...interface{}) *Table
- func (t *Table) Exclude(tags ...string) *Table
- func (t *Table) Exec() (sql.Result, error)
- func (t *Table) FindAll(dest interface{}, fn ...SelectCallBackFn) error
- func (t *Table) FindOne(dest ...interface{}) error
- func (t *Table) FindOneFn(dest interface{}, fn ...SelectCallBackFn) error
- func (t *Table) FindOneIgnoreResult(dest interface{}, fn ...SelectCallBackFn) error
- func (t *Table) FindWhere(dest interface{}, where string, args ...interface{}) error
- func (t *Table) From(tableName string) *Table
- func (t *Table) GetSqlObj() *SqlStrObj
- func (t *Table) GroupBy(sqlStr string) *Table
- func (t *Table) Having(sqlStr string, args ...interface{}) *Table
- func (t *Table) Insert(insertObjs ...interface{}) *Table
- func (t *Table) IsPrintSql(is bool) *Table
- func (t *Table) Join(joinTable, on string, joinType ...uint8) *Table
- func (t *Table) Limit(page int32, size int32) *Table
- func (t *Table) NeedSetSize(need bool) *Table
- func (t *Table) OrWhere(sqlStr string, args ...interface{}) *Table
- func (t *Table) OrderBy(sqlStr string) *Table
- func (t *Table) PrintSqlCallSkip(skip uint8) *Table
- func (t *Table) Query(isNeedCache ...bool) (*sql.Rows, error)
- func (t *Table) QueryRowScan(dest ...interface{}) error
- func (t *Table) Raw(sql interface{}) *Table
- func (t *Table) Select(fields string) *Table
- func (t *Table) SelectAll() *Table
- func (t *Table) SelectAuto(src interface{}, tableName ...string) *Table
- func (t *Table) SelectCount() *Table
- func (t *Table) SetMarshalFn(fn marshalFn, tags ...string) *Table
- func (t *Table) SetUnmarshalFn(fn unmarshalFn, tags ...string) *Table
- func (t *Table) TagAlias(tag2AliasMap map[string]string) *Table
- func (t *Table) Update(updateObj interface{}, where string, args ...interface{}) *Table
- func (t *Table) Where(sqlStr string, args ...interface{}) *Table
- func (t *Table) WhereLike(likeType uint8, filedName, value string) *Table
Examples ¶
Constants ¶
const ( INSERT uint8 DELETE SELECT UPDATE // sql LIKE 语句 ALK // 全模糊 如: xxx LIKE "%xxx%" RLK // 右模糊 如: xxx LIKE "xxx%" LLK // 左模糊 如: xxx LIKE "%xxx" // sql join 语句 LJI // 左连接 RJI // 右连接 )
Variables ¶
This section is empty.
Functions ¶
func Count ¶ added in v1.4.0
Count 获取总数
Example ¶
var count int _ = Count(db, "man", &count, "id<?", 10) myPrint(count, false)
Output: 8
func DeleteWhere ¶ added in v1.4.9
DeleteWhere 根据条件删除
Example ¶
_, _ = DeleteWhere(db, "man", "id=100")
Output:
func DistinctIdsStr ¶
DistinctIdsStr 将输入拼接 id 参数按照指定字符进行去重, 如: DistinctIdsStr("12345,123,20,123,20,15", ",") => 12345,123,20,15
func ExecForSql ¶ added in v1.4.7
ExecForSql 根据 sql 进行执行 INSERT/UPDATE/DELETE 等操作 sql sqlStr 或 *SqlStrObj
Example ¶
// 新增 insertSql := NewCacheSql("INSERT INTO man (name,age,addr) VALUES") insertSql.SetInsertValues("test1", 18, "四川成都") if _, err := ExecForSql(db, insertSql); err != nil { myPrint(err, false) return } // 修改 updateSql := NewCacheSql("UPDATE man SET") updateSql.SetUpdateValue("name", "test12") updateSql.SetWhere("id", 8) if _, err := ExecForSql(db, updateSql); err != nil { myPrint(err, false) return } // 删除 deleteSql := NewCacheSql("DELETE FROM man WHERE id=100") if _, err := ExecForSql(db, deleteSql); err != nil { myPrint(err, false) return }
Output:
func FindAll ¶ added in v1.3.9
func FindAll(db DBer, sql interface{}, dest interface{}, fn ...SelectCallBackFn) error
FindAll 多查询 sql sqlStr 或 *SqlStrObj
func FindOne ¶ added in v1.3.9
FindOne 单查询 sql sqlStr 或 *SqlStrObj
Example ¶
var m Man sqlObj := NewCacheSql("SELECT name,age,addr FROM man WHERE id=?", 1) _ = FindOne(db, sqlObj, &m) myPrint(m, true)
Output: {"name":"测试1","age":20,"json_txt":{},"xml_txt":{},"json1_txt":{}}
func FindOneFn ¶ added in v1.4.9
func FindOneFn(db DBer, sql interface{}, dest interface{}, fn ...SelectCallBackFn) error
FindOneFn 单查询 sql sqlStr 或 *SqlStrObj
func FindWhere ¶ added in v1.4.2
func FindWhere(db DBer, tableName string, dest interface{}, where string, args ...interface{}) error
FindWhere 查询对象中的字段内容
Example ¶
var m Man _ = FindWhere(db, "man", &m, "id=?", 1) myPrint(m, true)
Output: {"id":1,"name":"测试1","age":20,"json_txt":{},"xml_txt":{},"json1_txt":{}}
func FmtSqlStr ¶
FmtSqlStr 适用直接获取 sqlStr, 不会打印日志
Example ¶
sqlStr := FmtSqlStr("SELECT * FROM ?v WHERE id IN (?d) AND name=?", "user_info", []string{"1", "2"}, "测试") fmt.Println(sqlStr)
Output: SELECT * FROM user_info WHERE id IN (1,2) AND name="测试"
func GetLikeSqlStr ¶
GetLikeSqlStr 针对 LIKE 语句, 只有一个条件 如: obj := GetLikeSqlStr(ALK, "SELECT id, username FROM sys_user", "name", "xue")
=> SELECT id, username FROM sys_user WHERE name LIKE "%xue%"
func IndexForBF ¶
IndexForBF 查找, 通过 BF 算法来获取匹配的 index isFont2End 是否从主串前向后遍历查找 如果匹配的内容靠前建议 isFont2End=true, 反之 false TODO 暂不支持中文
func InsertForObj ¶ added in v1.3.9
InsertForObj 根据对象新增
Example ¶
type Tmp struct { Id int32 `json:"id,omitempty"` Name string `json:"name,omitempty"` Age int32 `json:"age,omitempty"` Addr string `json:"addr,omitempty"` } m := Tmp{ Name: "xue1234", Age: 18, Addr: "成都市", } r, _ := InsertForObj(db, "man", m) rr, _ := r.RowsAffected() myPrint(rr, false)
Output: 1
func NewCjLogger ¶
func NewCjLogger() *defaultLogger
func SelectFindAll ¶ added in v1.5.5
func SelectFindAll(db DBer, fields interface{}, tableName string, where string, dest interface{}, fn ...SelectCallBackFn) error
SelectFindAll 多行指定内容查询 fields 可以字符串(如: "name,age,addr"), 同时也可以为 struct/struct slice(如: Man/[]Man), 会将 struct 的字段解析为查询内容
Example ¶
var m []Man _ = SelectFindAll(db, "id,name", "man", "id<3", &m) myPrint(m, true)
Output: [{"id":1,"name":"测试1","json_txt":{},"xml_txt":{},"json1_txt":{}},{"id":2,"name":"xue1","json_txt":{},"xml_txt":{},"json1_txt":{}}]
func SelectFindOne ¶ added in v1.5.1
func SelectFindOne(db DBer, fields interface{}, tableName string, where string, dest ...interface{}) error
SelectFindOne 单行指定内容查询 fields 可以字符串(如: "name,age,addr"), 同时也可以为 struct/struct slice(如: Man/[]Man), 会将 struct 的字段解析为查询内容
Example ¶
var m Man _ = SelectFindOne(db, "name,addr", "man", "id=1", &m) myPrint(m, true)
Output: {"name":"测试1","json_txt":{},"xml_txt":{},"json1_txt":{}}
func SelectFindOneFn ¶ added in v1.5.5
func SelectFindOneFn(db DBer, fields interface{}, tableName string, where string, dest interface{}, fn ...SelectCallBackFn) error
SelectFindOneFn 单行指定内容查询 fields 可以字符串(如: "name,age,addr"), 同时也可以为 struct/struct slice(如: Man/[]Man), 会将 struct 的字段解析为查询内容
Example ¶
var m Man _ = SelectFindOneFn(db, "name,age", "man", "id=1", &m, func(_row interface{}) error { v := _row.(*Man) v.Name = "被修改了哦" return nil }) myPrint(m, true)
Output: {"name":"被修改了哦","age":20,"json_txt":{},"xml_txt":{},"json1_txt":{}}
func SelectFindOneIgnoreResult ¶ added in v1.5.6
func SelectFindOneIgnoreResult(db DBer, fields interface{}, tableName string, where string, dest interface{}, fn ...SelectCallBackFn) error
SelectFindOneIgnoreResult 查询结果支持多个, 此使用场景为需要使用 SelectCallBackFn 对每行进行处理 fields 可以字符串(如: "name,age,addr"), 同时也可以为 struct/struct slice(如: Man/[]Man), 会将 struct 的字段解析为查询内容
Example ¶
var m Man var idMap = make(map[int32]string, 10) _ = SelectFindOneIgnoreResult(db, "id,name", "man", "id<10", &m, func(_row interface{}) error { v := _row.(*Man) idMap[v.Id] = v.Name return nil }) myPrint(idMap, true)
Output: {"1":"测试1","2":"xue1","3":"xue12","4":"xue123","5":"xue1234","6":"xue1234","7":"xue1234","8":"test12"}
func SelectFindWhere ¶ added in v1.4.4
func SelectFindWhere(db DBer, fields interface{}, tableName string, dest interface{}, where string, args ...interface{}) error
SelectFindWhere 查询指定内容的 fields 可以字符串(如: "name,age,addr"), 同时也可以为 struct/struct slice(如: Man/[]Man), 会将 struct 的字段解析为查询内容
Example ¶
var m Man _ = SelectFindWhere(db, "name,addr", "man", &m, "id=?", 1) myPrint(m, true)
Output: {"name":"测试1","json_txt":{},"xml_txt":{},"json1_txt":{}}
func UpdateForObj ¶ added in v1.3.9
func UpdateForObj(db DBer, tableName string, src interface{}, where string, args ...interface{}) (sql.Result, error)
UpdateForObj 根据对象更新
Example ¶
type Tmp struct { Id int32 `json:"id,omitempty"` Name string `json:"name,omitempty"` Age int32 `json:"age,omitempty"` Addr string `json:"addr,omitempty"` } m := Tmp{ Name: "xue1234", Age: 18, Addr: "成都市", } _, _ = UpdateForObj(db, "man", m, "id=7") // rr, _ := r.RowsAffected() // myPrint(rr, false) var b Tmp _ = SelectFindOne(db, "name,age,addr", "man", "id=7", &b) myPrint(b, true)
Output: {"name":"xue1234","age":18,"addr":"成都市"}
Types ¶
type DBer ¶
type DBer interface { Query(query string, args ...interface{}) (*sql.Rows, error) QueryRow(query string, args ...interface{}) *sql.Row Exec(query string, args ...interface{}) (sql.Result, error) }
DBer
type Logger ¶
type Logger interface { Info(v ...interface{}) Infof(format string, v ...interface{}) Error(v ...interface{}) Errorf(format string, v ...interface{}) Warning(v ...interface{}) Warningf(format string, v ...interface{}) }
Logger
type SelectCallBackFn ¶ added in v1.3.8
type SelectCallBackFn func(_row interface{}) error // 对每行查询结果进行取出处理
type SqlStrObj ¶
type SqlStrObj struct {
// contains filtered or unexported fields
}
SqlStrObj 拼接 sql 对象
func NewCacheSql ¶
NewCacheSql 初始化, 支持占位符, 此函数比 NewSql 更加高效(有缓存)
- 注意: a. 此函数只支持调用一次 GetSqlStr 方法, 如果要调用多次需要使用 NewSql b. 此函数不支持 Clone 方法, 如果要使用 Clone 需要调用 NewSql 说明: 是防止同一对象被两个协程共同使用
占位符为: ?, 直接根据 args 中类型来自动推动 arg 的类型 第一种用法: 根据 args 中类型来自动推动 arg 的类型 如: NewCacheSql("SELECT username, password FROM sys_user WHERE username = ? AND password = ?", "test", 123) => SELECT username, password FROM sys_user WHERE username = "test" AND password = 123
第二种用法: 当 arg 为 []int, 暂时支持 []int, []int32, []int64 如: NewCacheSql("SELECT username, password FROM sys_user WHERE id IN (?)", []int{1, 2, 3}) => SELECT username, password FROM sys_user WHERE id IN (1,2,3)
占位符为: ?d, 只会把数字型的字符串转为数字型, 如果是字母的话会被转义为 0, 如: "123" => 123; []string{"1", "2", "3"} => 1,2,3 第一种用法: 当 arg 为字符串时, 又想不加双引号就用这个 如: NewCacheSql("SELECT username, password FROM sys_user WHERE id = ?d", "123") => SELECT username, password FROM sys_user WHERE id = 123
第二种用法: 当 arg 为 []string, 又想把解析后的单个元素不加引号 如: NewCacheSql("SELECT username, password FROM sys_user WHERE id IN (?d)", []string{"1", "2", "3"}) => SELECT username, password FROM sys_user WHERE id IN (1,2,3)
- 占位符为: ?v, 这样会让字符串类型不加引号, 原样输出, 如: "test" => test; 第一种用法: 当 arg 为字符串时, 又想不加双引号就用这个, 注: 只支持 arg 为字符串类型 如: NewCacheSql("SELECT username, password FROM ?v WHERE id = ?d", "sys_user", "123") => SELECT username, password FROM sys_user WHERE id = 123
func (*SqlStrObj) GetSqlStr ¶
GetSqlStr 获取最终 sqlStr, 默认打印 sqlStr, title[0] 为打印 log 的标题; title[1] 为 sqlStr 的结束符, 默认为 ";" 注意: 通过 NewCacheSql 初始化对象的只能调用一次此函数, 因为调用后会清空所有buf; 通过 NewSql 初始化对象的可以调用多次此函数
func (*SqlStrObj) GetTotalSqlStr ¶
GetTotalSqlStr 将查询条件替换为 COUNT(*), 默认打印 sqlStr, title 为打印 log 的标题, 对外只支持一个参数, 多传没有用
func (*SqlStrObj) LimitIsEmpty ¶ added in v1.4.8
LimitIsEmpty 是否添加 limit
func (*SqlStrObj) SetAllLike ¶
SetAllLike 设置全模糊, 如: xxx LIKE "%test%"
func (*SqlStrObj) SetBetween ¶
SetBetween 设置 BETWEEN ? AND ?
func (*SqlStrObj) SetCallerSkip ¶
SetCallerSkip 设置打印调用跳过的层数
func (*SqlStrObj) SetGroupByStr ¶
SetGroupByStr 设置 groupBy
func (*SqlStrObj) SetInsertValues ¶
SetInsertValues 批量插入拼接, 如: xxx VALUES (xxx, xxx), (xxx, xxx)
func (*SqlStrObj) SetInsertValuesArgs ¶
SetInsertValuesArgs 支持占位符, 如 SetInsertValuesArg("(?, ?, ?d)", "test", "12345", "123456") 或 SetInsertValuesArg("?, ?, ?d", "test", "12345", "123456") => ("test", "123456", 123456) 批量插入拼接, 如: xxx VALUES (xxx, xxx), (xxx, xxx)
func (*SqlStrObj) SetLeftLike ¶
SetLeftLike 设置左模糊查询, 如: xxx LIKE "%test"
func (*SqlStrObj) SetLimitStr ¶
SetLimitStr 字符串来设置
func (*SqlStrObj) SetOrWhere ¶
SetOrWhere 设置过滤条件, 连接符为 OR 如果 len = 1 的时候, 会拼接成: filed = arg 如果 len = 2 的时候, 会拼接成: filed arg[0] arg[1]
func (*SqlStrObj) SetOrWhereArgs ¶
SetOrWhereArgs 支持占位符 如: SetOrWhereArgs("username = ? AND password = ?d", "test", "123") => xxx OR "username = "test" AND password = 123
func (*SqlStrObj) SetOrderByStr ¶
SetOrderByStr 设置排序
func (*SqlStrObj) SetPrintLog ¶
SetPrintLog 设置是否打印 sqlStr log
func (*SqlStrObj) SetRightLike ¶
SetRightLike 设置右模糊查询, 如: xxx LIKE "test%"
func (*SqlStrObj) SetUpdateValue ¶
SetUpdateValue update 语句中, 设置字段值
func (*SqlStrObj) SetUpdateValueArgs ¶
SetUpdateValueArgs 支持占位符 如: SetUpdateValueArgs("username = ?, age = ?d", "test", "20") => username = "test", age = 20
func (*SqlStrObj) SetWhere ¶
SetWhere 设置过滤条件, 连接符为 AND 如果 len = 1 的时候, 会拼接成: filed = arg 如果 len = 2 的时候, 会拼接成: filed arg[0] arg[1]
func (*SqlStrObj) SetWhereArgs ¶
SetWhereArgs 支持占位符 如: SetWhereArgs("username = ? AND password = ?d", "test", "123") => xxx AND "username = "test" AND password = 123
func (*SqlStrObj) ValueIsEmpty ¶
ValueIsEmpty insert/update 中 value 是否为空
type Table ¶
type Table struct {
// contains filtered or unexported fields
}
Table 表的信息
func NewTable ¶
NewTable 初始化, 通过 sync.Pool 缓存对象来提高性能 注: 使用 INSERT/UPDATE/DELETE/SELECT(SELECT 排除使用 Count)操作后该对象就会被释放, 如果继续使用会出现 panic args 支持两个参数 args[0]: 会解析为 tableName, 这里如果有值, 在进行操作表的时候就会以此表为准, 如果为空时, 在通过对象进行操作时按驼峰规则进行解析表名, 解析规则如: UserInfo => user_info args[1]: 会解析为待解析的 tag, 默认 defaultTableTag
func (*Table) Exclude ¶ added in v1.5.7
Exclude 对于 INSERT/UPDATE/DELETE/SELECT 操作中通过解析对象需要过滤的字段 注: 调用必须优先 Insert/Update/Delete/SelectAuto 操作的方法, 防止通过对象解析字段时失效
func (*Table) FindAll ¶
func (t *Table) FindAll(dest interface{}, fn ...SelectCallBackFn) error
FindAll 多行查询 如果没有指定查询条数, 默认 defaultBatchSelectSize dest 支持(struct/单字段/map)切片 fn 支持将查询结果行进行处理, 需要处理每行内容时, fn 回调的 _row 需要类型断言为[切片中的类型]
func (*Table) FindOne ¶
FindOne 单行查询 注: 如果为空的话, 会返回 nullRowErr dest 长度 > 1 时, 支持多个字段查询 dest 长度 == 1 时, 支持 struct/单字段/map
func (*Table) FindOneFn ¶ added in v1.4.9
func (t *Table) FindOneFn(dest interface{}, fn ...SelectCallBackFn) error
FindOneFn 单行查询 注: 如果为空的话, 会返回 nullRowErr dest 支持 struct/单字段/map fn 支持将查询结果行进行修改, 需要修改的时候 fn 回调的 _row 需要类型断言为[指针]对象才能处理
func (*Table) FindOneIgnoreResult ¶ added in v1.5.6
func (t *Table) FindOneIgnoreResult(dest interface{}, fn ...SelectCallBackFn) error
FindOneIgnoreResult 查询结果支持多个, 此使用场景为需要使用 SelectCallBackFn 对每行进行处理 注: 因为查询的结果集为多个, dest 不为切片, 所有这个结果是不准确的 dest 支持 struct/map fn 支持将查询结果行进行修改, 需要修改的时候 fn 回调的 _row 需要类型断言为[指针]对象才能处理
func (*Table) FindWhere ¶ added in v1.3.6
FindWhere 如果没有添加查询字段内容, 会根据输入对象进行解析查询 注: 如果为单行查询的话, 当为空的话, 会返回 nullRowErr 如果没有指定查询条数, 默认 defaultBatchSelectSize dest 支持 struct/slice/单字段/map
func (*Table) IsPrintSql ¶ added in v1.3.6
IsPrintSql 是否打印 sql
func (*Table) Join ¶ added in v1.5.11
Join 连表查询 说明: 连表查询时, 如果两个表有相同字段名查询结果会出现错误 解决方法: 1. 推荐使用别名来区分; 2. 使用 Query 对结果我们自己进行处理
func (*Table) NeedSetSize ¶ added in v1.4.9
NeedSetSize 查询的时候, 是否需要设置默认 size
func (*Table) OrWhere ¶
OrWhere 支持占位符 如: OrWhere("username = ? AND password = ?d", "test", "123") => xxx OR "username = "test" AND password = 123
func (*Table) PrintSqlCallSkip ¶ added in v1.4.7
PrintSqlCallSkip 用于 sql 打印时候显示调用处的信息
func (*Table) QueryRowScan ¶
QueryRowScan 单行多值查询
func (*Table) Raw ¶
Raw 执行原生操作 sql sqlStr 或 *SqlStrObj 说明: 在使用时, 设置了 tableName 时查询性能更好, 因为在调用 getScanValues 前需要 通过 tableName 获取表元信息, 再判断字段是否为 NULL, 在没有表元信息时会将所有查询结果都按 NULL 类型处理
func (*Table) SelectAuto ¶ added in v1.4.7
SelectAuto 根据输入类型进行自动推断要查询的字段值 src 如下:
- 为 string 的话会被直接解析成查询字段
- 为 struct/struct slice 会按 struct 进行解析, 查询字段为 struct 的 tag, 同时会过滤掉非当前表字段名
- 其他情况会被解析为查询所有
func (*Table) SetMarshalFn ¶ added in v1.5.5
SetMarshalFn 设置 struct 字段待序列化方法 注: 调用必须优先 Insert/Update 操作的方法, 防止通过对象解析字段时被排除
func (*Table) SetUnmarshalFn ¶ added in v1.5.5
SetUnmarshalFn 设置 struct 字段待反序列化方法 注: 调用必须优先于 SelectAuto, 防止 SelectAuto 解析时查询字段被排除
func (*Table) TagAlias ¶ added in v1.5.8
TagAlias 设置 struct 字段别名, 默认是按字段的 tag 名 注: 调用必须优先 Insert/Update/Delete/SelectAuto 操作的方法, 防止通过对象解析字段时失效 tag2AliasMap key: struct 的 tag 名, value: 表的列名