neo4j

Neo4j es una base de datos de gráficos NoSQL de código abierto que utiliza un modelo de datos con todas las funciones de nodos conectados por relaciones completas, que es más adecuado para big data vinculados que los enfoques RDBMS tradicionales. Spring Boot proporciona varios asistentes para trabajar con Neo4j, incluido un spring-boot-starter-data-neo4j "inicial".

Conectarse a la base de datos Neo4j

Para acceder al servidor Neo4j, puede implementar el org.neo4j.driver.Driver autoconfigurable. De forma predeterminada, la instancia intentará conectarse al servidor Neo4j en localhost:7687 utilizando el protocolo Bolt. El siguiente ejemplo muestra cómo implementar un Driver para Neo4j, que dará acceso, entre otras cosas, a Session:

import org.neo4j.driver.Driver;
import org.neo4j.driver.Session;
import org.neo4j.driver.Values;
import org.springframework.stereotype.Component;
@Component
public class MyBean {
    private final Driver driver;
    public MyBean(Driver driver) {
        this.driver = driver;
    }
 // ...
 public String someMethod(String message) {
        try (Session session = this.driver.session()) {
            return session.writeTransaction((transaction) -> transaction
                    .run("CREATE (a:Greeting) SET a.message = $message RETURN a.message + ', from node ' + id(a)",
                            Values.parameters("message", message))
                    .single().get(0).asString());
        }
    }
}

import org.neo4j.driver.Driver
import org.neo4j.driver.Transaction
import org.neo4j.driver.Values
import org.springframework.stereotype.Component
@Component
class MyBean(private val driver: Driver) {
 // ...
 fun someMethod(message: String?): String {
        driver.session().use { session ->
            return@someMethod session.writeTransaction { transaction: Transaction ->
                transaction.run(
                    "CREATE (a:Greeting) SET a.message = \$message RETURN a.message + ', from node ' + id(a)",
                    Values.parameters("message", message)
                ).single()[0].asString()
            }
        }
    }
}

Puede agregar varios aspectos del controlador a la configuración utilizando las propiedades spring.neo4j.*. El siguiente ejemplo muestra cómo configurar el URI y las credenciales a utilizar:

spring.neo4j.uri=bolt://my-server:7687
spring.neo4j.authentication.username=neo4j
spring.neo4j.authentication.password=secret

spring:
  neo4j:
    uri: "bolt://my-server:7687"
    authentication:
      username: "neo4j"
      password: "secret"

El Driver autoconfigurable se crea utilizando ConfigBuilder. Para ajustar su configuración, declare uno o más beans ConfigBuilderCustomizer. Cada uno de ellos será llamado en orden a través del ConfigBuilder, que se utiliza para crear el Driver.

Repositorios Spring Data Neo4j

Spring Data contiene soporte de repositorio para Neo4j.

Spring Data Neo4j comparte la infraestructura Spring Data JPA, al igual que muchos otros módulos Spring Data. Puede tomar el ejemplo de JPA de la sección anterior y definir City como @Node para Spring Data Neo4j en lugar de @Entity para JPA, mientras abstrae el almacenamiento funcionará exactamente como se muestra en el siguiente ejemplo:

import java.util.Optional;
import org.springframework.data.neo4j.repository.Neo4jRepository;
public interface CityRepository extends Neo4jRepository<City, Long> {
    Optional<City> findOneByNameAndState(String name, String state);
}

import org.springframework.data.neo4j.repository.Neo4jRepository
import java.util.Optional
interface CityRepository : Neo4jRepository<City?, Long?> {
    fun findOneByNameAndState(name: String?, state: String?): Optional<City?>?
}

"Starter" spring-boot-starter-data-neo4j permite la compatibilidad con repositorios, así como la gestión de transacciones. Spring Boot admite repositorios Neo4j clásicos y reactivos a través de los beans Neo4jTemplate o ReactiveNeo4jTemplate. Si Project Reactor está disponible en el classpath, el estilo reactivo también se configura automáticamente.

Puede configurar las ubicaciones donde se buscarán repositorios y entidades usando las anotaciones @EnableNeo4jRepositories y @EntityScan, respectivamente, en un bean marcado con @Configuración código de anotación.

import org.neo4j.driver.Driver;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.data.neo4j.core.ReactiveDatabaseSelectionProvider;
import org.springframework.data.neo4j.core.transaction.ReactiveNeo4jTransactionManager;
@Configuration(proxyBeanMethods = false)
public class MyNeo4jConfiguration {
    @Bean
    public ReactiveNeo4jTransactionManager reactiveTransactionManager(Driver driver,
            ReactiveDatabaseSelectionProvider databaseNameProvider) {
        return new ReactiveNeo4jTransactionManager(driver, databaseNameProvider);
    }
}

import org.neo4j.driver.Driver
import org.springframework.context.annotation.Bean
import org.springframework.context.annotation.Configuration
import org.springframework.data.neo4j.core.ReactiveDatabaseSelectionProvider
import org.springframework.data.neo4j.core.transaction.ReactiveNeo4jTransactionManager
@Configuration(proxyBeanMethods = false)
class MyNeo4jConfiguration {
    @Bean
    fun reactiveTransactionManager(driver: Driver,
            databaseNameProvider: ReactiveDatabaseSelectionProvider): ReactiveNeo4jTransactionManager {
        return ReactiveNeo4jTransactionManager(driver, databaseNameProvider)
    }
}