TL;DR
Monger is an idiomatic Clojure MongoDB driver for a more civilized age. It has batteries included, offers powerful expressive query DSL, strives to support every MongoDB 2.0+ feature and has sane defaults. It also has solid documentation.
3.0.0
is a major release based on version 3.0
of the MongoDB Java driver.
We are only getting started with migrating to the 3.0 Java
driver. This release focuses on removing Monger API elements that are
no longer available. There are quite a few impovements that Monger
can use: more efficient serislisation API, asynchronous API, and so on.
Monger will make use of those in future 3.x
releases.
We’d like to thank Jeff Yemin and Ross Lawley from MongoDB for helping us migrate, sharing Java client roadmap, and answering our endless questions. Monger 3.0 would ship months later if this wasn’t for them.
Changes between 2.1.0 and 3.0.0
Monger 3.0 is based on the MongoDB Java driver 3.0 and has some (relatively minor) breaking API changes.
Error Handling Built Around Write Concerns
Monger no longer provides monger.core/get-last-error
. It is no
longer needed: write concerns and exceptions is now the primary way for clients
to be notified of operation failures.
New Authentication API
MongoDB 3.0 supports different authentication mechanisms. Multiple credentials can be specified for a single connection. The client and the server then can negotiate what authentication mechanism to use and which set of credentials succeed.
Monger introduces a new namespace for credential instantiation:
monger.credentials
. The most common function that relies on
authentication mechanism negotiation is monger.credentials/for
:
1 2 3 4 5 6 |
|
mg/connect-with-credentials
is the most convenient function to
connect with if you plan on using authentication.
When connecting using a URI, the API hasn’t changed.
monger.search is Gone
monger.search
is gone. MongoDB 3.0 supports search queries
using regular query operators, namely $text
. monger.operators
is
extended to include $text
, $search
, $language
, and $natural
.
An example of a search query in 3.0:
1 2 3 4 5 6 7 8 9 |
|
JSON Serialization of BSON Timestamps
JSON serialisation extensions now support BSON timestamps.
Contributed by Tom McMillen.
Change Log
Monger change log is available on GitHub.
Monger is a ClojureWerkz Project
Monger is part of the group of libraries known as ClojureWerkz, together with
- Langohr, a Clojure client for RabbitMQ that embraces the AMQP 0.9.1 model
- Cassaforte, a Clojure Cassandra client built around CQL
- Elastisch, a minimalistic Clojure client for ElasticSearch
- Welle, a Riak client with batteries included
- Neocons, a client for the Neo4J REST API
- Quartzite, a powerful scheduling library
and several others. If you like Monger, you may also like our other projects.
Let us know what you think on Twitter or on the Clojure mailing list.
About the Author
@michaelklishin on behalf of the ClojureWerkz Team