go mgo包 简单封装 mongodb 数据库驱动

mgo是go编写的mongodb的数据库驱动，集成到项目中进行mongodb的操作很流畅，以下是对其的一些简单封装，具体使用可随意改动封装。

安装

go get gopkg.in/mgo.v2

使用

引入第三方包

import (
    "gopkg.in/mgo.v2"
    "gopkg.in/mgo.v2/bson"
)

初始化连接

var (
  	GVA_MONGO_DB *mgo.Session
)

global.GVA_MONGO_DB = initialize.Mongodb() 

// 如果MongoDB设置了用户权限需要使用下面的方法操作
func Mongodb() *mgo.Session {
	//dialInfo := &mgo.DialInfo{
	//	Addrs:     []string{dbhost}, //数据库地址 dbhost: mongodb://user@123456:127.0.0.1:27017
	//	Timeout:   timeout,					 // 连接超时时间 timeout: 60 * time.Second
	//	Source:    authdb,					 // 设置权限的数据库 authdb: admin
	//	Username:  authuser,				 // 设置的用户名 authuser: user
	//	Password:  authpass,				// 设置的密码 authpass: 123456
	//	PoolLimit: poollimit,       // 连接池的数量 poollimit: 100
	//}
	//
	//s, err := mgo.DialWithInfo(dialInfo)
	//if err != nil {
	//	log.Fatalf("Create Session: %s\n", err)
	//}
	//globalS = s
	s, err := mgo.Dial("127.0.0.1:27017")
	if err != nil {
		log.Fatalf("Create Session: %s\n", err)
	}
	return s
}

连接具体的数据和文档

每一次操作都copy一份 Session,避免每次创建Session,导致连接数量超过设置的最大值
获取文档对象 c := Session.DB(db).C(collection)

func connect(db, collection string) (*mgo.Session, *mgo.Collection) {
	ms := global.GVA_MONGO_DB.Copy()
	c := ms.DB(db).C(collection)
	ms.SetMode(mgo.Monotonic, true)
	return ms, c
}

插入数据

每次操作之后都要主动关闭 Session defer Session.Close()
db:操作的数据库
collection:操作的文档(表)
doc:要插入的数据

func Insert(db, collection string, doc interface{}) error {
	ms, c := connect(db, collection)
	defer ms.Close()
 
	return c.Insert(doc)
}
 
// bson映射真实对应mongodb中的字段值
type Incomes struct {
	Symbol    string  `bson:"symbol"`     // 交易对
	Income    float64 `bson:"income"`     // 资金流数量，正数代表流入，负数代表流出
	CreatedAt int64   `bson:"created_at"` // 创建时间
}

inComes := Incomes{
	 Symbol:   "BTCUSDT",
         Income:    "12312",
	 CreatedAt: 1618489385,
}
 
err := db.Insert("Fund", "Incomes", inComes)

查询数据

db:操作的数据库
collection:操作的文档(表)
query:查询条件
selector:需要过滤的数据(projection)
result:查询到的结果

func FindOne(db, collection, sort string, query, selector, result interface{}) error {
	ms, c := connect(db, collection)
	defer ms.Close()

	return c.Find(query).Select(selector).Sort(sort).One(result)
}
 
func FindAll(db, collection, sort string, query, selector, result interface{}) error {
	ms, c := connect(db, collection)
	defer ms.Close()
 
	return c.Find(query).Select(selector).Sort(sort).All(result)
}

可自定义修改封装

排序 Sort

//按age升序，如果要降序Sort("-age")
iter = c.Find(bson.M{"age": bson.M{"$gte": 33}}).Sort("age").Iter()

限定结果数量 Limit

//使用Limit限定只去5条记录
iter = c.Find(bson.M{"age": bson.M{"$gte": 20}}).Sort("age").Limit(5).Iter()

跳过指定数量的记录 Skip

//跳过两条记录，取接下来的5条记录
iter = c.Find(bson.M{"age": bson.M{"$gte": 20}}).Sort("age").Skip(2).Limit(5).Iter()

计算记录的条数 Count

recordsCount, err := c.Find(bson.M{"age": bson.M{"$gte": 20}}).Count()

示例

// 查询title="标题"【=($eq)】,并且返回结果中去除`_id`字段
var result Data
err = db.FindOne(database, collection, bson.M{"title": "标题"}, bson.M{"_id":0}, &result)

// 根据created_at排序 默认正序
fundNetValue := model.FundNetValue{}
mongodb.FindOne("Fund", "netValue", "-created_at", bson.M{}, bson.M{}, &fundNetValue)

// 根据created_at排序 加-连接号 为倒序
mongodb.FindAll("Fund", "netAssets", bson.M{"-created_at": bson.M{"$gt": time - 86400, "$lte": time}}, bson.M{}, fundNetAssets)

// !=($ne) 
bson.M{"name": bson.M{"$ne": "Jimmy Kuu"}}

// >($gt) 
bson.M{"age": bson.M{"$lt": 32}}

// <($lt) 
bson.M{"age": bson.M{"$lt": 32}}

// >=($gte) 
bson.M{"age": bson.M{"$gte": 33}}

// <=($lte) 
bson.M{"age": bson.M{"$lte": 31}}

// in($in) 
bson.M{"name": bson.M{"$in": []string{"Jimmy Kuu", "Tracy Yu"}}}

// not in($nin)
bson.M{"name": bson.M{"$nin": []string{"Jimmy Kuu", "Tracy Yu"}}}

// 是否包含存在($exists)
bson.M{"city": bson.M{"$exists": true}}

// 键值为null(键存在，键值为null)
bson.M{"city": bson.M{"$in": []interface{}{nil}, "$exists": true}}

// $size 键值长度为指定值的数组
bson.M{"interests": bson.M{"$size": 3}}

// $all 包含所有值的匹配
bson.M{"interests": bson.M{"$all": []string{"music", "reading"}}}


// 多条件查询
// and($and) 
bson.M{"city": "Shanghai", "age": bson.M{"$gte": 33}}

// or($or) 
bson.M{"$or": []bson.M{bson.M{"name": "Jimmy Kuu"}, bson.M{"age": 31}}}

更新数据

db:操作的数据库
collection:操作的文档(表)
selector:更新条件
update:更新的操作

func Update(db, collection string, selector, update interface{}) error {
	ms, c := connect(db, collection)
	defer ms.Close()
 
	return c.Update(selector, update)
}
 
//更新，如果不存在就插入一个新的数据 `upsert:true`
func Upsert(db, collection string, selector, update interface{}) error {
	ms, c := connect(db, collection)
	defer ms.Close()
 
	_, err := c.Upsert(selector, update)
	return err
}
 
// `multi:true`
func UpdateAll(db, collection string, selector, update interface{}) error {
	ms, c := connect(db, collection)
	defer ms.Close()
 
	_, err := c.UpdateAll(selector, update)
	return err
}

示例

//test
err = db.Update(database, collection, bson.M{"_id": "5b3c30639d5e3e24b8786540"}, bson.M{"$set": bson.M{"title": "更新标题"}})

// 修改字段的值($set)
bson.M{"_id": bson.ObjectIdHex("5204af979955496907000001")}, bson.M{"$set": bson.M{ "name": "Jimmy Gu", "age": 34, }}

// 字段增加值 inc($inc)
bson.M{"_id": bson.ObjectIdHex("5204af979955496907000001")}, bson.M{"$inc": bson.M{ "age": -1, }}

// 从数组中增加一个元素 push($push)
bson.M{"_id": bson.ObjectIdHex("5204af979955496907000001")}, bson.M{"$push": bson.M{ "interests": "Golang", }}

// 从数组中删除一个元素 pull($pull)
bson.M{"_id": bson.ObjectIdHex("5204af979955496907000001")}, bson.M{"$pull": bson.M{ "interests": "Golang", }}

删除数据

db:操作的数据库
collection:操作的文档(表)
selector:删除条件

func Remove(db, collection string, selector interface{}) error {
	ms, c := connect(db, collection)
	defer ms.Close()
 
	return c.Remove(selector)
}
 
func RemoveAll(db, collection string, selector interface{}) error {
	ms, c := connect(db, collection)
	defer ms.Close()
 
	_, err := c.RemoveAll(selector)
	return err
}
 
//test
err = db.Remove(database,collection,bson.M{"_id":"5b3c30639d5e3e24b8786540"})

分页查询

func FindPage(db, collection string, page, limit int, query, selector, result interface{}) error {
	ms, c := connect(db, collection)
	defer ms.Close()
 
	return c.Find(query).Select(selector).Skip(page * limit).Limit(limit).All(result)
}

其他操作

func IsEmpty(db, collection string) bool {
	ms, c := connect(db, collection)
	defer ms.Close()
	count, err := c.Count()
	if err != nil {
		log.Fatal(err)
	}
	return count == 0
}
 
func Count(db, collection string, query interface{}) (int, error) {
	ms, c := connect(db, collection)
	defer ms.Close()
	return c.Find(query).Count()
}