Skip to content
This repository

Java Bindings for the Neo4J Server REST API, providing an implementation of GraphDatabaseService

README.md

The Java binding for the Neo4j Server REST API wraps the REST calls behind the well known GraphDatabaseService API.

Please note, that the performance semantics are not the same, as most of these operations will cause a network request to the server. Make sure to minimize the fine grained operations and rely more on cypher and traversals to get your data and on batching and cypher to update the graph.

You can also use the RestAPIFacade directly to interact with your Neo4j-Server, without the GraphDatabaseService Wrapper.

Note

The behavior of "transactions" changed in 1.8, in 1.7 they were no-op, i.e. just ignored. So you could just leave them off to not confuse people.

In 1.8 it tries to collect all operations within a tx as a batch-operation which will then be executed on the server.

This has the implication that the results retrieved within that "tx" are not immediately available but only after you called tx.success and tx.finish

Currently supports:


Usage:

Build it locally. Then use the maven / ivy dependency or copy the jar into your app.

<dependency>
    <groupId>org.neo4j</groupId>
    <artifactId>neo4j-rest-graphdb</artifactId>
    <version>1.8.M07</version>
</dependency>

GraphDatabaseService gds = new RestGraphDatabase("http://localhost:7474/db/data");
GraphDatabaseService gds = new RestGraphDatabase("http://localhost:7474/db/data",username,password);

// or using the RestAPI directly
RestAPI restAPI = new RestAPIFacade("http://localhost:7474/db/data",username,password);

// as a Spring Bean, e.g. in [Spring Data Neo4j](http://www.springsource.org/spring-data/neo4j)
<bean id="graphDbService" class="org.neo4j.rest.graphdb.RestGraphDatabase" destroy-method="shutdown">
    <constructor-arg index="0" value="http://localhost:7474/db/data" />
</bean>
</pre>

References / Community:

Configuration (System-Properties)

timeouts in seconds

  • org.neo4j.rest.read_timeout=30
  • org.neo4j.rest.connect_timeout=30
  • org.neo4j.rest.driver="neo4j-rest-graphdb/1.8.RC1"
  • org.neo4j.rest.stream=true
  • org.neo4j.rest.batch_transaction=false (convert transaction scope into batch-rest-operations)
  • org.neo4j.rest.logging_filter=false (set to true if verbose request/response logging should be enabled)
Something went wrong with that request. Please try again.