mongo-java-driver源码简析

mongo-java-driver是java语言操作mongodb数据库的驱动包，封装了针对mongodb的相关操作。其中关键的接口和类有如下一些：

Mongo&&MongoClient

Mongo

Mongo是一个MongoDB的数据库连接，内置了连接池。对于大多数应用来说，整个JVM使用一个Mongo实例。
Mongo可以使用单数据库实例，也可以使用数据库集群，在构造实例的时候如果传递的是一个ServerAddress则是单数据库实例，如果传递的是一个ServerAddress的List则是数据库集群（有可能是一个分片集群，Mongo回自动检测ServerAddress列表是复制集还是分片）。
默认情况下，所有的读写操作都会在primary数据库上进行，不过可以通过修改Read Preference来让读操作分配到secondary数据库上。
默认情况下，写操作不会在失败的时候抛出异常，不过可以通过修改Write Concern来改变这一行为。
如下是Mongo的构造方法，可以看到大部分已经deprecated。
这里写图片描述
如下是Mongo的操作方法：

关键属性有两个：

MongoClient

MongoClient已经取代了Mongo，目前在程序中操作Mongo应该使用MongoClient接口类。它是从Mongo派生的。
与Mongo不同的地方在于：Write Concern这个属性改变为acknowledgment，即写操作会等待服务器返回确认。另外，它的构造方法接受MongoClientURI和MongoClientOptions。
属性有两个，如下：
这里写图片描述

MongoAuthority

该类代表了用户要进行连接的权限，它是Mongo的一个属性。
这里主要说明一下其type属性，是一个枚举值，表明连接的类型。Direct代表直连，Set代表复制集。

MongoCredential

MongoCredential代表一个Mongo服务器的认证凭据，以及信任来源，认证机制等。
主要包括userName，password，source，mechanism四个属性。

MongoOptions&&MongoClientOptions

MongoOptions

MongoOptions为Mongo实例设置相关属性。
这个类不是线程安全的，已经被MongoClientOptions所取代。
可以设置的属性列表如下，大部分都已经被属性命名表意：

connectionsPerHost = Bytes.CONNECTIONS_PER_HOST;
        threadsAllowedToBlockForConnectionMultiplier = 5;
        maxWaitTime = 1000 * 60 * 2;
        connectTimeout = 1000 * 10;
        socketTimeout = 0;
        socketKeepAlive = false;
        autoConnectRetry = false;
        maxAutoConnectRetryTime = 0;
        slaveOk = false;
        readPreference = null;
        writeConcern = null;
        safe = false;
        w = 0;
        wtimeout = 0;
        fsync = false;
        j = false;
        dbDecoderFactory = DefaultDBDecoder.FACTORY;
        dbEncoderFactory = DefaultDBEncoder.FACTORY;
        socketFactory = SocketFactory.getDefault();
        description = null;
        cursorFinalizerEnabled = true;
        alwaysUseMBeans = false;
        minConnectionsPerHost = 0;
        maxConnectionIdleTime = 0;
        maxConnectionLifeTime = 0;
        heartbeatFrequencyMS = Integer.parseInt(System.getProperty("com.mongodb.updaterIntervalMS", "5000"));
        heartbeatConnectRetryFrequencyMS = Integer.parseInt(System.getProperty("com.mongodb.updaterIntervalNoMasterMS", "10"));
        heartbeatConnectTimeoutMS = Integer.parseInt(System.getProperty("com.mongodb.updaterConnectTimeoutMS", "20000"));
        heartbeatReadTimeoutMS = Integer.parseInt(System.getProperty("com.mongodb.updaterSocketTimeoutMS", "20000"));
        heartbeatThreadCount = 0;
        acceptableLatencyDifferenceMS = Integer.parseInt(System.getProperty("com.mongodb.slaveAcceptableLatencyMS", "15"));
        requiredReplicaSetName = null;

MongoClientOptions

MongoClientOptions为MongoClient实例设置相关属性。
该类是一个Immutable类，即不可变类，创建以后就不允许修改了。
与MongoOptions设置最主要的区别就是Write Concern的设置。
这里写图片描述
需要说明一下的是threadsAllowedToBlockForConnectionMultiplier，这个地方设置的不是具体的线程数，而是一个乘数（该属性与connectionsPerHost的乘积是可以阻塞等待连接的线程数，超过该乘积的线程将会及时得到一个异常）。