_newCursor
_newCursor
Utility method which concrete subclasses are expected to implement for creating a new instance of the correct cursor implementation from a Java cursor. Good with cursor calls that return a new cursor. Should figure out the right type to return based on typing setup.
(DBCursor)
(MongoCursorBase)
_newInstance
_newInstance
Utility method which concrete subclasses are expected to implement for creating a new instance of THIS concrete implementation from a Java collection. Good with calls that return a new collection.
(this.type)
The underlying Java Mongo Driver Collection object we proxy.
The underlying Java Mongo Driver Collection object we proxy.
Save an object to the Collection
Save an object to the Collection
object to save to the collection
Remove a matching object from the collection
Remove a matching object from the collection
object to remove from the collection
Manipulate Network Options
Manipulate Network Options
com.mongodb.Bytes
com.mongodb.Mongo
performs an aggregation operation
performs an aggregation operation
the aggregation pipeline
The aggregation operation's result set
performs an aggregation operation
performs an aggregation operation
the aggregation pipeline
The aggregation operation's result set
Adds the "private" fields _id to an object.
Adds the "private" fields _id to an object.
object to which to add fields
whether to add an _id field or not
the modified object o
Adds the "private" fields _id to an object.
Adds the "private" fields _id to an object.
DBObject to which to add fields
the modified parameter object
Find a collection that is prefixed with this collection's name.
Find a collection that is prefixed with this collection's name. A typical use of this might be
Which is equilalent toDBCollection users = mongo.getCollection( "wiki" ).getCollection( "users" );
DBCollection users = mongo.getCollection( "wiki.users" );
the name of the collection to find
the matching collection
TODO - Make this support type construction
Forces creation of an index on a set of fields, if one does not already exist.
Forces creation of an index on a set of fields, if one does not already exist.
an object with a key set of the fields desired for the index
Returns the database this collection is a member of.
Returns the database this collection is a member of.
this collection's database
find distinct values for a key
find distinct values for a key
query to apply on collection
Drops (deletes) this collection
Drops (deletes) this collection
Drops (deletes) this collection
Drops (deletes) this collection
Drops all indices from this collection
Drops all indices from this collection
Ensures an index on this collection (that is, the index will be created if it does not exist).
Ensures an index on this collection (that is, the index will be created if it does not exist). ensureIndex is optimized and is inexpensive if the index already exists. This creates an ascending index on a particular field.
Ensures an optionally unique index on this collection.
Ensures an optionally unique index on this collection.
fields to use for index
an identifier for the index
if the index should be unique
Ensures an index on this collection (that is, the index will be created if it does not exist).
Ensures an index on this collection (that is, the index will be created if it does not exist). ensureIndex is optimized and is inexpensive if the index already exists.
fields to use for index
an identifier for the index
Ensures an index on this collection (that is, the index will be created if it does not exist).
Ensures an index on this collection (that is, the index will be created if it does not exist). ensureIndex is optimized and is inexpensive if the index already exists.
fields to use for index
options for the index (name, unique, etc)
Creates an index on a set of fields, if one does not already exist.
Creates an index on a set of fields, if one does not already exist.
an object with a key set of the fields desired for the index
Checks if this collection is equal to another object.
Checks if this collection is equal to another object.
if the two collections are the same object
Finds an object.
Finds an object.
query used to search
the fields of matching objects to return
will not return the first numToSkip matches
if positive, is the # of objects per batch sent back from the db. all objects that match will be returned. if batchSize < 0, its a hard limit, and only 1 batch will either batchSize or the # that fit in a batch
the objects, if found
Queries for an object in this collection.
Queries for an object in this collection.
An empty DBObject will match every document in the collection. Regardless of fields specified, the _id fields are always returned.
An example that returns the "x" and "_id" fields for every document in the collection that has an "x" field:
BasicDBObject keys = new BasicDBObject();
keys.put("x", 1);
DBCursor cursor = collection.find(new BasicDBObject(), keys);
object for which to search
fields to return
a cursor to iterate over results
Queries for an object in this collection.
Queries for an object in this collection.
object for which to search
an iterator over the results
Queries for all objects in this collection.
Queries for all objects in this collection.
a cursor which will iterate over every object
Finds the first document in the query and updates it.
Finds the first document in the query and updates it.
the old document
Finds the first document in the query (sorted) and updates it.
Finds the first document in the query (sorted) and updates it.
the old document
Finds the first document in the query (sorted) and updates it.
Finds the first document in the query (sorted) and updates it. If remove is specified it will be removed. If new is specified then the updated document will be returned, otherwise the old document is returned (or it would be lost forever). You can also specify the fields to return in the document, optionally.
(Option[T]) of the the found document (before, or after the update)
Finds the first document in the query and removes it.
Finds the first document in the query and removes it.
the removed document
Returns a single object from this collection matching the query.
Returns a single object from this collection matching the query.
the query object
fields to return
(Option[T]) Some() of the object found, or None if no such object exists
Returns a single object from this collection matching the query.
Returns a single object from this collection matching the query.
the query object
(Option[T]) Some() of the object found, or None if no such object exists
Returns a single object from this collection.
Returns a single object from this collection.
(Option[T]) Some() of the object found, or None if this collection is empty
Find an object by its ID.
Find an object by its ID. Finds an object by its id. This compares the passed in value to the _id field of the document.
Returns a single object from this collection matching the query.
the id to match
fields to return
(Option[T]) Some() of the object found, or None if no such object exists
Find an object by its ID.
Find an object by its ID. Finds an object by its id. This compares the passed in value to the _id field of the document.
Returns a single object from this collection matching the query.
the id to match
(Option[T]) Some() of the object found, or None if no such object exists
Returns the full name of this collection, with the database name as a prefix.
Returns the full name of this collection, with the database name as a prefix.
the name of this collection
Find a collection that is prefixed with this collection's name.
Find a collection that is prefixed with this collection's name. A typical use of this might be
Which is equilalent toDBCollection users = mongo.getCollection( "wiki" ).getCollection( "users" );
DBCollection users = mongo.getCollection( "wiki.users" );
the name of the collection to find
the matching collection
TODO - Make this support type construction
Returns the number of documents in the collection that match the specified query
Returns the number of documents in the collection that match the specified query
query to select documents to count
fields to return
Max # of fields
# of fields to skip
number of documents that match query and fields
Returns the database this collection is a member of.
Returns the database this collection is a member of.
this collection's database
Returns the full name of this collection, with the database name as a prefix.
Returns the full name of this collection, with the database name as a prefix.
the name of this collection
Return a list of the indexes for this collection.
Return a list of the indexes for this collection. Each object in the list is the "info document" from MongoDB
list of index documents
Gets the the error (if there is one) from the previous operation.
Gets the the error (if there is one) from the previous operation. The result of this command will look like
{ "err" : errorMessage , "ok" : 1.0 }
The value for errorMessage will be null if no error occurred, or a description otherwise.
Care must be taken to ensure that calls to getLastError go to the same connection as that of the previous operation. See com.mongodb.Mongo.requestStart for more information.
DBObject with error and status information
Gets the default class for objects in the collection
Gets the default class for objects in the collection
the class
Manipulate Network Options
Manipulate Network Options
com.mongodb.Bytes
com.mongodb.Mongo
Gets the read preference for this collection.
Gets the read preference for this collection. Will be used as default for
reads from any collection in this collection. See the
documentation for ReadPreference for more information.
get the write concern for this database, which is used for writes to any collection in this database.
get the write concern for this database,
which is used for writes to any collection in this database.
See the documentation for com.mongodb.WriteConcern for more info.
http://www.thebuzzmedia.com/mongodb-single-server-data-durability-guide/
WriteConcern
Enables you to call group with the finalize parameter (a function that runs on each row of the output for calculations before sending a return) which the Mongo Java driver does not yet support, by sending a direct DBObject command.
Enables you to call group with the finalize parameter (a function that runs on each row of the output for calculations before sending a return) which the Mongo Java driver does not yet support, by sending a direct DBObject command. Messy, but it works.
Set hint fields for this collection.
Set hint fields for this collection.
Return a list of the indexes for this collection.
Return a list of the indexes for this collection. Each object in the list is the "info document" from MongoDB
list of index documents
Saves document(s) to the database.
Saves document(s) to the database. if doc doesn't have an _id, one will be added you can get the _id that was added from doc after the insert
Saves document(s) to the database.
Saves document(s) to the database. if doc doesn't have an _id, one will be added you can get the _id that was added from doc after the insert
mapReduce Execute a mapReduce against this collection.
mapReduce Execute a mapReduce against this collection. NOTE: JSFunction is just a type alias for String
(JSFunction) The JavaScript to execute for the map function
(JSFunction) The JavaScript to execute for the reduce function
Gets the default class for objects in the collection
Gets the default class for objects in the collection
the class
setObjectClass
setObjectClass
Set a subtype of DBObject which will be used to deserialize documents returned from MongoDB.
This method will return a new MongoTypedCollection[A]
which you should capture if you want explicit casting.
Else, this collection will instantiate instances of A but cast them to
the current T (DBObject if you have a generic collection)
A Subtype of DBObject
(Class[A])
Manipulate Network Options
Manipulate Network Options
com.mongodb.Bytes
com.mongodb.Mongo
Gets the read preference for this collection.
Gets the read preference for this collection. Will be used as default for
reads from any collection in this collection. See the
documentation for ReadPreference for more information.
Sets the read preference for this collection.
Sets the read preference for this collection. Will be used as default for
reads from any collection in this collection. See the
documentation for ReadPreference for more information.
Removes objects from the database collection.
Removes objects from the database collection.
the object that documents to be removed must match
WriteConcern for this operation TODO - Wrapper for WriteResult?
does a rename of this collection to newName As per the Java API this returns a *NEW* Collection, and the old collection is probably no good anymore.
does a rename of this collection to newName As per the Java API this returns a *NEW* Collection, and the old collection is probably no good anymore.
This collection *WILL NOT* mutate --- the instance will still point at a now nonexistant collection with the old name ... You must capture the return value for the new instance.
new collection name (not a full namespace)
if a collection with the new name exists, whether or not to drop it
the new collection
does a rename of this collection to newName As per the Java API this returns a *NEW* Collection, and the old collection is probably no good anymore.
does a rename of this collection to newName As per the Java API this returns a *NEW* Collection, and the old collection is probably no good anymore.
This collection *WILL NOT* mutate --- the instance will still point at a now nonexistant collection with the old name ... You must capture the return value for the new instance.
new collection name (not a full namespace)
the new collection
write concern aware write op block.
write concern aware write op block.
Checks getLastError after the last write. If you run multiple ops you'll only get the final error.
Your op function gets a copy of this MongoDB instance.
This is for write ops only - you cannot return data from it.
Your function must return WriteResult, which is the return type of any mongo write operation like insert/save/update/remove
write concern aware write op block.
write concern aware write op block.
Checks getLastError after the last write. If you run multiple ops you'll only get the final error.
Your op function gets a copy of this MongoDB instance.
This is for write ops only - you cannot return data from it.
Your function must return WriteResult, which is the return type of any mongo write operation like insert/save/update/remove
write concern aware write op block.
write concern aware write op block.
Checks getLastError after the last write. If you run multiple ops you'll only get the final error.
Your op function gets a copy of this MongoDB instance.
This is for write ops only - you cannot return data from it.
Your function must return WriteResult, which is the return type of any mongo write operation like insert/save/update/remove
If you have set a connection or DB level WriteConcern, it will be inherited.
Clears all indices that have not yet been applied to this collection.
Clears all indices that have not yet been applied to this collection.
Manipulate Network Options
Manipulate Network Options
com.mongodb.Bytes
com.mongodb.Mongo
Saves an object to this collection.
Saves an object to this collection.
the DBObject to save
will add _id field to o if needed
TODO - Wrapper for WriteResult?
Set hint fields for this collection.
Set hint fields for this collection.
setObjectClass
setObjectClass
Set a subtype of DBObject which will be used to deserialize documents returned from MongoDB.
This method will return a new MongoTypedCollection[A]
which you should capture if you want explicit casting.
Else, this collection will instantiate instances of A but cast them to
the current T (DBObject if you have a generic collection)
A Subtype of DBObject
TODO - Ensure proper subtype return
(Class[A])
Sets the read preference for this collection.
Sets the read preference for this collection. Will be used as default for
reads from any collection in this collection. See the
documentation for ReadPreference for more information.
Set the write concern for this database.
Set the write concern for this database.
Will be used for writes to any collection in this database.
See the documentation for com.mongodb.WriteConcern for more info.
(WriteConcern) The write concern to use
http://www.thebuzzmedia.com/mongodb-single-server-data-durability-guide/
WriteConcern
Performs an update operation.
Performs an update operation.
search query for old object to update
object with which to update q TODO - Wrapper for WriteResult?
get the write concern for this database, which is used for writes to any collection in this database.
get the write concern for this database,
which is used for writes to any collection in this database.
See the documentation for com.mongodb.WriteConcern for more info.
http://www.thebuzzmedia.com/mongodb-single-server-data-durability-guide/
WriteConcern
Set the write concern for this database.
Set the write concern for this database.
Will be used for writes to any collection in this database.
See the documentation for com.mongodb.WriteConcern for more info.
(WriteConcern) The write concern to use
http://www.thebuzzmedia.com/mongodb-single-server-data-durability-guide/
WriteConcern
Sets queries to be OK to run on slave nodes.
Sets queries to be OK to run on slave nodes.
(Since version 2.3.0) Replaced with ReadPreference.SECONDARY
Perform a multi update
Perform a multi update
search query for old object to update
object with which to update q
(Since version 2.3.0) In the face of default arguments this is a bit silly. Please use update(multi=True)
Concrete collection implementation for typed Cursor operations via Collection.setObjectClass et al This is a special case collection for typed operations
2.0, 12/23/10
1.0