monger.core — org.clojars.bolamn/monger 3.2.0-SNAPSHOT

Thin idiomatic wrapper around MongoDB Java client. monger.core includes fundamental functions that perform database/replica set connection, set default write concern, default database, performing commands and so on. Most of the functionality is in other monger.* namespaces, in particular monger.collection, monger.query and monger.gridfs

Related documentation guides:

• http://clojuremongodb.info/articles/connecting.html
• http://clojuremongodb.info/articles/commands.html
• http://clojuremongodb.info/articles/gridfs.html

*mongodb-host* clj

*mongodb-port* clj

*mongodb-write-concern* clj

admin-db clj

(admin-db conn)

Returns admin database

admin-db-name clj

command clj

(command database cmd)

Runs a database command (please check MongoDB documentation for the complete list of commands).

Ordering of keys in the command document may matter. Please use sorted maps instead of map literals, for example: (array-map :near 50 :test 430 :num 10)

For commonly used commands (distinct, count, map/reduce, etc), use monger.command and monger.collection functions such as /distinct, /count, /drop, /dropIndexes, and /mapReduce respectively.

connect clj

(connect)

(connect {:keys [host port uri] :or {host *mongodb-host* port *mongodb-port*}})

(connect server-address options)

(connect [server-address & more] options)

(connect server-address options credentials)

Connects to MongoDB. When used without arguments, connects to

Arguments: :host ("127.0.0.1" by default) :port (27017 by default)

connect-via-uri clj

(connect-via-uri uri-string)

Connects to MongoDB using a URI, returns the connection and database as a map with :conn and :db. Commonly used for PaaS-based applications, for example, running on Heroku. If username and password are provided, performs authentication.

connect-with-credentials clj

(connect-with-credentials credentials)

(connect-with-credentials hostname credentials)

(connect-with-credentials hostname port credentials)

Connect with provided credentials and default options

Countable clj protocol

count clj

(count this)

Returns size of the object

disconnect clj

(disconnect conn)

Closes default connection to MongoDB

drop-db clj

(drop-db conn db)

Drops a database

get-db clj

(get-db conn name)

Get database reference by name.

get-db-names clj

(get-db-names conn)

Gets a list of all database names present on the server

get-gridfs clj

(get-gridfs conn name)

Get GridFS for the given database.

mongo-options clj

(mongo-options opts)

mongo-options-builder clj

(mongo-options-builder
  {:keys
     [connections-per-host threads-allowed-to-block-for-connection-multiplier
      max-wait-time connect-timeout socket-timeout socket-keep-alive
      auto-connect-retry max-auto-connect-retry-time description write-concern
      cursor-finalizer-enabled read-preference required-replica-set-name
      add-command-listener always-use-mbeans codec-registry db-decoder-factory
      db-encoder-factory heartbeat-connect-timeout heartbeat-frequency
      heartbeat-socket-timeout local-threshold max-connection-idle-time
      max-connection-life-time min-connections-per-host min-heartbeat-frequency
      read-concern server-selection-timeout socket-factory ssl-enabled
      ssl-invalid-host-name-allowed]})

raw-command clj

(raw-command database cmd)

Like monger.core/command but accepts DBObjects

server-address clj

(server-address hostname)

(server-address hostname port)

set-default-write-concern! clj

(set-default-write-concern! wc)