spring-data-neo4j 4.2.4release文档概要

　　Neo4j是一种开源的NoSQL图数据库，将数据以图（把一个个实体当作节点，连接节点的边表示节点间的关系）的形式保存，Neo4j也支持ACID事务管理。关系型数据库数据访问采用的是ORM（对象关系映射），而Neo4j数据库采用的是OGM（对象图形映射，Object Graph Mapper）。

与SDN相匹配的jar包版本

　　使用Spring Data Neo4j 4.2.x版的需求：

　　JDK1.8及以上版本

　　Neo4j Graph DataBase 2.3.x及以上版本

　　Spring Framework 4.3.9RELEASE及以上版本

　　使用OGM时确保版本在2.1.1+RELEASE

　　版本控制

　　Spring Data Neo4j 4.2及以后的版本的配置，更加简便。不需要在配置类中继承Neo4jConfiguration，也不需要定义SessionBean。而是定义SessionFactory和Neo4jTransactionManager的对象bean。连接Neo4j时，SDN创建session（org.neo4j.ogm.session.Session）实例时，需要声明SessionFactory.当SessionFactory被创建，它设置了OGM的元数据，使用它来创建所有的Session，同时packages to scan for domain object 元数据需要提供给SessionFactory的构造函数。，@EnableTransactionManagement是用来申明Neo4jTransactionManager的，配置SDN的事物，配置SessionFactory Bean是为了申明OGM的配置，如下图：

　　使用JPA代理实现repository的config

　　声明一个Spring Data JPA的依赖

neo4j应用

　　neo4j的driver有三种：Embedd（内嵌式），HTTP以及二进制协议Bolt

　　OGM（Object Graph Mapper）neo4j数据库的节点与java实体建立映射关系

　　SDN在顶端为OGM提供语法以及代码，建立基于Spring的Neo4j/OGM的应用

添加依赖

　　spring-data-neo4j

　　　　<dependency>

　　　　　　 <groupId>org.springframework.data</groupId>

　　　　　　<artifactId>spring-data-neo4j</artifactId>

　　　　　　 <version>{version}</version>

　　　　</dependency>

　　添加dirver的依赖，三种：embedded-driver，http-driver，bolt-driver

　　　　<!-- add this dependency if you want to use the embedded driver -->

　　　　<dependency>

　　　　　　<groupId>org.neo4j</groupId>

　　　　　　 <artifactId>neo4j-ogm-embedded-driver</artifactId>

<version>{ogm-version}</version>

</dependency>

　　　　<!-- add this dependency if you want to use the HTTP driver -->

　　　　<dependency>

　　　　　　 <groupId>org.neo4j</groupId>

　　　　　　<artifactId>neo4j-ogm-http-driver</artifactId>

　　　　　　 <version>{ogm-version}</version>

　　　　 </dependency>

　　<!-- the neo4j-ogm-test jar provides access to the http and embedded drivers for testing purposes -->

　　<dependency> <groupId>org.neo4j</groupId> <artifactId>neo4j-ogm-test</artifactId> <version>${neo4j-ogm.version}</version> <type>test-jar</type> <scope>test</scope> </dependency>

　　<dependency> <groupId>org.neo4j</groupId> <artifactId>neo4j-kernel</artifactId> <version>${neo4j.version}</version> <type>test-jar</type> </dependency>

　　<dependency> <groupId>org.neo4j.app</groupId> <artifactId>neo4j-server</artifactId> <version>${neo4j.version}</version> <type>test-jar</type> </dependency>

　　<dependency> <groupId>org.neo4j.test</groupId> <artifactId>neo4j-harness</artifactId> <version>${neo4j.version}</version> <scope>test</scope> </dependency>

　　driver的配置，SDN会自动扫描ogn.properties文件，也可以通过java Configuration来配置，其中<driver>对应依赖中申明的driver，<uri>对应对应neo4j数据库链接地址（http://username:password@localhost:7474）如下：

　　　　import org.neo4j.ogm.config.Configuration;

　　　　@Bean

　　　　public Configuration configuration() {

　　　　　　Configuration config = new Configuration();

　　　　　　config .driverConfiguration() .setDriverClassName("org.neo4j.ogm.drivers.<driver>.driver.<driver>Driver") .setURI("<uri>");

　　　　　　return config;

　　　　}

　　　　 @Bean

　　　　 public SessionFactory sessionFactory() {

　　　　　　 return new SessionFactory(configuration(), <packages> );

　　　　}

Neo4j OGM支持

　　OGM将图数据库中的节点和关系与域模型中的对象和引用映射起来，节点与对象实例映射起来，而对象引用与关系映射起来。OGM抽象化了数据库，提供一种方便的方式在图数据库持久化域模型（domain model），并且查询不需要使用低级别的驱动。

Session用于驱动对象图映射框架。所有存储库实现都是由Session驱动的。它跟踪对实体及其关系所做的更改，这样做的好处是，只需要保存修改的部分。

Neo4j Repositories使用

　　@Repository

　　public interface PersonRepository extends Neo4jRepository<Person, Long> {}

　　 public class MySpringBean {

　　　　@Autowired private PersonRepository repo;

　　　　...

　　 } // then you can use the repository as you would any other object

　　Person michael = repo.save(new Person("Michael", 36));

　　Person dave = repo.load(123);

　　long numberOfPeople = repo.count();

Mapping Query Results

　　public interface MovieRepository extends GraphRepository<Movie> {

　　　　@Query("MATCH (movie:Movie)-[r:RATING]\->(), (movie)<-[:ACTS_IN]-(actor:Actor) " + "WHERE movie.id={0} " + "RETURN movie as movie, COLLECT(actor) AS 'cast', AVG(r.stars) AS 'averageRating'")

　　　　MovieData getMovieData(String movieId);

　　　　@QueryResult

　　　　public class MovieData {

　　　　　　Movie movie;

　　　　　　Double averageRating;

　　　　　　Set<Actor> cast;

　　　　 }

　　 }

　　Neo4j是一种事务型数据库。对所有与SDN交互的方法标定@Transactional

　　@Service

　　class UserManagementImpl implements UserManagement {

　　　　private final UserRepository userRepository;

　　　　private final RoleRepository roleRepository;

　　　　@Autowired

　　　　public UserManagementImpl(UserRepository userRepository, RoleRepository roleRepository) {

　　　　　　this.userRepository = userRepository;

　　　　　　 this.roleRepository = roleRepository;

　　　　 }

　　　　@Transactional

　　　　public void addRoleToAllUsers(String roleName) {

　　　　　　 Role role = roleRepository.findByName(roleName);

　　　　　　for (User user : userRepository.findAll()) {

　　　　　　　　 user.addRole(role);

　　　　　　　　userRepository.save(user);

　　　　　　 }

　　　　 }

Driver Configuration

Annotating Entities