org.springframework.data.neo4j.core

Interface Neo4jClient

@API(status=STABLE,
     since="6.0")
public interface Neo4jClient

Definition of a modern Neo4j client.

Since:

6.0

Author:

Gerrit Meier, Michael J. Simons

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	Neo4jClient.BindSpec<S extends Neo4jClient.BindSpec<S>> Contract for binding parameters to a query.
static class	Neo4jClient.IllegalDatabaseNameException Indicates an illegal database name and is not translated into a DataAccessException.
static interface	Neo4jClient.MappingSpec<T>
static interface	Neo4jClient.OngoingBindSpec<T,S extends Neo4jClient.BindSpec<S>> Ongoing bind specification.
static interface	Neo4jClient.OngoingDelegation<T> A contract for an ongoing delegation in the selected database.
static interface	Neo4jClient.RecordFetchSpec<T>
static interface	Neo4jClient.RunnableDelegation<T> A runnable delegation.
static interface	Neo4jClient.RunnableSpec Contract for a runnable query that can be either run returning its result, run without results or be parameterized.
static interface	Neo4jClient.RunnableSpecTightToDatabase Contract for a runnable query inside a dedicated database.

Field Summary

Fields

Modifier and Type	Field and Description
static LogAccessor	cypherLog

Method Summary

Modifier and Type	Method and Description
static Neo4jClient	create(org.neo4j.driver.Driver driver)
static Neo4jClient	create(org.neo4j.driver.Driver driver, DatabaseSelectionProvider databaseSelectionProvider)
<T> Neo4jClient.OngoingDelegation<T>	delegateTo(Function<org.neo4j.driver.QueryRunner,Optional<T>> callback) Delegates interaction with the default database to the given callback.
DatabaseSelectionProvider	getDatabaseSelectionProvider() Returns the assigned database selection provider.
Neo4jClient.RunnableSpec	query(String cypher) Entrypoint for creating a new Cypher query.
Neo4jClient.RunnableSpec	query(Supplier<String> cypherSupplier) Entrypoint for creating a new Cypher query based on a supplier.
static String	verifyDatabaseName(String databaseName) This is a utility method to verify and sanitize a database name.

Field Detail

cypherLog

static final LogAccessor cypherLog

Method Detail

create

static Neo4jClient create(org.neo4j.driver.Driver driver)

create

static Neo4jClient create(org.neo4j.driver.Driver driver,
                          DatabaseSelectionProvider databaseSelectionProvider)

query

Neo4jClient.RunnableSpec query(String cypher)

Entrypoint for creating a new Cypher query. Doesn't matter at this point whether it's a match, merge, create or removal of things.

Parameters:

cypher - The cypher code that shall be executed

Returns:

A runnable query specification.

query

Neo4jClient.RunnableSpec query(Supplier<String> cypherSupplier)

Entrypoint for creating a new Cypher query based on a supplier. Doesn't matter at this point whether it's a match, merge, create or removal of things. The supplier can be an arbitrary Supplier that may provide a DSL for generating the Cypher statement.

Parameters:

cypherSupplier - A supplier of arbitrary Cypher code

Returns:

A runnable query specification.

delegateTo

<T> Neo4jClient.OngoingDelegation<T> delegateTo(Function<org.neo4j.driver.QueryRunner,Optional<T>> callback)

Delegates interaction with the default database to the given callback.

Type Parameters:

T - The type of the result being produced

Parameters:

callback - A function receiving a statement runner for database interaction that can optionally return a result.

Returns:

A single result object or an empty optional if the callback didn't produce a result

getDatabaseSelectionProvider

DatabaseSelectionProvider getDatabaseSelectionProvider()

Returns the assigned database selection provider.

Returns:

The database selection provider - can be null

verifyDatabaseName

static String verifyDatabaseName(String databaseName)

This is a utility method to verify and sanitize a database name.

Parameters:

databaseName - The database name to verify and sanitize

Returns:

A possibly trimmed name of the database.

Throws:

IllegalArgumentException - when the database name is not allowed with the underlying driver.