Skip to content

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

License

Notifications You must be signed in to change notification settings

neo4j-contrib/java-rest-binding

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Note

This library is no longer maintained.

Wrapping an over-the-wire connection behind a GraphDatabaseService API was never a good idea as operations that are in-process calls in the embedded case are network requests here with all the latency and behavior implications.

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.

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)

About

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

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Java 100.0%