changed all localhost examples to use 127.0.0.1. Localhost behaves strangely on some platforms.

Author: Ryan

src/main/com/mongodb/Mongo.java

@@ -28,7 +28,7 @@
 /**
  * A database connection with internal pooling.
  * For most application, you should have 1 Mongo instance for the entire JVM.
- * 
+ *
  * The following are equivalent, and all connect to the
  * local database running on the default port:
  *
@@ -45,18 +45,18 @@
  *
  * <h3>Connecting to a Replica Pair</h3>
  * <p>
- * You can connect to a 
+ * You can connect to a
  * <a href="http://www.mongodb.org/display/DOCS/Replica+Pairs">replica pair</a>
  * using the Java driver by passing two DBAddresses to the Mongo constructor.
  * For example:
  * </p>
  * <blockquote><pre>
- * DBAddress left = new DBAddress("localhost:27017/test");
- * DBAddress right = new DBAddress("localhost:27018/test");
+ * DBAddress left = new DBAddress("127.0.0.1:27017/test");
+ * DBAddress right = new DBAddress("127.0.0.1:27018/test");
  *
  * Mongo mongo = new Mongo(left, right);
  * </pre></blockquote>
- * 
+ *
  * <p>
  * If the master of a replica pair goes down, there will be a brief lag before
  * the slave becomes master.  Thus, your application should be prepared to catch
@@ -71,17 +71,17 @@
  *
  * <h3>Connecting to a Replica Set</h3>
  * <p>
- * You can connect to a 
+ * You can connect to a
  * <a href="http://www.mongodb.org/display/DOCS/Replica+Sets">replica set</a>
  * using the Java driver by passing several a list if ServerAddress to the
  * Mongo constructor.
  * For example:
  * </p>
  * <blockquote><pre>
  * List<ServerAddress> addrs = new ArrayList<ServerAddress>();
- * addrs.add( new ServerAddress( "localhost" , 27017 ) );
- * addrs.add( new ServerAddress( "localhost" , 27018 ) );
- * addrs.add( new ServerAddress( "localhost" , 27019 ) );
+ * addrs.add( new ServerAddress( "127.0.0.1" , 27017 ) );
+ * addrs.add( new ServerAddress( "127.0.0.1" , 27018 ) );
+ * addrs.add( new ServerAddress( "127.0.0.1" , 27019 ) );
  *
  * Mongo mongo = new Mongo( addrs );
  * </pre></blockquote>
@@ -198,7 +198,7 @@ public Mongo( ServerAddress addr , MongoOptions options )
      * <p>Creates a Mongo in paired mode. <br/> This will also work for
      * a replica set and will find all members (the master will be used by
      * default).</p>
-     * 
+     *
      * @see com.mongodb.ServerAddress
      * @param left left side of the pair
      * @param right right side of the pair
@@ -213,7 +213,7 @@ public Mongo( ServerAddress left , ServerAddress right )
      * <p>Creates a Mongo connection in paired mode. <br/> This will also work for
      * a replica set and will find all members (the master will be used by
      * default).</p>
-     * 
+     *
      * @see com.mongodb.ServerAddress
      * @param left left side of the pair
      * @param right right side of the pair
@@ -249,14 +249,14 @@ public Mongo( List<ServerAddress> replicaSetSeeds )
      * <p>Creates a Mongo based on a replica set, or pair.
      * It will find all members (the master will be used by default).</p>
      * @see com.mongodb.ServerAddress
-     * @param replicaSetSeeds put as many servers as you can in the list. 
+     * @param replicaSetSeeds put as many servers as you can in the list.
      *                       the system will figure the rest out
      * @param options default query options
      * @throws MongoException
-     */    
+     */
     public Mongo( List<ServerAddress> replicaSetSeeds , MongoOptions options )
         throws MongoException {
-        
+
         _addr = null;
         _addrs = replicaSetSeeds;
         _options = options;
@@ -273,20 +273,20 @@ public Mongo( List<ServerAddress> replicaSetSeeds , MongoOptions options )
      * @param uri
      * @see MongoURI
      * <p>examples:
-     *   <li>mongodb://localhost</li>
-     *   <li>mongodb://fred:foobar@localhost/</li>
+     *   <li>mongodb://127.0.0.1</li>
+     *   <li>mongodb://fred:foobar@127.0.0.1/</li>
      *  </p>
      *  @throws MongoException
      * @throws UnknownHostException
      * @dochub connections
-     */    
+     */
 
     public Mongo( MongoURI uri )
         throws MongoException , UnknownHostException {
 
         _options = uri.getOptions();
         _applyMongoOptions();
-        
+
         if ( uri.getHosts().size() == 1 ){
             _addr = new ServerAddress( uri.getHosts().get(0) );
             _addrs = null;
@@ -311,11 +311,11 @@ public Mongo( MongoURI uri )
      * @return
      */
     public DB getDB( String dbname ){
-        
+
         DB db = _dbs.get( dbname );
         if ( db != null )
             return db;
-        
+
         db = new DBApiLayer( this , dbname , _connector );
         DB temp = _dbs.putIfAbsent( dbname , db );
         if ( temp != null )
@@ -342,7 +342,7 @@ public List<String> getDatabaseNames()
 
         BasicDBObject cmd = new BasicDBObject();
         cmd.put("listDatabases", 1);
-        
+
 
         BasicDBObject res = (BasicDBObject)getDB( "admin" ).command(cmd, getOptions());
 
@@ -367,7 +367,7 @@ public List<String> getDatabaseNames()
      */
     public void dropDatabase(String dbName)
         throws MongoException {
-        
+
         getDB( dbName ).dropDatabase();
     }
 
@@ -480,7 +480,7 @@ public void setOptions( int options ){
     public void resetOptions(){
         _netOptions.reset();
     }
-   
+
     /**
      * gets the default query options
      * @return
@@ -510,26 +510,26 @@ DBTCPConnector getConnector() {
     private WriteConcern _concern = WriteConcern.NORMAL;
     final Bytes.OptionHolder _netOptions = new Bytes.OptionHolder( null );
     final DBCleanerThread _cleaner;
-    
-    org.bson.util.SimplePool<PoolOutputBuffer> _bufferPool = 
+
+    org.bson.util.SimplePool<PoolOutputBuffer> _bufferPool =
         new org.bson.util.SimplePool<PoolOutputBuffer>( 1000 ){
-        
+
         protected PoolOutputBuffer createNew(){
             return new PoolOutputBuffer();
         }
-        
+
     };
 
 
-    // -------   
+    // -------
+
 
-    
     /**
      * Mongo.Holder can be used as a static place to hold several instances of Mongo.
      * Security is not enforced at this level, and needs to be done on the application side.
      */
     public static class Holder {
-        
+
         /**
          * Attempts to find an existing Mongo instance matching that URI in the holder, and returns it if exists.
          * Otherwise creates a new Mongo instance based on this URI and adds it to the holder.
@@ -542,19 +542,19 @@ public Mongo connect( MongoURI uri )
             throws MongoException , UnknownHostException {
 
             String key = _toKey( uri );
-            
+
             Mongo m = _mongos.get(key);
             if ( m != null )
                 return m;
 
             m = new Mongo( uri );
-            
+
             Mongo temp = _mongos.putIfAbsent( key , m );
             if ( temp == null ){
                 // ours got in
                 return m;
             }
-            
+
             // there was a race and we lost
             // close ours and return the other one
             m.close();
@@ -570,9 +570,9 @@ String _toKey( MongoURI uri ){
             return buf.toString();
         }
 
-        
+
         private static final ConcurrentMap<String,Mongo> _mongos = new ConcurrentHashMap<String,Mongo>();
-        
+
     }
 
     class DBCleanerThread extends Thread {

src/main/com/mongodb/MongoURI.java

@@ -13,22 +13,22 @@
 public class MongoURI {
 
     public static final String MONGODB_PREFIX = "mongodb://";
-    
+
     /**
      * Creates a MongoURI described by a String.
      * examples
-     *   mongodb://localhost
-     *   mongodb://fred:foobar@localhost/
+     *   mongodb://127.0.0.1
+     *   mongodb://fred:foobar@127.0.0.1/
      * @param uri the URI
      * @dochub connections
      */
     public MongoURI( String uri ){
         _uri = uri;
         if ( ! uri.startsWith( MONGODB_PREFIX ) )
             throw new IllegalArgumentException( "uri needs to start with " + MONGODB_PREFIX );
-        
+
         uri = uri.substring(MONGODB_PREFIX.length());
-        
+
         String serverPart;
         String nsPart;
         String optionsPart;
@@ -43,7 +43,7 @@ public MongoURI( String uri ){
             else {
                 serverPart = uri.substring( 0 , idx );
                 nsPart = uri.substring( idx + 1 );
-                
+
                 idx = nsPart.indexOf( "?" );
                 if ( idx >= 0 ){
                     optionsPart = nsPart.substring( idx + 1 );
@@ -52,14 +52,14 @@ public MongoURI( String uri ){
                 else {
                     optionsPart = null;
                 }
-                    
+
             }
         }
-        
+
         { // _username,_password,_hosts
             List<String> all = new LinkedList<String>();
-            
-            
+
+
             if ( serverPart.indexOf( "@" ) > 0 ){
                 int idx = serverPart.indexOf( "@" );
                 _username = serverPart.substring( 0 , idx );
@@ -76,10 +76,10 @@ public MongoURI( String uri ){
 
             for ( String s : serverPart.split( "," ) )
                 all.add( s );
-            
+
             _hosts = Collections.unmodifiableList( all );
         }
-        
+
         if ( nsPart != null ){ // _database,_collection
             int idx = nsPart.indexOf( "." );
             if ( idx < 0 ){
@@ -141,7 +141,7 @@ boolean _parseBoolean( String _in ){
     public String getUsername(){
         return _username;
     }
-    
+
     /**
      * Gets the password
      * @return
@@ -157,7 +157,7 @@ public char[] getPassword(){
     public List<String> getHosts(){
         return _hosts;
     }
-     
+
     /**
      * Gets the database name
      * @return