mirror of
https://github.com/crawlab-team/crawlab.git
synced 2026-01-23 17:31:11 +01:00
36 lines
1.4 KiB
Go
36 lines
1.4 KiB
Go
// Package mgo (pronounced as "mango") offers a rich MongoDB driver for Go.
|
|
//
|
|
// Detailed documentation of the API is available at GoDoc:
|
|
//
|
|
// https://godoc.org/github.com/globalsign/mgo
|
|
//
|
|
// Usage of the driver revolves around the concept of sessions. To
|
|
// get started, obtain a session using the Dial function:
|
|
//
|
|
// session, err := mgo.Dial(url)
|
|
//
|
|
// This will establish one or more connections with the cluster of
|
|
// servers defined by the url parameter. From then on, the cluster
|
|
// may be queried with multiple consistency rules (see SetMode) and
|
|
// documents retrieved with statements such as:
|
|
//
|
|
// c := session.DB(database).C(collection)
|
|
// err := c.Find(query).One(&result)
|
|
//
|
|
// New sessions are typically created by calling session.Copy on the
|
|
// initial session obtained at dial time. These new sessions will share
|
|
// the same cluster information and connection pool, and may be easily
|
|
// handed into other methods and functions for organizing logic.
|
|
// Every session created must have its Close method called at the end
|
|
// of its life time, so its resources may be put back in the pool or
|
|
// collected, depending on the case.
|
|
//
|
|
// There is a sub-package that provides support for BSON, which can be
|
|
// used by itself as well:
|
|
//
|
|
// https://godoc.org/github.com/globalsign/mgo/bson
|
|
//
|
|
// For more details, see the documentation for the types and methods.
|
|
//
|
|
package mgo
|