Java操作MongoDB(详细)

 
MongoDB 不仅可以在命令行窗口(CMD)中运行,它还可以与编程语言配合使用,本节我们就来介绍一下在 Java 中如何使用 MongoDB。

环境配置

想要在 Java 程序中使用 MongoDB,需要确保您的电脑上已经安装了 MongoDB,并搭建好了 Java 的环境。您可以查看《Java 教程》来了解不同系统下 Java 的安装教程。

另外您还需要确认安装了 MongoDB JDBC 驱动,您可以通过 http://mongodb.github.io/mongo-java-driver/ 来下载最新版的 mongodb-driver-3.11.2.jar 以及其依赖项 mongodb-driver-core-3.11.2.jar,并将它们包含进 classpath 中。

连接数据库

要连接数据库,首先需要指定要连接的数据库名称,如果数据库不存在的话,MongoDB 则会自动创建它。下面通过简单的代码来演示如何使用 Java 代码连接 MongoDB 数据库:
import com.mongodb.client.MongoDatabase;
import com.mongodb.MongoClient;
import com.mongodb.MongoCredential; 
public class ConnectToDB {
    public static void main( String args[] ) { 
        // 创建 MongoDB 连接
        MongoClient mongo = new MongoClient( "localhost" , 27017 );

        // 连接到 MongoDB
        MongoCredential credential;
        credential = MongoCredential.createCredential("sampleUser", "myDb", "password".toCharArray());
        System.out.println("Connected to the database successfully"); 

        // 访问数据库
        MongoDatabase database = mongo.getDatabase("myDb");
        System.out.println("Credentials ::"+ credential);    
    }
}
编译并运行上面的程序,即可创建名为“myDb”的数据库,并输出如下所示的内容:

$javac ConnectToDB.java
$java ConnectToDB
Connected to the database successfully
Credentials ::MongoCredential{
    mechanism = null,
    userName = 'sampleUser',
    source = 'myDb',
    password = <hidden>,
    mechanismProperties = {}
}

创建集合

若要创建集合,您可以使用 com.mongodb.client.MongoDatabase 类的 createCollection() 方法,示例代码如下:
import com.mongodb.client.MongoDatabase;
import com.mongodb.MongoClient;
import com.mongodb.MongoCredential; 
public class CreatingCollection {
    public static void main( String args[] ) { 
        // 创建 MongoDB 连接
        MongoClient mongo = new MongoClient( "localhost" , 27017 );

        // 连接到 MongoDB
        MongoCredential credential;
        credential = MongoCredential.createCredential("sampleUser", "myDb", "password".toCharArray());
        System.out.println("数据库连接成功"); 

        // 访问数据库
        MongoDatabase database = mongo.getDatabase("myDb"); 

        // 创建集合
        database.createCollection("tutorial");
        System.out.println("集合创建成功");
    }
}
编译并运行上面的程序,运行结果如下所示:

数据库连接成功
集合创建成功

获取/选择集合

要获取/选择数据库中的集合,您可以使用 com.mongodb.client.MongoDatabase 类的 getCollection() 方法,示例代码如下:
import com.mongodb.client.MongoCollection;
import com.mongodb.client.MongoDatabase;
import org.bson.Document;
import com.mongodb.MongoClient;
import com.mongodb.MongoCredential; 
public class selectingCollection {
    public static void main( String args[] ) { 
        // 创建 MongoDB 连接
        MongoClient mongo = new MongoClient( "localhost" , 27017 );

        // 连接到 MongoDB
        MongoCredential credential;
        credential = MongoCredential.createCredential("sampleUser", "myDb", "password".toCharArray());
        System.out.println("数据库连接成功"); 

        // 访问数据库
        MongoDatabase database = mongo.getDatabase("myDb"); 

        // 创建集合
        database.createCollection("tutorial");
        System.out.println("集合创建成功");
        // 检索集合
        MongoCollection<Document> collection = database.getCollection("tutorial");
        System.out.println("集合选择成功 tutorial");
    }
}
编译并运行上面的程序,运行结果如下所示:

数据库连接成功
集合创建成功
集合选择成功 tutorial

插入文档

想要向集合中插入文档,您可以使用 com.mongodb.client.MongoCollection 类的 insert() 方法,示例代码如下:
import com.mongodb.client.MongoCollection;
import com.mongodb.client.MongoDatabase;
import org.bson.Document;
import com.mongodb.MongoClient;
public class InsertingDocument {
    public static void main( String args[] ) {
    // 创建 MongoDB 连接
    MongoClient mongo = new MongoClient( "localhost" , 27017 );
    // 连接到数据库
    MongoDatabase database = mongo.getDatabase("myDb");
    // 创建集合
    database.createCollection("tutorial");
    System.out.println("集合创建成功");
    // 检索集合
    MongoCollection<Document> collection = database.getCollection("tutorial");
    System.out.println("集合选择成功");
    Document document = new Document("title", "MongoDB")
    .append("description", "database")
    .append("likes", 100)
    .append("url", "http://www.biancheng.net/mongodb/")
    .append("by", "编程帮");
   
    // 将文档插入到集合中
    collection.insertOne(document);
    System.out.println("文档插入成功");
}
编译并运行上面的程序,运行结果如下所示:

集合创建成功
集合选择成功
文档插入成功

查询文档

想要查询集合中的文档,您可以使用 com.mongodb.client.MongoCollection 类的 find() 方法,此方法会返回一个游标,因此想要查询集合中的所有文档您只需要不断迭代此游标即可,示例代码如下:
import com.mongodb.client.FindIterable;
import com.mongodb.client.MongoCollection;
import com.mongodb.client.MongoDatabase;
import java.util.ArrayList;
import java.util.Iterator;
import java.util.List;
import org.bson.Document;
import com.mongodb.MongoClient;
import com.mongodb.MongoCredential;
public class RetrievingAllDocuments {
    public static void main( String args[] ) {
        // 创建 MongoDB 连接
        MongoClient mongo = new MongoClient( "localhost" , 27017 );
       
        // 连接到 MongoDB
        MongoCredential credential;
        credential = MongoCredential.createCredential("sampleUser", "myDb", "password".toCharArray());
        System.out.println("数据库连接成功");
       
        // 连接到数据库
        MongoDatabase database = mongo.getDatabase("myDb");
       
        // 检索集合
        MongoCollection<Document> collection = database.getCollection("tutorial");
        System.out.println("成功选择了集合 tutorial");
        Document document1 = new Document("title", "MongoDB")
        .append("description", "database")
        .append("likes", 100)
        .append("url", "http://www.biancheng.net/mongodb/")
        .append("by", "编程帮");
        Document document2 = new Document("title", "html")
        .append("description", "database")
        .append("likes", 200)
        .append("url", "http://www.biancheng.net/html/")
        .append("by", "编程帮");
        List<Document> list = new ArrayList<Document>();
        list.add(document1);
        list.add(document2);
        collection.insertMany(list);
        // 获取 iterable 对象
        FindIterable<Document> iterDoc = collection.find();
        int i = 1;
        // 获取迭代器
        Iterator it = iterDoc.iterator();
        while (it.hasNext()) {
            System.out.println(it.next());
            i++;
        }
    }
}
编译并运行上面的程序,运行结果如下所示:

数据库连接成功
成功选择了集合 tutorial
Document{{_id=5dce4e9ff68a9c2449e197b2, title=MongoDB, description=database, likes=100, url=http://www.biancheng.net/mongodb/, by=编程帮}}
Document{{_id=5dce4e9ff68a9c2449e197b3, title=html, description=database, likes=200, url=http://www.biancheng.net/html/, by=编程帮}}

更新文档

要更新(修改)集合中文档的数据,您可以使用 com.mongodb.client.MongoCollection 类的 updateOne() 方法,示例代码如下:
import com.mongodb.client.FindIterable;
import com.mongodb.client.MongoCollection;
import com.mongodb.client.MongoDatabase;
import com.mongodb.client.model.Filters;
import com.mongodb.client.model.Updates;
import java.util.Iterator;
import org.bson.Document; 
import com.mongodb.MongoClient;
import com.mongodb.MongoCredential; 
public class UpdatingDocuments {
    public static void main( String args[] ) { 
        // 创建 MongoDB 连接
        MongoClient mongo = new MongoClient( "localhost" , 27017 );

        // 连接到 MongoDB
        MongoCredential credential;
        credential = MongoCredential.createCredential("sampleUser", "myDb", "password".toCharArray());
        System.out.println("数据库连接成功"); 

        // 连接到数据库
        MongoDatabase database = mongo.getDatabase("myDb");
        // 检索集合
        MongoCollection<Document> collection = database.getCollection("tutorial");
        System.out.println("成功选择了集合 tutorial");
        collection.updateOne(Filters.eq("title", 1), Updates.set("likes", 150));      
        System.out.println("文档更新成功..."); 

        // 更新后检索文档
        // 获取 iterable 对象
        FindIterable<Document> iterDoc = collection.find();
        int i = 1;
        // 获取迭代器
        Iterator it = iterDoc.iterator();
        while (it.hasNext()) { 
            System.out.println(it.next()); 
            i++;
        }    
    } 
}
编译并运行上面的程序,运行结果如下所示:

数据库连接成功
成功选择了集合 tutorial
文档更新成功...
Document{{_id=5dce4e9ff68a9c2449e197b2, title=MongoDB, description=database, likes=100, url=http://www.biancheng.net/mongodb/, by=编程帮}}
Document{{_id=5dce4e9ff68a9c2449e197b3, title=html, description=database, likes=200, url=http://www.biancheng.net/html/, by=编程帮}}

删除文档

想要从集合中删除文档,您可以使用 com.mongodb.client.MongoCollection 类的 deleteOne() 方法,示例代码如下:
import com.mongodb.client.FindIterable;
import com.mongodb.client.MongoCollection;
import com.mongodb.client.MongoDatabase;
import com.mongodb.client.model.Filters; 
import java.util.Iterator;
import org.bson.Document;
import com.mongodb.MongoClient;
import com.mongodb.MongoCredential; 
public class DeletingDocuments {
    public static void main( String args[] ) { 
        // 创建 MongoDB 连接
        MongoClient mongo = new MongoClient( "localhost" , 27017 );

        // 连接到 MongoDB
        MongoCredential credential;
        credential = MongoCredential.createCredential("sampleUser", "myDb", "password".toCharArray());
        System.out.println("数据库连接成功"); 

        // 访问数据库
        MongoDatabase database = mongo.getDatabase("myDb");
        // 检索集合
        MongoCollection<Document> collection = database.getCollection("tutorial");
        System.out.println("成功选择了集合 tutorial");
        // 删除文档
        collection.deleteOne(Filters.eq("title", "MongoDB"));
        System.out.println("文档删除成功..."); 

        // 更新后检索文档
        // 获取 iterable 对象
        FindIterable<Document> iterDoc = collection.find();
        int i = 1;
        // 获取迭代器
        Iterator it = iterDoc.iterator();
        while (it.hasNext()) { 
            System.out.println(it.next()); 
            i++;
        }      
    }
}
编译并运行上面的程序,运行结果如下所示:

数据库连接成功
成功选择了集合 tutorial
文档删除成功...
Document{{_id=5dce4e9ff68a9c2449e197b3, title=html, description=database, likes=200, url=http://www.biancheng.net/html/, by=编程帮}}

删除集合

要从数据库中删除集合,您可以使用 com.mongodb.client.MongoCollection 类中的 drop() 方法,示例代码如下:
import com.mongodb.client.MongoCollection;
import com.mongodb.client.MongoDatabase; 
import org.bson.Document; 
import com.mongodb.MongoClient;
import com.mongodb.MongoCredential; 
public class DropingCollection {
    public static void main( String args[] ) { 
        // 创建 MongoDB 连接
        MongoClient mongo = new MongoClient( "localhost" , 27017 );
        // 连接到 MongoDB
        MongoCredential credential;
        credential = MongoCredential.createCredential("sampleUser", "myDb", "password".toCharArray());
        System.out.println("数据库连接成功"); 

        // 访问数据库
        MongoDatabase database = mongo.getDatabase("myDb"); 

        // 创建集合
        System.out.println("集合创建成功");
        // 检索集合
        MongoCollection<Document> collection = database.getCollection("tutorial");
        // 删除集合
        collection.drop();
        System.out.println("集合删除成功");
    }
}
编译并运行上面的程序,运行结果如下所示:

数据库连接成功
集合创建成功
集合删除成功

列出所有集合

要列出数据库中的所有集合,您需要使用 com.mongodb.client.MongoDatabase 类的 listCollectionNames() 方法,示例代码如下:
import com.mongodb.client.MongoDatabase;
import com.mongodb.MongoClient;
import com.mongodb.MongoCredential; 
public class ListOfCollection {
    public static void main( String args[] ) { 
        // 创建 MongoDB 连接
        MongoClient mongo = new MongoClient( "localhost" , 27017 );
        // 连接到 MongoDB
        MongoCredential credential;
        credential = MongoCredential.createCredential("sampleUser", "myDb", "password".toCharArray());
        System.out.println("数据库连接成功"); 

        // 访问数据库
        MongoDatabase database = mongo.getDatabase("myDb");
        System.out.println("集合创建成功");
        for (String name : database.listCollectionNames()) {
            System.out.println(name);
        }
    }
}
编译并运行上面的程序,运行结果如下所示:

数据库连接成功
集合创建成功
myCollection
myCollection1
myCollection5

更多关于 Java 中 MongoDB 的操作可以参考 http://mongodb.github.io/mongo-java-driver/3.0/driver/getting-started/quick-tour/