com.mongodb
Class Mongo

java.lang.Object
  com.mongodb.Mongo

public class Mongo
extends java.lang.Object

A database connection with internal pooling. The following are equivalent, and all connect to the local database running on the default port:

 Mongo mongo1 = new Mongo( "127.0.0.1" );
 Mongo mongo2 = new Mongo( "127.0.0.1", 27017 );
 Mongo mongo3 = new Mongo( new DBAddress( "127.0.0.1:27017", "test" ) )
 

Mongo instances have connection pooling built in - see the requestStart and requestDone methods for more information. http://www.mongodb.org/display/DOCS/Java+Driver+Concurrency

Field Summary

static int	MAJOR_VERSION
static int	MINOR_VERSION

Constructor Summary

Mongo()

Mongo(DBAddress addr)
Connects to Mongo using a given DBAddress

Mongo(DBAddress left, DBAddress right)
creates a Mongo connection in paired mode

Mongo(DBAddress left, DBAddress right, MongoOptions options)
creates a Mongo connection in paired mode

Mongo(DBAddress addr, MongoOptions options)
Connects to Mongo using a given DBAddress

Mongo(java.lang.String host)
Connects to the local mongo instance on default port.

Mongo(java.lang.String host, int port)
Connects to Mongo using a given host, port, and database.

Method Summary

static DB	connect(DBAddress addr)
java.lang.String	debugString()
void	dropDatabase(java.lang.String dbName) Drops the database if it exists.
DBAddress	getAddress() Gets the address of this database.
java.lang.String	getConnectPoint()
java.util.List<java.lang.String>	getDatabaseNames()
DB	getDB(java.lang.String dbname)
java.lang.String	getVersion()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

MAJOR_VERSION

public static final int MAJOR_VERSION

See Also:

Constant Field Values

MINOR_VERSION

public static final int MINOR_VERSION

See Also:

Constant Field Values

Constructor Detail

Mongo

public Mongo()
      throws java.net.UnknownHostException,
             MongoException

Throws:

java.net.UnknownHostException

MongoException

Mongo

public Mongo(java.lang.String host)
      throws java.net.UnknownHostException,
             MongoException

Connects to the local mongo instance on default port.

Parameters:

host - server to connect to

Throws:

java.net.UnknownHostException - if the database host cannot be resolved

MongoException

Mongo

public Mongo(java.lang.String host,
             int port)
      throws java.net.UnknownHostException,
             MongoException

Connects to Mongo using a given host, port, and database.

Parameters:

host - the database's host address

port - the port on which the database is running

Throws:

java.net.UnknownHostException - if the database host cannot be resolved

MongoException

Mongo

public Mongo(DBAddress addr)
      throws MongoException

Connects to Mongo using a given DBAddress

Parameters:

addr - the database address

Throws:

MongoException

See Also:

DBAddress

Mongo

public Mongo(DBAddress addr,
             MongoOptions options)
      throws MongoException

Connects to Mongo using a given DBAddress

Parameters:

addr - the database address

Throws:

MongoException

See Also:

DBAddress

Mongo

public Mongo(DBAddress left,
             DBAddress right)
      throws MongoException

creates a Mongo connection in paired mode

Parameters:

left - left side of the pair

right - right side of the pair

Throws:

MongoException

Mongo

public Mongo(DBAddress left,
             DBAddress right,
             MongoOptions options)
      throws MongoException

creates a Mongo connection in paired mode

Parameters:

left - left side of the pair

right - right side of the pair

Throws:

MongoException

Method Detail

connect

public static DB connect(DBAddress addr)

getDB

public DB getDB(java.lang.String dbname)

getDatabaseNames

public java.util.List<java.lang.String> getDatabaseNames()
                                                  throws MongoException

Throws:

MongoException

dropDatabase

public void dropDatabase(java.lang.String dbName)
                  throws MongoException

Drops the database if it exists.

Parameters:

dbName - name of database to drop

Throws:

MongoException

getVersion

public java.lang.String getVersion()

debugString

public java.lang.String debugString()

getConnectPoint

public java.lang.String getConnectPoint()

getAddress

public DBAddress getAddress()

Gets the address of this database.

Returns:

the address