MysqlGo
简介
MysqlGO基于 https://github.com/jmoiron/sqlx 进行二次封装,封装了golang对MySQL数据库的增删改查操作。
项目文件简介
Config.go
MysqlGO数据库配置文件,主要管理数据库配置参数和数据库连接操作。
Model.go
MysqlGo数据库操作处理文件,封装了MySQL数据库的增删改查操作处理。
安装说明
MysqlGo是golang下对MySQL数据库操作处理进行二次封装,在项目使用过程中,需要使用mysql driver,因为调用时需要引入
import (
_ "https://github.com/go-sql-driver/mysql"
"http://gitee.com/ironCoffers/MysqlGo"
)
使用说明
1.数据库配置
var config := &Config{
Alias : "配置别名",
DSN : DSNConfig{
HostName :"127.0.0.1",
HostPort :"3306",
DBName:"dbname",
UserName:"用户名",
Password:"密码",
Charset:"数据库字符集",
Prefix:"",
},
MaxOpenConns :"设置最大打开的连接数"
MaxIdleConns :"设置闲置的连接数"
MaxLifetime:"闲置连接的最大生命周期"
}
2.验证配置
MysqlGo封装Connect(),利用golang SQL自带的ping()函数测试当前配置是否可用。若配置可用,则会将配置保存下来;否则,则报错提示。
Connect(config)
建议Connect()函数在服务启动时调用,以保存数据库配置数据,后期直接调用Model即可对数据库进行增删改查操作
3.数据库操作
数据库操作利用封装的Model进行数据库的增删改查操作
//配置Model
var userModel = &Model{
TableName : "user", //预设关联的表名
}
TableName为预设Model关联的数据库表名,为后面使用userModel时直接关联表名生成对应的SQL语句
//添加记录
///INSERT INTO user(username, password) VALUE('admin', '123456')
var data = User{
Account : "admin",
Password : "123456",
}
id, err := userModel.Add(data)
Add()是Model中处理记录Insert操作的函数,函数传入的参数进行分析拆解,然后拼装成Insert SQL语句,并执行。
id为插入记录成功后返回在数据表中记录id
err为执行过程中出现错误的信息
//添加多条记录
///INSERT INTO user(username, password) VALUE('admin', '123456')
///NSERT INTO user(username, password) VALUE('test', '123456')
///INSERT INTO user(username, password) VALUE('abc', '123456')
var datas = []User{
User {
Account : "admin",
Password : "123456",
},
User {
Account : "test",
Password : "123456",
},
User {
Account : "abc",
Password : "123456",
},
}
err := userModel.AddAll(datas...)
AddAll()是Model中处理同一张数据表中多条记录Insert操作的函数,函数传入的参数进行分析拆解,然后拼装成Insert SQL语句,逐条执行。函数内部使用了事务处理机制,如果在操作过程中出现某条记录操作失败,则事务进行回滚;否则完成事务操作。
//更新记录
///UPDATE user SET password = "admin" WHERE username = 'admin'
var datas = map[string]interface{}{
"password" : "admin123",
}
rows, err := userModel.Where("username = ?", "admin").Update(datas)
Update()是Model中处理数据表记录Update处理的函数。函数处理过程主要有两部分:
1.设置Where条件。若未设置Where,在执行Update()时会报错;
2.Update()函数入参。若未填写参数,在执行Update()时报错。
如Update()执行成功后,会返回Update()影响的行数
//查询数据
///SELECT username, password FROM user WHERE state = 1
user := struct{
Username string
Password string
} {}
err := userModel.Field("username", "password").Where("state = ?", 1).Find(&user)
Find()是Model处理查询数据的函数,此函数只返回一条记录。利用反射机制,将查询结果传递给Find()函数的参数。函数参数中的字段名称必须与Field的字段值名称,若不相同则会报错
//查询多条数据
user := []struct {
Username string
Passwordstring
}{}
err := userModel.Field("username", "password").Where("state = ?", 1).Limit(1, 10).Select(&user)
Select()是Model处理查询多条数据的函数,此函数返回多条记录。利用反射机制,将查询结果传递给Select()函数的参数。函数参数中的字段名称必须与Field的字段值名称,若不相同则会报错