mgo初步接触

Intro

mgo是mongodb的go语言绑定，第一次在静态类型语言中使用ORM，故留个笔记。

模型

mongodb是schema-less无模式的NoSQL非关系型数据库，理论上来讲，在同一个表（mongodb中称为collection）中的行（mongodb称为document）也可能具备不一样的字段。

简单的模型能够如此定义。

type Article struct {
    Id      bson.ObjectId `bson:"_id,omitempty"`
    Title   string        `bson:"title"`
    Content string        `bson:"content"` 
}

使用了struct field tag，参考golang英文wiki，还有这里的golang spec。

其中Id这个字段是使用mongodb本身生成的_id字段，omitempty表示该字段在序列化的时候只接受非零值（0，空slice，或者空map都算是零值），按照个人理解就是，若是Id是0，那么过了Marshal以后应该是见不到_id这个字段的。

这个设计保证了不会误存go语言给Id的默认值0，形成键冲突。

bson:"<field_name>"和json:"<field_name>"相似，声明了序列化后字段的键名。

回到正题，简单字段如int32、float32、string都不须要特殊处理，时间多是一个须要关注的地方。

type Article struct {
    Id        bson.ObjectId `bson:"_id,omitempty"`
    CreatedAt time.Time     `bson:"created_at"`
    UpdatedAt time.Time     `bson:"updated_at"`
    Title     string        `bson:"title"`
    Content   string        `bson:"content"` 
}

注意的一个点是bson.MongoTimestamp在我使用时出现了没法正确反序列化mongodb查询结果的问题，缘由不明。数据是手动在mongo shell里插入的，使用new Date()赋值了created_at和updated_at。有人知道怎么回事的话请告诉我。

使用time.Time就能够正常序列化了。

查询

mgo查询基本思路是：建立链接（mgo.Dial）、选择数据库（Session.DB）、选择集合（Database.C）、设置条件（Collection.Find）、取出结果（Query.All）。

简单例子以下。

func findSomething() {
    sess, err := mgo.Dial("mongodb://localhost:27017")
    if err != nil {
        panic(err)
    }
    
    var result []Article
    sess.DB("test").C("articles").Find(bson.M{"title": "mgo初接触"}).All(&result)
    fmt.Println(result)
}

和通常mongo查询同样支持一些排序之类的操做。

Query.Sort按照文档说法能够写出这样的查询：Find(bson.M{}).Sort("-created_at")，-号表示降序。

Query.skip能够跳过必定数量的结果，Query.One表示只取一个元素，Query.Limit限制查询结果的数量等等...

写入

写入的基本操做是Collection.Insert和Collection.Update以及两个变体Collection.UpdateId以及Collection.UpdateAll。

最基本的Collection.Insert应该不用多解释。

Collection.Update按照文档描述，是查找到匹配参数selector条件的一个document并更新。一般咱们更新document应该是用_id字段来惟一肯定，顾名思义Collection.UpdateId就是这样一个便捷方法。

更新多个document的时候就用到了Collection.UpdateAll了。参数和Collection.Update无异，selector肯定要更新的document有哪些，update参数则肯定要更新到什么样子。