TL;DR
Neocons is a feature rich idiomatic Clojure client for the Neo4J REST API.
2.0.0
is a major release that targets Neo4J 2.0. It is backwards
compatible with 1.1
. Note that Neo4J 2.0 contains some breaking
Cypher syntax changes.
Neocons documentation has been updated to cover the new features in Neocons 2 and Neo4J.
Changes between Neocons 1.1.0 and 2.0.0
Transaction Support (Neo4J Server 2.0)
Neocons 2.0 gains support for transactions.
Higher Level API
A group of Cypher statements can be executed in a transaction that will be committed automatically upon success. Any error during the execution will trigger a rollback.
1 2 3 4 5 |
|
Lower Level API
Transactions are instantiated from a group of Cypher statements
that are passed as maps to clojurewerkz.neocons.rest.transaction/begin
:
1 2 3 4 5 |
|
clojurewerkz.neocons.rest.transaction/commit
and
clojurewerkz.neocons.rest.transaction/rollback
commit
and roll a transaction back, respectively.
Macro for working with a transaction
If you want a more fine grained control of working in a transaction without manually
committing or checking for exceptions, you can use the
clojurewerkz.neocons.rest.transaction/with-transaction
macro.
1 2 3 4 5 6 7 8 |
|
If there any errors while processing, the transaction is rolled back.
The first argument is the variable which holds the transaction
information. The second argument to the macro is commit-on-success
,
which commits the transaction there are no errors.
Constraints Support (Neo4J 2.0 Only)
clojurewerkz.neocons.rest.constraints
is a new namespace that
implements Neo4J 2.0 constraints.
1 2 3 4 5 6 7 8 9 10 |
|
Labels Support (Neo4J 2.0 Only)
clojurewerkz.neocons.rest.labels
is a new namespace that provides
support for labels in Neo4J 2.0.
It is possible to add, replace, remove and retrieve labels to/from a node.
To add labels to a node, use clojurewerkz.neocons.rest.labels/add
:
1 2 3 |
|
To add replaces all labels on a node, use clojurewerkz.neocons.rest.labels/replace
:
1 2 3 |
|
Deleting a label from a node is possible with clojurewerkz.neocons.rest.labels/remove
:
1 2 3 |
|
clojurewerkz.neocons.rest.labels/get-all-labels
is the function that lists
either all labels in the database (w/o arguments) or on a specific node
(1-arity):
1 2 3 4 5 6 |
|
Clojure 1.6 Compatibility Fixes
Neocons 2.0 is compatible with recent releases of Clojure 1.6 (master).
Clojure 1.3 Support Dropped
Neocons no longer supports Clojure 1.3.
Documentation Updates
Neocons documentation has been updated to cover the new features in Neocons 2 and Neo4J:
Change Log
We encourage all users to give this version (and Neo4J 2.0!) a try.
Neocons change log is available on GitHub.
Neocons is a ClojureWerkz Project
Neocons 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
- Elastisch, a minimalistic Clojure client for ElasticSearch
- Monger, a Clojure MongoDB client for a more civilized age
- Cassaforte, a Cassandra client built around CQL 3
- Quartzite, a powerful scheduling library
and several others. If you like Neocons, you may also like our other projects.
Let us know what you think on Twitter or on the Clojure mailing list.
About the Author
Michael on behalf of the ClojureWerkz Team