Hello World 之Spring Boot 调用图数据库Neo4j

明日歌 
[清]钱鹤滩 
明日复明日，明日何其多！ 
我生待明日，万事成蹉跎

1. 图数据库Neo4j之爱的初体验 ----与君初相识，犹似故人归

在如今大数据（big data）横行的时代，传统的关系型数据库如oracle，mysql在大数据量，高并发的场景下显得力不从心。于是乎，NoSQL横空出世，如column-based的cassandra数据库，document-based的MongoDB，还有今天介绍的小众的graph-based的图数据数据库Neo4j。

图数据库名字的由来其实与其在底层的存储方式有关，图数据库并不表示会存储图形，图片等。Neo4j底层会以图的方式把用户定义的节点（nodes）以及关系（relationships）存储起来，Nodes 和 Relationships 包含key/value形式的属性。Nodes通过Relationships所定义的关系相连起来，形成关系型网络结构。通过这种方式，可是高效的实现从某个节点开始，通过节点与节点间关系，找出两个节点间的联系。

2. Neo4j之爱的再判断----天生我材必有用

以金庸先生的《神雕侠侣》为例，这里面的人物关系图很复杂，神雕大侠杨过有很多粉丝，他的粉丝又有自己的粉丝（二度人脉），粉丝的粉丝又有自己的粉丝……..假设杨大侠从南宋就开了个博客，到如今必定圈粉无数，如果要找到杨过的粉丝和他的六度七度人脉，运用传统的关系型数据库的话，则需要在关系表里存储很多关系数据，成万上亿，百亿，千亿甚至更多。不论用关系型数据库的分库分表技术还是其他优化手段，在复杂度和性能方面都可能会遇到瓶颈。

而图数据库neo4j运用了图的遍历算法设计，即从一个节点开始，根据其连接的关系，可以快速和方便地找出它的邻近节点，从而具有简单的存储方式和极高的查询性能。

关于neo4j的更多细节和neo4j server的安装以及用cypher语言创建节点，关系等内容可以参考网上资料(如：https://blog.csdn.net/victory0508/article/details/78414798)，本文着重关注Spring boot 2.0 如何简洁的调用neo4j.

3. Neo4j执Spring boot之手----窈窕淑女，Spring boot好逑

在我的第一篇博客里介绍了Spring boot 2.0。本文将Spring boot 结合Spring Data，用极少的代码，基本零配置，不用书写任何查询（queries）语句（这里是cypher）实现了Neo4j的增删改查。

3.1 Neo4j的连接配置

Spring boot的配置文件默认在src/main/resources下面，支持传统的application.properties 和application.yml

application.properties版：

spring.data.neo4j.username=neo4j
spring.data.neo4j.password=helloworld

application.yml版：      

spring:
  data:
    neo4j:
      username: neo4j
      password: helloworld

3.2 实体类（model） 

@NodeEntity
public class Legend {
 
	@Id @GeneratedValue private Long id;
 
	private String name;
 
	private Legend() {
		// Empty constructor required as of Neo4j API 2.0.5
	};
 
	public Legend(String name) {
		this.name = name;
	}
 
	/**
	 * Neo4j doesn't REALLY have bi-directional relationships. It just means when querying
	 * to ignore the direction of the relationship.
	 * https://dzone.com/articles/modelling-data-neo4j
	 */
	@Relationship(type = "FANS", direction = Relationship.UNDIRECTED)
	public Set<Legend> fans;
 
	public void fansWith(Legend legend) {
		if (fans == null) {
			fans = new HashSet<>();
		}
		fans.add(legend);
	}
 
	public String toString() {
 
		//java 8 stream and optional
		return this.name + "'s fans => "
			+ Optional.ofNullable(this.fans).orElse(
					Collections.emptySet()).stream()
						.map(Legend::getName)
						.collect(Collectors.toList());
	}
 
	public String getName() {
		return name;
	}
 
	public void setName(String name) {
		this.name = name;
	}
}

实体类annotated by 注解@NodeEntity，这样当调用保存这个实体时（save方法），会将它保存到neo4j数据库。

另一个重要的部分是

        @Relationship(type = "FANS", direction = Relationship.UNDIRECTED)

用来建立关系，UNDIRECTED表示忽略关系的方向性。

应用程序通过调用fansWith方法，可以将神雕的人物们联系起来。

3.3 Spring data neo4j

        Spring Data  属于Spring 大家庭，用于简化对数据库的访问，在很多情况下，甚至都不用写任何queries就可以实现对数据库的各种操作。 

import org.springframework.data.repository.CrudRepository;
 
public interface LegendRepo extends CrudRepository<Legend, Long> {
 
	Legend findByName(String name);
}

 CrudRepository 是关键，它封装常用的如保存，更新等操作。

上面的findByName方法表示用name来查询。name必须是实体类的一个属性。在关系型数据库里，spring data会自己将他转化成 select * from table where name=？。而neo4j使用cypher语言，类似转化成查询语句

MATCH (n:`Legend`) WHERE n.`name` = { `name_0` } WITH n RETURN n,
[ [ (n)-[r_f1:`FANS`]-(l1:`Legend`) | [ r_f1, l1 ] ] ], ID(n) with params {name_0=杨过}

如果要表达Or或者And关系（假设legend有属性level），方法名将会是

findByNameAndLevel（String name，String level）

如果要分页，需要继承PagingAndSortingRepository，而不是CrudRepository 。有关springdata的更多细节，笔者将会在以后的博客中详细介绍。

3.4 Spring boot 启动类 

@SpringBootApplication
@EnableNeo4jRepositories
public class SpringBootNeo4jApplication {
 
	public static void main(String[] args) {
		SpringApplication.run(SpringBootNeo4jApplication.class, args);
	}
}

这里的注解@EnableNeo4jRepositories告诉spring boot程序使用neo4j repository。

3.5 Spring boot 测试类 

 开发工具Spring tool suites自动会生成测试类，添加自己的逻辑代码，保存三个节点：杨过，小龙女和郭襄。

然后建立她们之间的关系，小龙女和郭襄均是杨过的粉丝。最后查询出杨过的粉丝。

@RunWith(SpringRunner.class)
@SpringBootTest
public class SpringBootNeo4jApplicationTests {
	
 
	@Autowired
	LegendRepo legendRepo;
	private final static Logger log = LoggerFactory.getLogger(SpringBootNeo4jApplicationTests.class);
 
	@Test
	public void contextLoads() {
		legendRepo.deleteAll();
 
		Legend yangguo = new Legend("杨过");
		Legend dragonGirl = new Legend("小龙女");
		Legend guoxiang = new Legend("郭襄");
 
		List<Legend> team = Arrays.asList(yangguo, dragonGirl, guoxiang);
 
		log.info("Before linking up with Neo4j...");
                //java 8 stream
		team.stream().forEach(legend -> log.info("	" + legend.toString()));
 
		legendRepo.save(yangguo);
		legendRepo.save(dragonGirl);
		legendRepo.save(guoxiang);
 
		yangguo = legendRepo.findByName(yangguo.getName());
		yangguo.fansWith(dragonGirl);
		yangguo.fansWith(guoxiang);
		legendRepo.save(yangguo);
 
		dragonGirl = legendRepo.findByName(dragonGirl.getName());
		dragonGirl.fansWith(guoxiang);
		// We already know that dragonGirl is a fan of yangguo
		legendRepo.save(dragonGirl);
 
		// We already know guoxiang fans with yangguo and dragongirl
                log.info("Look up yangguo's fans ...");
		log.info(legendRepo.findByName("杨过").toString());
	}
 
}

运行代码查看日志：

Look up yangguo's fans ...
Request: MATCH (n:`Legend`) WHERE n.`name` = { `name_0` } WITH n RETURN n,[ [ (n)-[r_f1:`FANS`]-(l1:`Legend`) | [ r_f1, l1 ] ] ], ID(n) with params {name_0=杨过}
 杨过's fans => [郭襄, 小龙女]

4. Neo4j与Spring boot----一生一代一双人

Neo4j在某些场合能发挥自己的优势，而用spring boot的方式，使得neo4j的使用非常简单，自从有了spring boot，生活变得好轻松。

关注spring boot，请继续关注我的博客。

原文地址：https://blog.csdn.net/weixin_41897365/article/details/79835319