monger.core — com.novemberain/monger 3.6.0

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 [add-cluster-listener add-cluster-listeners add-command-listener
          add-command-listeners add-connection-pool-listener
          add-connection-pool-listeners add-server-listener add-server-listeners
          add-server-monitor-listener add-server-monitor-listeners
          always-use-mbeans application-name codec-registry compressor-list
          connect-timeout connections-per-host cursor-finalizer-enabled
          db-decoder-factory db-encoder-factory description
          heartbeat-connect-timeout heartbeat-frequency heartbeat-socket-timeout
          local-threshold max-connection-idle-time max-connection-life-time
          max-wait-time min-connections-per-host min-heartbeat-frequency
          read-concern read-preference required-replica-set-name retry-writes
          server-selection-timeout server-selector socket-keep-alive
          socket-factory socket-timeout ssl-context ssl-enabled
          ssl-invalid-host-name-allowed
          threads-allowed-to-block-for-connection-multiplier uuid-representation
          write-concern]})

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)