spellsql

package module
v1.4.3 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Apr 6, 2022 License: MulanPSL-2.0 Imports: 13 Imported by: 0

README

1. 介绍

  • 通过 sync.Pool, strings.Builder 等实现的高性能sql拼接工具
  • 自动打印 sql 最终的 log
  • 非法字符会自动转移
  • 安装:
    go get -u gitee.com/xuesongtao/spellsql

2. 占位符

  • 目前支持占位符 ?, ?d, ?v, 说明如下:

2.1 占位符 ?

  • 直接根据 args 中类型来自动推动 arg 的类型, 使用如下:
    1. 第一种用法: 根据 args 中类型来自动推动 arg 的类型
        如: NewCacheSql("SELECT username, password FROM sys_user WHERE username = ? AND password = ?", "test", 123).GetSqlStr()
        => SELECT username, password FROM sys_user WHERE username = "test" AND password = 123
    ```

    2. 第二种用法: 当 arg 为 []int, 暂时支持 []int, []int32, []int64
    


    如: NewCacheSql("SELECT username, password FROM sys_user WHERE id IN (?)", []int{1, 2, 3}).GetSqlStr()
    => SELECT username, password FROM sys_user WHERE id IN (1,2,3)
```

2.2 占位符 ?d

  • 只会把数字型的字符串转为数字型, 如果是字母的话会被转义为 0, 如: "123" => 123; []string{"1", "2", "3"} => 1,2,3, 如下: 第一种用法: 当 arg 为字符串时, 又想不加双引号就用这个
        如: NewCacheSql("SELECT username, password FROM sys_user WHERE id = ?d", "123").GetSqlStr()
        => 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"}).GetSqlStr()
    => SELECT username, password FROM sys_user WHERE id IN (1,2,3)
```

2.3 占位符为: ?v

  • 这样会让字符串类型不加引号, 原样输出, 如: "test" => test; 第一种用法: 当 arg 为字符串时, 又想不加双引号就用这个, 注: 只支持 arg 为字符串类型
        如: NewCacheSql("SELECT username, password FROM ?v WHERE id = ?d", "sys_user", "123").GetSqlStr()
        => SELECT username, password FROM sys_user WHERE id = 123
    ```

    第二种用法: 子查询
    


    如: NewCacheSql("SELECT u.username, u.password FROM sys_user su LEFT JOIN user u ON su.id = u.id WHERE u.id IN (?v)", FmtSqlStr("SELECT id FROM user WHERE name=?", "test").GetSqlStr()
    => SELECT u.username, u.password FROM sys_user su LEFT JOIN user u ON su.id = u.id WHERE u.id IN (SELECT id FROM user WHERE name="test");
```
  • 注: 由于这种不会进行转义处理, 所有这种不推荐用于请求输入(外部非法输入)的内容, 会出现 SQL 注入风险; 当我们明确知道参数是干什么的可以使用会简化我们代码, 这里就不进行演示.

3. spellsql 使用

  • 可以参考 getsqlstr_test.go 里的测试方法

3.1 新增

    s := NewCacheSql("INSERT INTO sys_user (username, password, name)")
    s.SetInsertValues("xuesongtao", "123456", "阿桃")
    s.SetInsertValues("xuesongtao", "123456", "阿桃")
    s.GetSqlStr()

    // Output:
    // INSERT INTO sys_user (username, password, name) VALUES ("test", 123456, "阿涛"), ("xuesongtao", "123456", "阿桃"), ("xuesongtao", "123456", "阿桃");

3.2 删除

    s := NewCacheSql("DELETE FROM sys_user WHERE id = ?", 123)
    if true {
        s.SetWhere("name", "test")
    }
    s.GetSqlStr()

    // Output:
    // DELETE FROM sys_user WHERE id = 123 AND name = "test";

3.3 查询

    s := NewCacheSql("SELECT * FROM user u LEFT JOIN role r ON u.id = r.user_id")
    s.SetOrWhere("u.name", "xue")
    s.SetOrWhereArgs("(r.id IN (?d))", []string{"1", "2"})
    s.SetWhere("u.age", ">", 20)
    s.SetWhereArgs("u.addr = ?", "南部")
    s.GetTotalSqlStr()
    s.SetLimit(1, 10)
    s.GetSqlStr()

    // Output:
    // sqlTotalStr: SELECT COUNT(*) FROM user u LEFT JOIN role r ON u.id = r.user_id WHERE u.name = "xue" OR (r.id IN (1,2)) AND u.age > 20 AND u.addr = "南部";
    // sqlStr: SELECT * FROM user u LEFT JOIN role r ON u.id = r.user_id WHERE u.name = "xue" OR (r.id IN (1,2)) AND u.age > 20 AND u.addr = "南部" LIMIT 0, 10;

3.4 修改

	s := NewCacheSql("UPDATE sys_user SET")
    idsStr := []string{"1", "2", "3", "4", "5"}
	s.SetUpdateValue("name", "xue")
	s.SetUpdateValueArgs("age = ?, score = ?", 18, 90.5)
	s.SetWhereArgs("id IN (?d) AND name = ?", idsStr, "tao")
    s.GetSqlStr()

    // Output:
    // UPDATE sys_user SET name = "xue", age = 18, score = 90.50 WHERE id IN (1,2,3,4,5) AND name = "tao";

3.5 追加

    s := NewCacheSql("INSERT INTO sys_user (username, password, age)")
	s.SetInsertValuesArgs("?, ?, ?d", "xuesongtao", "123", "20")
	s.Append("ON DUPLICATE KEY UPDATE username=VALUES(username)")
	s.GetSqlStr()

    // Output:
    // INSERT INTO sys_user (username, password, age) VALUES ("xuesongtao", "123", 20) ON DUPLICATE KEY UPDATE username=VALUES(username);

3.6 复用

    1. NewCacheSql() 获取的对象在调用 GetSqlStr() 后会重置并放入内存池, 是不能对结果进行再进行 GetSqlStr(), 当然你是可以对结果作为 NewCacheSql() 的入参进行使用以此达到复用, 这样代码看起来不是多优雅, 分页处理案例如下:
    sqlObj := NewCacheSql("SELECT * FROM user_info WHERE status = 1")
	handleFn := func(obj *SqlStrObj, page, size int32) {
		// 业务代码
		fmt.Println(obj.SetLimit(page, size).SetPrintLog(false).GetSqlStr())
	}

	// 每次同步大小
	var (
		totalNum  int32 = 30
		page      int32 = 1
		size      int32 = 10
		totalPage int32 = int32(math.Ceil(float64(totalNum / size)))
	)
	sqlStr := sqlObj.SetPrintLog(false).GetSqlStr("", "")
	for page <= totalPage {
		handleFn(NewCacheSql(sqlStr), page, size)
		page++
	}

    // Output:
    // SELECT * FROM user_info WHERE u_status = 1 LIMIT 0, 10;
    // SELECT * FROM user_info WHERE u_status = 1 LIMIT 10, 10;
    // SELECT * FROM user_info WHERE u_status = 1 LIMIT 20, 10;
  • NewSql() 的产生的对象不会放入内存池, 可以进行多次调用 GetSqlStr(), 对应上面的示例可以使用 NewSql() 再调用 Clone() 进行处理, 如下:
    sqlObj := NewSql("SELECT u_name, phone, account_id FROM user_info WHERE u_status = 1")
	handleFn := func(obj *SqlStrObj, page, size int32) {
		// 业务代码
		fmt.Println(obj.SetLimit(page, size).SetPrintLog(false).GetSqlStr())
	}

	// 每次同步大小
	var (
		totalNum  int32 = 30
		page      int32 = 1
		size      int32 = 10
		totalPage int32 = int32(math.Ceil(float64(totalNum / size)))
	)
	for page <= totalPage {
		handleFn(sqlObj.Clone(), page, size)
		page++
	}

    // Output:
    // SELECT * FROM user_info WHERE u_status = 1 LIMIT 0, 10;
    // SELECT * FROM user_info WHERE u_status = 1 LIMIT 10, 10;
    // SELECT * FROM user_info WHERE u_status = 1 LIMIT 20, 10;

4 支持简易的 orm

  • 支持自定义 tag, 默认 json
    type Man struct {
        Id   int32  `json:"id,omitempty"`
        Name string `json:"name,omitempty"`
        Age  int32  `json:"age,omitempty"`
        Addr string `json:"addr,omitempty"`
    }

4.1 新增

	Name: "xue1234",
		Age:  18,
		Addr: "成都市",
	}
	rows, err := NewTable(db).Insert(m)
	if err != nil {
		t.Log(err)
		return
	}

4.2 删除

    m := Man{
		Id: 1,
	}
	rows, err := NewTable(db).Delete(m).Exec()
	if err != nil {
		t.Log(err)
		return
	}
	t.Log(rows.LastInsertId())

4.3 修改

    m := Man{
		Name: "xuesongtao",
		Age:  20,
		Addr: "测试",
	}
	rows, err := NewTable(db).Update(m).Where("id=?", 1).Exec()
	if err != nil {
		t.Log(err)
		return
	}

4.4 查询

4.4.1 单查询
   var m Man
	err := NewTable(db, "man").Select("*").Where("id=?", 1).FindOne(&m)
	if err != nil {
		t.Fatal(err)
	}
	t.Logf("%+v", m)
4.4.2 多条记录查询
    var m []*Man
	err := NewTable(db, "man").Select("id,name,age,addr").Where("id>?", 1).FindAll(&m)
	if err != nil {
		t.Fatal(err)
	}
	t.Logf("%+v", m)

4.5 补充

  • 其中做几个性能对比: 原生 < spellsql_orm < gorm(orm_test.go里有测试数据, 功能较少, 场景有限, 望大佬莫笑), 如果要测试可以在dev分支上

其他

  • 欢迎大佬们指正, 希望大佬给 star

Documentation

Index

Constants

View Source 
const (
	INSERT uint8
	DELETE
	SELECT
	UPDATE

	// sql LIKE 语句
	ALK // 全模糊 如: xxx LIKE "%xxx%"
	RLK // 右模糊 如: xxx LIKE "xxx%"
	LLK // 左模糊 如: xxx LIKE "%xxx"
)

Variables

This section is empty.

Functions

func Count added in v1.4.0 

func Count(db DBer, tableName string, dest interface{}, where string, args ...interface{}) error

Count 获取总数

func DeleteForObj added in v1.3.9 

func DeleteForObj(db DBer, tableName string, obj interface{}) (sql.Result, error)

DeleteForObj 根据对象删除

func DeleteForSql added in v1.3.9 

func DeleteForSql(db DBer, sql interface{}) (sql.Result, error)

DeleteForSql 根据 sql 删除 sql sqlStr 或 *SqlStrObj

func DistinctIdsStr 

func DistinctIdsStr(s string, split string) string

DistinctIdsStr 将输入拼接 id 参数按照指定字符进行去重, 如: DistinctIdsStr("12345,123,20,123,20,15", ",") => 12345,123,20,15

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 

func FindOne(db DBer, sql interface{}, dest ...interface{}) error

FindOne 单查询 sql sqlStr 或 *SqlStrObj

func FindWhere added in v1.4.2 

func FindWhere(db DBer, tableName string, obj interface{}, where string, args ...interface{}) error

FindWhere 查询对象中的字段内容

func FmtSqlStr 

func FmtSqlStr(sqlStr string, args ...interface{}) string

FmtSqlStr 适用直接获取 sqlStr, 不会打印日志

func GetLikeSqlStr 

func GetLikeSqlStr(likeType uint8, sqlStr, filedName, value string, printLog ...bool) string

GetLikeSqlStr 针对 LIKE 语句, 只有一个条件 如: obj := GetLikeSqlStr(ALK, "SELECT id, username FROM sys_user", "name", "xue") 

=> SELECT id, username FROM sys_user WHERE name LIKE "%xue%"

func GetSqlStr 

func GetSqlStr(sqlStr string, args ...interface{}) string

GetSqlStr 适用直接获取 sqlStr, 每次会自动打印日志

func IndexForBF 

func IndexForBF(isFont2End bool, s, substr string) int

IndexForBF 查找, 通过 BF 算法来获取匹配的 index isFont2End 是否从主串前向后遍历查找 如果匹配的内容靠前建议 isFont2End=true, 反之 false todo 暂时只能匹配英文

func InsertForObj added in v1.3.9 

func InsertForObj(db DBer, tableName string, obj ...interface{}) (sql.Result, error)

InsertForObj 根据对象新增

func InsertForSql added in v1.3.9 

func InsertForSql(db DBer, sql interface{}) (sql.Result, error)

InsertForSql 根据 sql 新增 sql sqlStr 或 *SqlStrObj

func NewCjLogger 

func NewCjLogger() *defaultLogger

func SetLogger 

func SetLogger(logger Logger)

func UpdateForObj added in v1.3.9 

func UpdateForObj(db DBer, tableName string, obj interface{}) (sql.Result, error)

UpdateForObj 根据对象更新

func UpdateForSql added in v1.3.9 

func UpdateForSql(db DBer, sql interface{}) (sql.Result, error)

UpdateForSql 根据 sql 更新 sql sqlStr 或 *SqlStrObj

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 

func NewCacheSql(sqlStr string, args ...interface{}) *SqlStrObj

NewCacheSql 初始化, 支持占位符, 此函数比 NewSql 更加高效

  1. 注意: a. sqlStr 字符长度必须大于 6 b. 此函数只支持调用一次 GetSqlStr 方法, 如果要调用多次需要使用 NewSql c. 此函数不支持 Clone 方法, 如果要使用 Clone 需要调用 NewSql 说明: b, c 是防止同一对象被两个协程共同使用

  1. 占位符为: ?, 直接根据 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)

  1. 占位符为: ?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)

  1. 占位符为: ?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 NewSql 

func NewSql(sqlStr string, args ...interface{}) *SqlStrObj

NewSql 此函数与 NewCacheSql 功能一样, 此函数的使用场景: 1. 需要调用多次 GetSqlStr; 2. 需要调用 Clone

func (*SqlStrObj) Append 

func (s *SqlStrObj) Append(sqlStr string, args ...interface{}) *SqlStrObj

Append 将类型追加在最后

func (*SqlStrObj) Clone 

func (s *SqlStrObj) Clone() *SqlStrObj

Clone 克隆对象. 注意: 如果是 NewCacheSql 初始化将返回 nil, 需要采用 NewSql 进行初始化

func (*SqlStrObj) GetSqlStr 

func (s *SqlStrObj) GetSqlStr(title ...string) (sqlStr string)

GetSqlStr 获取最终 sqlStr, 默认打印 sqlStr, title[0] 为打印 log 的标题; title[1] 为 sqlStr 的结束符, 默认为 ";" 注意: 通过 NewCacheSql 初始化对象的只能调用一次此函数, 因为调用后会清空所有buf; 通过 NewSql 初始化对象的可以调用多次此函数

func (*SqlStrObj) GetTotalSqlStr 

func (s *SqlStrObj) GetTotalSqlStr(title ...string) (findSqlStr string)

GetTotalSqlStr 将查询条件替换为 COUNT(*), 默认打印 sqlStr, title 为打印 log 的标题, 对外只支持一个参数, 多传没有用

func (*SqlStrObj) Int2Str 

func (s *SqlStrObj) Int2Str(num int64) string

Int2Str 数字转字符串

func (*SqlStrObj) SetAllLike 

func (s *SqlStrObj) SetAllLike(filedName string, val string)

SetAllLike 设置全模糊, 如: xxx LIKE "%test%"

func (*SqlStrObj) SetBetween 

func (s *SqlStrObj) SetBetween(filedName string, leftVal, rightVal interface{}) *SqlStrObj

SetBetween 设置 BETWEEN ? AND ?

func (*SqlStrObj) SetCallerSkip 

func (s *SqlStrObj) SetCallerSkip(skip uint8) *SqlStrObj

SetCallerSkip 设置打印调用跳过的层数

func (*SqlStrObj) SetGroupByStr 

func (s *SqlStrObj) SetGroupByStr(groupByStr string) *SqlStrObj

SetGroupByStr 设置 groupBy

func (*SqlStrObj) SetInsertValues 

func (s *SqlStrObj) SetInsertValues(args ...interface{}) *SqlStrObj

SetInsertValues 批量插入拼接, 如: xxx VALUES (xxx, xxx), (xxx, xxx)

func (*SqlStrObj) SetInsertValuesArgs 

func (s *SqlStrObj) SetInsertValuesArgs(sqlStr string, args ...interface{}) *SqlStrObj

SetInsertValuesArgs 支持占位符, 如 SetInsertValuesArg("(?, ?, ?d)", "test", "12345", "123456") 或 SetInsertValuesArg("?, ?, ?d", "test", "12345", "123456") => ("test", "123456", 123456) 批量插入拼接, 如: xxx VALUES (xxx, xxx), (xxx, xxx)

func (*SqlStrObj) SetLeftLike 

func (s *SqlStrObj) SetLeftLike(filedName string, val string)

SetLeftLike 设置左模糊查询, 如: xxx LIKE "%test"

func (*SqlStrObj) SetLimit 

func (s *SqlStrObj) SetLimit(page, size int32) *SqlStrObj

SetLimit 设置分页

func (*SqlStrObj) SetLimitStr 

func (s *SqlStrObj) SetLimitStr(limitStr string) *SqlStrObj

SetLimitStr 字符串来设置

func (*SqlStrObj) SetOrWhere 

func (s *SqlStrObj) SetOrWhere(filedName string, args ...interface{}) *SqlStrObj

SetOrWhere 设置过滤条件, 连接符为 OR 如果 len = 1 的时候, 会拼接成: filed = arg 如果 len = 2 的时候, 会拼接成: filed arg[0] arg[1]

func (*SqlStrObj) SetOrWhereArgs 

func (s *SqlStrObj) SetOrWhereArgs(sqlStr string, args ...interface{}) *SqlStrObj

SetOrWhereArgs 支持占位符 如: SetOrWhereArgs("username = ? AND password = ?d", "test", "123") => xxx OR "username = "test" AND password = 123

func (*SqlStrObj) SetOrderByStr 

func (s *SqlStrObj) SetOrderByStr(orderByStr string) *SqlStrObj

SetOrderByStr 设置排序

func (*SqlStrObj) SetPrintLog 

func (s *SqlStrObj) SetPrintLog(isPrint bool) *SqlStrObj

SetPrintLog 设置是否打印 sqlStr log

func (*SqlStrObj) SetRightLike 

func (s *SqlStrObj) SetRightLike(filedName string, val string)

SetRightLike 设置右模糊查询, 如: xxx LIKE "test%"

func (*SqlStrObj) SetUpdateValue 

func (s *SqlStrObj) SetUpdateValue(filedName string, arg interface{}) *SqlStrObj

SetUpdateValue update 语句中, 设置字段值

func (*SqlStrObj) SetUpdateValueArgs 

func (s *SqlStrObj) SetUpdateValueArgs(sqlStr string, arg ...interface{}) *SqlStrObj

SetUpdateValueArgs 支持占位符 如: SetUpdateValueArgs("username = ?, age = ?d", "test", "20") => username = "test", age = 20

func (*SqlStrObj) SetWhere 

func (s *SqlStrObj) SetWhere(filedName string, args ...interface{}) *SqlStrObj

SetWhere 设置过滤条件, 连接符为 AND 如果 len = 1 的时候, 会拼接成: filed = arg 如果 len = 2 的时候, 会拼接成: filed arg[0] arg[1]

func (*SqlStrObj) SetWhereArgs 

func (s *SqlStrObj) SetWhereArgs(sqlStr string, args ...interface{}) *SqlStrObj

SetWhereArgs 支持占位符 如: SetWhereArgs("username = ? AND password = ?d", "test", "123") => xxx AND "username = "test" AND password = 123

func (*SqlStrObj) SqlIsEmpty 

func (s *SqlStrObj) SqlIsEmpty() bool

SqlIsEmpty sql 是否为空

func (*SqlStrObj) SqlStrLen 

func (s *SqlStrObj) SqlStrLen() int

SqlStrLen sql 的总长度

func (*SqlStrObj) UInt2Str 

func (s *SqlStrObj) UInt2Str(num uint64) string

UInt2Str

func (*SqlStrObj) ValueIsEmpty 

func (s *SqlStrObj) ValueIsEmpty() bool

ValueIsEmpty insert/update 中 value 是否为空

func (*SqlStrObj) ValueStrLen 

func (s *SqlStrObj) ValueStrLen() int

ValueStrLen valueBuf 长度

func (*SqlStrObj) WhereIsEmpty 

func (s *SqlStrObj) WhereIsEmpty() bool

WhereIsEmpty 判断where条件是否为空

func (*SqlStrObj) WhereStrLen 

func (s *SqlStrObj) WhereStrLen() int

WhereStrLen where 条件内容长度

type Table 

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

func NewTable 

func NewTable(db DBer, args ...string) *Table

NewTable 初始化 args 支持两个参数 args[0]: 会解析为 tableName, 这里如果有值, 在进行操作表的时候就会以此表为准, 如果为空时, 在通过对象进行操作时按驼峰规则进行解析表名, 解析规则如: UserInfo => user_info args[1]: 会解析为待解析的 tag

func (*Table) Count 

func (t *Table) Count(total interface{}) error

Count 获取总数

func (*Table) Delete 

func (t *Table) Delete(deleteObj ...interface{}) *Table

Delete 会以对象中有值得为条件进行删除

func (*Table) Exec 

func (t *Table) Exec() (sql.Result, error)

Exec 执行

func (*Table) FindAll 

func (t *Table) FindAll(dest interface{}, fn ...SelectCallBackFn) error

FindAll 多行查询 dest 支持 strut/单字段 slice

func (*Table) FindOne 

func (t *Table) FindOne(dest ...interface{}) error

FindOne 单行查询 dest 长度 > 1 时, 支持多个字段查询 dest 长度 == 1 时, 支持 struct/单字段

func (*Table) FindWhere added in v1.3.6 

func (t *Table) FindWhere(dest interface{}, where string, args ...interface{}) error

FindWhere 如果没有添加查询字段内容, 会根据输入对象进行解析查询 dest 支持 struct, slice, 单字段

func (*Table) GetSqlObj 

func (t *Table) GetSqlObj() *SqlStrObj

GetSqlObj 获取 SqlStrObj, 方便外部使用该对象的方法

func (*Table) Group 

func (t *Table) Group(groupSqlStr string) *Table

Group

func (*Table) Insert 

func (t *Table) Insert(insertObjs ...interface{}) (sql.Result, error)

Insert 提交, 支持批量提交

func (*Table) IsPrintSql added in v1.3.6 

func (t *Table) IsPrintSql(is bool) *Table

IsPrintSql 是否打印 sql

func (*Table) Limit 

func (t *Table) Limit(page int32, size int32) *Table

Limit

func (*Table) Name added in v1.3.9 

func (t *Table) Name(tableName string) *Table

Name 设置表名

func (*Table) OrWhere 

func (t *Table) OrWhere(sqlStr string, args ...interface{}) *Table

OrWhere 支持占位符 如: OrWhere("username = ? AND password = ?d", "test", "123") => xxx OR "username = "test" AND password = 123

func (*Table) OrderBy 

func (t *Table) OrderBy(sqlStr string) *Table

OrderBy

func (*Table) Query 

func (t *Table) Query() (*sql.Rows, error)

Query 多行查询, 返回的 sql.Rows 需要调用 Close

func (*Table) QueryRowScan 

func (t *Table) QueryRowScan(dest ...interface{}) error

QueryRowScan 单行查询

func (*Table) Raw 

func (t *Table) Raw(sql interface{}) *Table

Raw 执行原生操作 sql sqlStr 或 *SqlStrObj

func (*Table) Select 

func (t *Table) Select(fields string) *Table

Select 查询内容 fields 多个通过逗号隔开

func (*Table) SelectAll 

func (t *Table) SelectAll() *Table

SelectAll() 查询所有字段

func (*Table) SelectCount added in v1.4.0 

func (t *Table) SelectCount() *Table

SelectCount 查询总数

func (*Table) Update 

func (t *Table) Update(updateObj interface{}) *Table

Update 会更新输入的值

func (*Table) Where 

func (t *Table) Where(sqlStr string, args ...interface{}) *Table

Where 支持占位符 如: Where("username = ? AND password = ?d", "test", "123") => xxx AND "username = "test" AND password = 123

type TableColInfo 

type TableColInfo struct {
	Field   string // 字段名
	Type    string // 数据库类型
	Null    string // 是否为 NULL
	Key     string
	Default sql.NullString
	Extra   string
}

TableColInfo 表列详情

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.