mirror of
https://github.com/mainflux/mainflux.git
synced 2025-05-06 19:29:15 +08:00
58cdf2cddc
* Add mongodb reader service Signed-off-by: Aleksandar Novakovic <aleksandar.novakovic@mainflux.com> * Add tests for mongodb reader service Signed-off-by: Aleksandar Novakovic <aleksandar.novakovic@mainflux.com> * Add documentation for mongodb reader service Signed-off-by: Aleksandar Novakovic <aleksandar.novakovic@mainflux.com> * Fix test function name Signed-off-by: Aleksandar Novakovic <aleksandar.novakovic@mainflux.com> * Update comment in docker-compose for mongodb-reader service Signed-off-by: Aleksandar Novakovic <aleksandar.novakovic@mainflux.com>
49 lines
1.8 KiB
Go
49 lines
1.8 KiB
Go
// Package mongo provides a MongoDB Driver API for Go.
|
|
//
|
|
// Basic usage of the driver starts with creating a Client from a connection
|
|
// string. To do so, call the NewClient and Connect functions:
|
|
//
|
|
// client, err := mongo.NewClient("mongodb://foo:bar@localhost:27017")
|
|
// if err != nil { log.Fatal(err) }
|
|
// err = client.Connect(context.TODO())
|
|
// if err != nil { log.Fatal(err) }
|
|
//
|
|
// This will create a new client and start monitoring the MongoDB server on localhost.
|
|
// The Database and Collection types can be used to access the database:
|
|
//
|
|
// collection := client.Database("baz").Collection("qux")
|
|
//
|
|
// A Collection can be used to query the database or insert documents:
|
|
//
|
|
// res, err := collection.InsertOne(context.Background(), map[string]string{"hello": "world"})
|
|
// if err != nil { log.Fatal(err) }
|
|
// id := res.InsertedID
|
|
//
|
|
// Several methods return a cursor, which can be used like this:
|
|
//
|
|
// cur, err := collection.Find(context.Background(), nil)
|
|
// if err != nil { log.Fatal(err) }
|
|
// defer cur.Close(context.Background())
|
|
// for cur.Next(context.Background()) {
|
|
// elem := bson.NewDocument()
|
|
// err := cur.Decode(elem)
|
|
// if err != nil { log.Fatal(err) }
|
|
// // do something with elem....
|
|
// }
|
|
// if err := cur.Err(); err != nil {
|
|
// log.Fatal(err)
|
|
// }
|
|
//
|
|
// Methods that only return a single document will return a *DocumentResult, which works
|
|
// like a *sql.Row:
|
|
//
|
|
// result := bson.NewDocument()
|
|
// filter := bson.NewDocument(bson.EC.String("hello", "world"))
|
|
// err := collection.FindOne(context.Background(), filter).Decode(result)
|
|
// if err != nil { log.Fatal(err) }
|
|
// // do something with result...
|
|
//
|
|
// Additional examples can be found under the examples directory in the driver's repository and
|
|
// on the MongoDB website.
|
|
package mongo
|