该文档是翻译自文档[mongodb-docs-2010-10-24.pdf]的[Java Language Center]章节,根据自己的理解整理而成。
希望能给像我这样开始接触的朋友一点帮助,同时也做个备忘,因为是刚刚学习,其中的很多功能目前都用不上,以后万一有什么功能不太清楚,也可以直接查阅该文档了。
MongoDB Java Driver 简单操作
一、Java驱动一致性
MongoDB的Java驱动是线程安全的,对于一般的应用,只要一个Mongo实例即可,Mongo有个内置的连接池(池大小默认为10个)。
对于有大量写和读的环境中,为了确保在一个Session中使用同一个DB时,我们可以用以下方式保证一致性:
DB mdb = mongo.getDB('dbname');
mdb.requestStart();
//
// 业务代码
//
mdb.requestDone();
DB和DBCollection是绝对线程安全的,它们被缓存起来了,所以在应用中取到的可能是同一个对象。
二、保存/查找对象(DBObject)
Java驱动提供了DBObject接口,方便我们保存对象到数据库中。
定义需要保存的对象:
public class Tweet implements DBObject {
/** ...... */
}
然后我们可以使用该对象:
Tweet tweet = new Tweet();
tweet.put("user", userId);
tweet.put("message", message);
tweet.put("date", new Date());
collection.insert(tweet);
当从数据库中查询时,结果会自动的转换成DBObject对象,我们可以转换成我们自己的类型:
collection.setObjectClass(Tweet);
Tweet myTweet = (Tweet)collection.findOne();
三、创建连接
Mongo m = new Mongo();
Mongo m = new Mongo("localhost");
Mongo m = new Mongo("localhost", 27017);
DB db = m.getDB("mydb);
注意:事实上,Mongo实例代表了一个数据库连接池,即使在多线程的环境中,一个Mongo实例对我们来说已经足够了。
四、认证(可选的)
boolean auth = db.authenticate("myUserName", "myPasswd");
五、取得Collection列表
Set<String> colls = db.getCollectionNames();
for(String s : colls) {
System.out.prinln(s);
}
六、获取一个Collection
DBCollection coll = db.getCollection("testCollection");
使用DBCollection,我们可以进行插入、查询数据等数据操作。
七、插入文档
假设有个JSON文档如下所示:
{
"name": "MongoDB",
"type": "database",
"count": 1,
"info": {
x: 203,
y: 102
}
}
注意:上面的JSON文档有个内嵌文档"info"。
我们完全可以利用BasicDBObject来创建一个和上面的JSON一样的文档,并且把它保存在MongoDB中。
DBObject doc = new BasicDBObject();
doc.put("name", "MongoDB");
doc.put("type", "database");
doc.put("count", 1);
DBObject info = new BasicDBObject();
info.put("x", 203);
info.put("y", 102);
doc.put("info", info);
coll.insert(doc);
八、查询第一个文档(findOne())
为了验证在上面我们保存的类似JSON的数据,我们可以用findOne()方法取得数据。
findOne(): 返回一个文档;
find(): 返回一个游标(DBCursor),其中包含一组对象DBObject;
DBObject doc = coll.findOne();
System.out.println(doc);
我们将会看到控制台输出:
{ "_id" : "49902cde5162504500b45c2c" , "name" : "MongoDB" , "type" : "database" , "count" : 1 , "info" : { "x" : 203 , "y" : 102} , "_ns" : "testCollection"}
九、插入多个文档
为了在后来展示更多的查询方法,我们先插入几个文档,它们的JSON像这样:
{
"i": value
}
使用一个循环插入数据:
for(int i = 0; i < 100; i++) {
coll.insert(new BasicDBObject().append("i", i));
}
我们注意到,同一个coll,我们完全可以插入不同风格的数据,这就是MongoDB的重要特性“模式自由”。
十、统计文档数
现在我们已经有101份文档在数据库中了,现在统计一下看是否正确。
long count = coll.getCount();
System.out.println(count);
控制台将会输出:101
十一、使用游标取得所有的文档
DBCursor cursor = coll.find();
while(cursor.hasNext()) {
DBObject object = cursor.next();
System.out.println(object);
}
十二、查询单个文档
DBObject query = new BasicDBObject();
query.put("i", 71);
cursor = coll.find(query);
while(cur.hasNext()) {
DBObject object = cursor.next();
System.out.println(object);
}
控制台的输出类似如下:
{ "_id" : "49903677516250c1008d624e" , "i" : 71 , "_ns" : "testCollection"}
十三、查询文档集合
根据查询条件,我们可以通过DBCollection从数据库中取出多个对象,比如查询i>50的文档集合:
query = new BasicDBObject();
query.put("i", new BasicDBObject("$gt", 50)); // i>50
cursor = coll.find(query);
while(cursor.hasNext()) {
DBObject object = cursor.next();
System.out.println(object);
}
比如查询条件为 20<i<=30:
query = new BasicDBObject();
// 20<i<=30
query.put("i", new BasicDBObject("$gt", 20).append("$lte", 30));
cursor = coll.find(query);
while(cursor.hasNext()) {
DBObject object = cursor.next();
System.out.println(object);
}
十四、创建索引
MongoDB支持索引,并且给一个DBCollection添加索引非常简单,你只要指明需要创建索引的字段,然后指明其是升序(1)还是降序(-1)即可,比如在"i"上创建升序索引。
coll.createIndex(new BasicDBObject("i", 1)); // 1代表升序
十五、查询索引
我们可以查询到所有的索引:
List<DBObject> list = coll.getIndexInfo();
for(DBObject index : list){
System.out.println(index);
}
控制台的输出类似如下所示:
{ "name" : "i_1" , "ns" : "mydb.testCollection" , "key" : { "i" : 1} , "_ns" : "system.indexes"}
MongoDB的管理功能
一、获取所有的数据库
Mongo m = new Mongo();
for(String s : m.getDatabaseNames()) {
System.out.println(s);
}
二、删除数据库
m.dropDatabase("my_new_db");
MongoDB的Java类型
一、对象ID
ObjectId被用作自动生成的唯一ID.
ObjectId id = new ObjectId();
ObjectId copy = new ObjectId(id);
二、正则表达式
Pattern john = Pattern.compile("joh?n", CASE_INSENSITIVE);
DBObject query = new BasicDBObject("name", john);
// 查询所有 "name" 匹配 /joh?n/i 的文档
DBCursor cursor = collection.find(query);
三、日期和时间
Date now = new Date();
DBObject time = new BasicDBObject("ts", now);
collection.save(time);
四、数据库引用
DBRef可以用来保存数据库引用。
DBRef addressRef = new DBRef(db, "foo.bar", address_id);
DBObject address = addressRef.fetch();
DBObject person = BasicDBObjectBuilder.start()
.add("name", "Fred")
.add("address", addressRef)
.get();
collection.save(person);
DBObject fred = collection.findOne();
DBRef addressObj = (DBRef)fred.get("address");
addressObj.fetch();
五、二进制数据
字节数组(byte[])被当作二进制数据。
六、内嵌文档
JSON样式的数据如下:
{
"x": {
"y": 3
}
}
则在MongoDB中,Java表示为:
DBObject y = new BasicDBObject("y", 3);
DBObject x = new BasicDBObject("x", y);
七、数组
任何继承自List的对象,在MongoDB中,都被当成是数组。
如果想表示如下JSON数据:
{
"x": [
1,
2,
{"foo": "bar"},
4
]
}
则在Java中,应该为:
List<Object> x = new ArrayList<Object>();
x.add(1);
x.add(2);
x.add(new BasicDBObject("foo", "bar"));
x.add(4);
DBObject doc = new BasicDBObject("x", x);
System.out.println(doc);
===========================================
如有批评、指教、疑惑,请:obullxl@163.com
祝大家使用JAVA愉快!