MongoDB 是一個基於分佈式文件存儲的數據庫。由 C++ 語言編寫,一般生產上建議以共享分片的形式來部署。 但是MongoDB官方也提供了其它語言的客戶端操作API。如下圖所示:
提供了C、C++、C#、.net、GO、java、Node.js、PHP、python、scala等各種語言的版本,如下圖所示:
MongoDB的操作分爲同步操作和異步操作以及響應式編程操作
一、同步操作API
官方JAVA API的路徑:https://docs.mongodb.com/ecosystem/drivers/java/ 我們這裏以3.11的java 版本爲例。各個版本的API對MongoDB服務的支持情況。
使用API時,先引入maven依賴
1
2
3
4
5
6
<groupId>org.mongodb</groupId>
<artifactId>mongo-java-driver</artifactId>
<version>3.11.1</version>
1、關於MongoDB Client的初始化和關閉。
從官方介紹來看,一般建議Client只需要一個建立一個長連接實例,然後使用時,都使用這個實例就可以,也就是可以用java的單例模式來創建連接實例。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
//mongoClient連接
protected static MongoClient mongoClient;
public synchronized static MongodbClient getInstance(String mongodbUrl) {
if (null == mongoClient) {
mongoClient = MongoClients.create(mongodbUrl);
if(null != mongoClient){
log.info("mongoClient init success!");
}
else{
log.info("mongoClient init failed!");
}
}
return mongodbClient;
}
直接通過mongodb的host和port來創建client:
1
MongoClient mongoClient = MongoClients.create("mongodb://host1:27017");
client連接到一個 Replica Set:
1
2
3
MongoClient mongoClient = MongoClients.create("mongodb://host1:27017,host2:27017,host3:27017");
MongoClient mongoClient = MongoClients.create("mongodb://host1:27017,host2:27017,host3:27017/?replicaSet=myReplicaSet");
或者通過MongoClientSettings.builder() 來輔助生成連接字符串來創建client:
1
MongoClient mongoClient = MongoClients.create( MongoClientSettings.builder() .applyToClusterSettings(builder -> builder.hosts(Arrays.asList( new ServerAddress("host1", 27017), new ServerAddress("host2", 27017), new ServerAddress("host3", 27017)))) .build());
連接關閉:
1
2
3
4
5
6
public void close() {
if(null!=mongoClient){
mongoClient.close();
mongoClient=null;
}
}
2、關於MongoDB 的基本操作
複製代碼
//創建Collection
public void createCollection(String dataBaseName,String collectionName){
getDatabase(dataBaseName).createCollection(collectionName);
}
//查詢dataBaseName
public MongoDatabase getDatabase(String dataBaseName){ return mongoClient.getDatabase(dataBaseName); }
//查詢Collection
public List listCollectionNames(String dataBaseName){
List stringList = new ArrayList();
mongoClient.getDatabase(dataBaseName).listCollectionNames().forEach((Consumer<? super String>) t->{ stringList.add(t); });
return stringList; }
public MongoCollection getCollectionByName(String dataBaseName, String collectionName){ return getDatabase(dataBaseName).getCollection(collectionName); }
複製代碼
3、關於MongoDB 的查詢操作
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
//通過id(objectid)精確查詢
public FindIterable findMongoDbDocById(String dataBaseName, String collectionName, String id){
BasicDBObject searchDoc = new BasicDBObject().append("_id", id);
return getCollectionByName(dataBaseName,collectionName).find(searchDoc);
}
//通過id(objectid)模糊查詢
public FindIterable findMongoDbDocByIdRegex(String dataBaseName, String collectionName, String id){
BasicDBObject searchDoc = new BasicDBObject().append("_id", new BasicDBObject("$regex",id));
return getCollectionByName(dataBaseName,collectionName).find(searchDoc);
}
//通過開始id和結束id 查詢(根據objectId範圍查詢)
public FindIterable findMongoDbDocById(String dataBaseName, String collectionName, String startId,String endId){
BasicDBObject searchDoc = new BasicDBObject().append("_id", new BasicDBObject("$gte", startId).append("$lte", endId));
return getCollectionByName(dataBaseName,collectionName).find(searchDoc);
}
public FindIterable findMongoDbDoc(String dataBaseName, String collectionName,BasicDBObject basicDBObject){
return getCollectionByName(dataBaseName,collectionName).find(basicDBObject);
}
//限制查詢返回的條數
public FindIterable findMongoDbDoc(String dataBaseName, String collectionName,BasicDBObject basicDBObject,Integer limitNum){
return findMongoDbDoc(dataBaseName,collectionName,basicDBObject).limit(limitNum) ;
}
public FindIterable findMongoDbDocById(String dataBaseName, String collectionName, String startId,String endId,Integer limitNum){
return findMongoDbDocById(dataBaseName,collectionName,startId,endId).limit(limitNum);
}
/**
- 降序查詢(排序)
- @param dataBaseName
- @param collectionName
- @param startId
- @param endId
- @param sortField 排序字段
- @return
*/
public FindIterable findMongoDbDocByIdDescSort(String dataBaseName, String collectionName, String startId,String endId,String sortField){
return findMongoDbDocById(dataBaseName,collectionName,startId,endId).sort(new Document().append(sortField, -1));
}
public FindIterable findMongoDbDocByIdDescSort(String dataBaseName, String collectionName, String startId,String endId,String sortField,Integer limitNum){
return findMongoDbDocByIdDescSort(dataBaseName,collectionName,startId,endId,sortField).limit(limitNum);
}
/**
- 降序查詢(排序)
- @param dataBaseName
- @param collectionName
- @param startId
- @param endId
- @param sortField 排序字段
- @return
*/
public FindIterable findMongoDbDocByIdAscSort(String dataBaseName, String collectionName, String startId,String endId,String sortField){
return findMongoDbDocById(dataBaseName,collectionName,startId,endId).sort(new Document().append(sortField, 1));
}
public FindIterable findMongoDbDocByIdAscSort(String dataBaseName, String collectionName, String startId,String endId,String sortField,Integer limitNum){
return findMongoDbDocByIdAscSort(dataBaseName,collectionName,startId,endId,sortField).limit(limitNum);
}
4、關於MongoDB 的插入操作
1
2
3
4
5
6
7
8
9
//插入操作,注意插入時,如果數據已經存在會報錯,插入時必須數據不存在,不會自動進行覆蓋
//插入單條記錄
public void insertDoc(String dataBaseName, String collectionName, Document document){
getCollectionByName(dataBaseName,collectionName).insertOne(document);
}
//插入多條記錄
public void insertDoc(String dataBaseName, String collectionName,List<? extends Document> listData){
getCollectionByName(dataBaseName,collectionName).insertMany(listData);
}
5、關於MongoDB 的更新操作
1
2
3
4
5
6
7
8
9
10
11
12
13
14
//更新單條
public void updateDoc(String dataBaseName, String collectionName, Bson var1, Bson var2){
getCollectionByName(dataBaseName,collectionName).updateOne(var1,var2);
}
public void updateDoc(String dataBaseName, String collectionName, Bson var1, List<? extends Bson> list){
getCollectionByName(dataBaseName,collectionName).updateOne(var1,list);
}
//批量更新
public void updateDocs(String dataBaseName, String collectionName, Bson var1, Bson var2){
getCollectionByName(dataBaseName,collectionName).updateMany(var1,var2);
}
public void updateDocs(String dataBaseName, String collectionName, Bson var1, List<? extends Bson> list){
getCollectionByName(dataBaseName,collectionName).updateMany(var1,list);
}
6、關於MongoDB 的刪除操作
1
2
3
4
5
6
7
8
//單條刪除
public DeleteResult deleteDoc(String dataBaseName, String collectionName, Bson var1){
return getCollectionByName(dataBaseName,collectionName).deleteOne(var1);
}
//批量刪除
public DeleteResult deleteDocs(String dataBaseName, String collectionName,Bson var1){
return getCollectionByName(dataBaseName,collectionName).deleteMany(var1);
}
7、關於MongoDB 的替換操作
1
2
3
4
//存在就替換,不存在的話就插入
public UpdateResult replaceDoc(String dataBaseName, String collectionName, Bson var1, Document var2){
return getCollectionByName(dataBaseName,collectionName).replaceOne(var1,var2);
}
8、關於MongoDB 的bulkWrite操作 (批量寫入)
1
2
3
public BulkWriteResult bulkWrite(String dataBaseName, String collectionName, List<? extends WriteModel<? extends Document>> listData){
return getCollectionByName(dataBaseName,collectionName).bulkWrite(listData);
}
二、異步操作API
mongodb異步驅動程序提供了異步api,可以利用netty或java 7的asynchronoussocketchannel實現快速、無阻塞的i/o,maven依賴
1
2
3
4
5
6
7
org.mongodb
mongodb-driver-async
3.11.1
官方地址:http://mongodb.github.io/mongo-java-driver/3.11/driver-async/getting-started/installation/
異步操作必然會涉及到回調,回調時採用ResultCallback
1
2
3
4
5
6
7
8
9
10
11
12
13
SingleResultCallback callbackPrintDocuments = new SingleResultCallback() {
@Override
public void onResult(final Document document, final Throwable t) {
System.out.println(document.toJson());
}
};
SingleResultCallback callbackWhenFinished = new SingleResultCallback() {
@Override
public void onResult(final Void result, final Throwable t) {
System.out.println("Operation Finished!");
}
};
異步insert操作
1
2
3
4
5
6
collection.insertMany(documents, new SingleResultCallback() {
@Override
public void onResult(final Void result, final Throwable t) {
System.out.println("Documents inserted!");
}
});
異步刪除操作
1
2
3
4
5
6
collection.deleteMany(gte("i", 100), new SingleResultCallback() {
@Override
public void onResult(final DeleteResult result, final Throwable t) {
System.out.println(result.getDeletedCount());
}
});
異步更新操作
1
2
3
4
5
6
7
collection.updateMany(lt("i", 100), inc("i", 100),
new SingleResultCallback<UpdateResult>() {
@Override
public void onResult(final UpdateResult result, final Throwable t) {
System.out.println(result.getModifiedCount());
}
});
異步統計操作
1
2
3
4
5
6
7
collection.countDocuments(
new SingleResultCallback() {
@Override
public void onResult(final Long count, final Throwable t) {
System.out.println(count);
}
});
三、MongoDB Reactive Streams 操作API
官方的MongoDB reactive streams Java驅動程序,爲MongoDB提供異步流處理和無阻塞處理。
完全實現reactive streams api,以提供與jvm生態系統中其他reactive streams的互操作,一般適合於大數據的處理,比如spark,flink,storm等。
1
2
3
4
5
6
7
<dependency>
<groupId>org.mongodb</groupId>
<artifactId>mongodb-driver-reactivestreams</artifactId>
<version>1.12.0</version>
</dependency>
官方地址:http://mongodb.github.io/mongo-java-driver-reactivestreams/
會包含如下三部分:
Publisher:Publisher 是數據的發佈者。Publisher 接口只有一個方法 subscribe,用於添加數據的訂閱者,也就是 Subscriber。
Subscriber: 是數據的訂閱者。Subscriber 接口有4個方法,都是作爲不同事件的處理器。在訂閱者成功訂閱到發佈者之後,其 onSubscribe(Subscription s) 方法會被調用。
Subscription:表示的是當前的訂閱關係。
API問的地址:http://mongodb.github.io/mongo-java-driver-reactivestreams/1.12/javadoc/
代碼示例:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
//建立連接
MongoClient mongoClient = MongoClients.create(mongodbUrl);
//獲得數據庫對象
MongoDatabase database = client.getDatabase(databaseName);
//獲得集合
MongoCollection collection = database.getCollection(collectionName);
//異步返回Publisher
FindPublisher publisher = collection.find();
//訂閱實現
publisher.subscribe(new Subscriber() {
@Override
public void onSubscribe(Subscription str) {
System.out.println("start...");
//執行請求
str.request(Integer.MAX_VALUE);
}
@Override
public void onNext(Document document) {
//獲得文檔
System.out.println("Document:" + document.toJson());
}
@Override
public void onError(Throwable t) {
System.out.println("error occurs.");
}
@Override
public void onComplete() {
System.out.println("finished.");
}