common

README

common

各种常用工具的集合。

基础(basic)

• IndexOf(Type)：在某种类型的数组中，查找元素的位置。
• SQLCommon：SQL操作对象的公用接口，兼容sql.DB和sql.Tx。
• UUIDString：生成32位(没有"-"符号)的UUID。
• GetNanoTimeLabel：生成21位的纳秒时间值。
• MarshalJson：JSON序列化。
• UnmarshalJson：JSON反序列化。

加解密工具(encrypt)

• AesCbcPkcs5Encrypt：AES/CBC/PKCS5模式加密。
• AesCbcPkcs5Decrypt：AES/CBC/PKCS5模式解密。
• HMAC-SHA1：HMAC-SHA1算法。
• SHA1：SHA1算法。
• MD5：MD5算法。

文件系统(filesystem)

• CopyFile：拷贝文件。
• CreateDir：创建目录。
• LoadJsonFile：读取Json文件。
• IsFile：判断是否是文件。
• IsDir：判断是否是目录。

传输工具(transfer)

• ReadBigEndian/WriteBigEndian：大端序字节流转换。
• ReadLittleEndian/WriteLittleEndian：小端序字节流转换。
• UtfToGbk/GbkToUtf：UTF-8和GBK编码转换。
• UtfToGb2312/Gb2312ToUtf：UTF-8和GB2312编码转换。
• ReadConn/ReadConnMaxLength：从连接中读取指定长度的数据，可以选择是否判断最大长度。
• ByteArrayNoZeroString：定长数组去掉多余的0后转字符串，先将定长数组转为切片后传入。

数据库工具(dbtool)

这里使用GORM框架，数据库采用MySQL，包含一些常用的工具，包括数据库连接、分页查询列表等。

GORM-MySQL

可以通过接口，来直接获取GORM的MySQL数据库连接：

func GetGormMySQLConnection(config MySqlConfig) (db *gorm.DB, err error)

这里MySqlConfig是MySQL的配置信息，格式如下：

• Host：服务器主机地址。
• Port：服务器端口号。
• User：服务器登陆用户。
• Password：调试时数据库密码。
• Scheme：数据库名称。
• MaxIdleConnection：最大闲置连接数。
• MaxOpenConnection：最大打开连接数。
• Params：连接参数。

通用事务处理

使用如下接口，进行GORM事务处理：

func TransactionGORM(db *gorm.DB, f TransactionFuncGORM) (data interface{}, err error)

里面的f参数是实际事务操作的回调函数，类型是：

type TransactionFuncGORM func(*gorm.DB) (interface{}, error)

复杂查询条件

包括原子级条件项和复合条件项，其中：

• 原子级条件项：只有左值、右值、操作符，拼接成一个原子级查询语句。
• 复合条件项：包括多个子项，子项可以是原子级条件项，也可以是复合条件项，用连接符连接，可以是and或or。

其中QuerySql接口可以获取生成的查询语句和条件项，Fields接口可以获取查询条件中的所有字段列表，用于判断是否有字段不符合后台要求。

判断GORM事务

判断一个GORM操作对象是否是事务：

func IsGormTx(db *gorm.DB) error