Mongo Driver Requirements

Mongo m = new Mongo();   // go to localhost, default port

Mongo m = new Mongo(String host, int port);

ServerPair sp = new ServerPair(INETAddr...);  // should be able to give only one and it discovers the rest?
Mongo m = new Mongo(sp)

ServerPair sp = new ServerPair(INETAddr...);  // should be able to give only one and it discovers the rest?
sp.setTarget(ServerPair.SHADOW_MASTER);
Mongo m = new Mongo(sp);

Mongo m = new Mongo();

DB db = m.getDB(name);

List<String> getDBNameList();

/**
 *  get name of database
 */
String    dbName = db.getName();

/**
 * Get a list of all the collection names in this database
 */
List<String> cols = db.getCollectionNames();

/**
 * get a collection object.  Can optionally create it if it
 *  doesn't exist, or just  be strict.  (XJDM has strictness as an option)
 */
Collection coll = db.getCollection(string);

/**
 * Create a collection w/ optional options.  Can fault
 * if the collection exists, or can just return it if it already does
 */
Collection coll = db.createCollection( string);
Collection coll = db.createCollection( string, options);

/**
 * Drop a collection by its name or by collection object.
 * Driver could invalidate any outstanding Collection objects
 * for that collection, or just hope for the best.
 */
boolean  b  = db.dropCollection(name);
boolean  b  = db.dropCollection(Collection);

/**
 * Execute a command on the database, returning the
 * BSON doc with the results
 */
Document d = db.executeCommand(command);

/**
 * Close the [logical] database
 */
void  db.close();

/**
 * Erase / drop an entire database
 */
bool dropDatabase(dbname)

/* get an admin object from a database object. */
Admin admin = db.getAdmin();

/**
 * Get profiling level. Returns one of the strings "off", "slowOnly", or
 * "all". Note that the database returns an integer. This method could
 * return an int or an enum instead --- in Ruby, for example, we return
 * symbols.
 */
String profilingLevel = admin.getProfilingLevel();

/**
 * Set profiling level. Takes whatever getProfilingLevel() returns.
 */
admin.setProfilingLevel("off");

/**
 * Retrieves the database's profiling info.
 */
Document profilingInfo = admin.getProfilingInfo();

/**
 * Returns true if collection is valid; raises an exception if not.
 */
boolean admin.validateCollection(collectionName);

/**
 *   full query capabilities - limit, skip, returned fields, sort, etc
 */
Cursor        find(...);

void          insert(...) // insert one or more objects into the collection, local variants on args
void          remove(query) // remove objects that match the query
void          modify(selector, modifier)  // modify all objects that match selector w/ modifier object
void          replace(selector, object)   // replace first object that match selector w/ specified object
void          repsert(selector, object)   // replace first object that matches, or insert  **upsert w/ modifier makes no logical sense*
long          getCount();
long          getCount(query);

void          createIndex( index_info)
void          dropIndex(name)
void          dropIndexes()
List<info>    getIndexInformation()

document      explain(query)
options       getOptions();
string        getName();
void          close();

document      getNextDocument()
iterator      getIterator()  // again, local to language
bool          hasMore()
void          close()

/**
 *  resolve a DBRef, with recursion.  This is a potentially dangerous operation, as the
 *  resulting document graph - and thus the resulting single document, can be arbitrarily
 *  and surprisingly large
 */
Document resolveReference(DBRef ref, boolean recurse);

/**
 *
 *  From JS, this is a caching index function that supported the
 *  multiple re-entry and re-initialization model on the app server.  It's a far
 *  more difficult operation outside of the controlled environment of an app server, since
 *  one process has no clue about what other code might be doing (like dropping the index)
 *
 * Put here for completeness
 */
boolean coll.ensureIndex(...);

/**
 *   "saves" a document - this means that if it's already blessed with an _id, the doc
 *   in the database is updated, and if it doesn't have an _id, and _id is injected and then
 *   the doc is inserted into the collection.
 *
 *   There are some interesting implications here now that we're considering relaxing
 *   the constraint on _id being a BabbleOID, and letting it be anything.  There will have to
 *   be some kind of "PKInjector" (see the XJDM) where the programmer can give the level 1
 *   driver an _id factory....
 */
void  coll.save(Document doc);