图数据库实践系列 (三)--Neo4j Spatial的REST集成

阿牛

　　上讲回顾：主要讲述Neo4j Spatial项目以及空间数据(矢量)的存储。本文主要介绍Neo4j Spatial与Neo4j Server的集成，以及与GeoServer 的集成。
　　Noted:与Geoserver的集成方法可行，但是geoserver无法显示发布数据库内的图层。（系统环境:Ubuntu 12.04,Spatial 0.9,Neo4j 1.8M6,Geoserver 2.1.1)

1.Neo4j Server安装与配置

1.1Neo4j Server 安装
　　Neo4j可以安装成数据库服务器，能够已应用或者系统服务两种形式运行在操作系统中。它内置了jetty 和REST接口，来实现使用浏览器对数据库操作[17,18]。

• 在neo4j官网http://neo4j.org/download下载你喜欢的版本(需要选择你的操作系统)
  
• 解压到特定位置，解压路径表述为$NEO4J_HOME(如/home/dev/neo4j/)
  
• 启动脚本在$NEO4J_HOME/bin 文件夹下,在Linux/MacOS下，运行 $NEO4J_HOME/bin/neo4j start 在Window 只要双击%NEO4J_HOME%\bin\Neo4j.bat文件即可
  

　　我们也可以按照第一讲所述，进入源码安装的Neo4j的的bin文件夹($NEO4J_HOME/bin)命令启动，

cd $NEO4J_HOME/bin/
$NEO4J_HOME/bin/neo4j start
　　我们只需要访问 http://localhost:7474/webadmin/  会出现Neo4j 的web 管理界面，如图1所示:

　　图1 Neo4j Server管理界面
　　在Web 管理界面，我们可以查看数据库的节点，属性，关系信息。还可以通过Http ，Shell 和Germlin三种方式来对图数据库做CRUD。如果需要将Neo4j Server 以系统服务的方式运行，可以查阅参考文献[17]

1.2Neo4j Server 配置参数


　　如果我们需要对服务器的后端数据库性能调优等，可以通过Server的配置文件来了解图数据库的具体参数。这些重要的参数都存储在$NEO4J_HOME/conf/neo4j-server.properties文件内，包括服务器数据库在磁盘上的路径：

org.neo4j.server.database.location=data/graph.db
　　http 服务器接口:

org.neo4j.server.database.location=data/graph.db

　　设置REST数据接口所能够操纵的数据库的相对路径

org.neo4j.server.webadmin.data.uri=/db/data/
　　等。至于Neo4j的性能参数和日志参数分别参看$NEO4J_HOME/conf/neo4j.properties,$NEO4J_HOME/conf/logging.properties两个文件。





2.Neo4j Server与Spatial集成

2.1 Neo4j  Server的Spatail插件安装
　　上讲我们通过利用源码安装了neo4j spatial ,在/target目录下会有一个neo4j-spatial-0.9-SNAPSHOT-server-plugin.zip文件。如果没有，可以运行以下命令来获得该文件：

git clone https://github.com/neo4j/spatial.git
cd ./spatial
mvn clean package -DskipTests
　　将该文件解压到，复制所有的jar包到neo4j 的lib文件夹内，然后重启neo4j server即可。

2.2 Neo4j  Server的空间操作
　　利用curl[20]工具能够在命令行中对Neo4j实现空间数据读写，包括查询，图层创建，点创建等。这些都是以JSON格式以http协议对图数据库的操作。

curl http://localhost:7474/db/data/
　　会返回数据库的整体信息，如图2所示：

　　图2 查询图数据库
　　我们可以看到返回的JSON数据中有"SpatialPlugin"对象，它的属性包括addEditableLayer,getLayer,addNodeToLayer等。我们通过curl命令来创建名字为'test'等简单点图层。

curl -d "layer=test" http://localhost:7474/db/data/ext/SpatialPlugin/graphdb/addSimplePointLayer
　　如图3所示：

　　图3 添加点图层
　　可以从图中看到数据队形的属性，包括图层的类，图层名称，几何编码类型，创建时间。然后添加三个Well-Konw text 格式的点

# Creating three points from Well-known text format
curl -v http://localhost:7474/db/data/ext/SpatialPlugin/graphdb/addGeometryWKTToLayer -H "Content-Type: application/json" -d '{"geometry":"POINT(10 10)", "layer":"test"}'
curl -v http://localhost:7474/db/data/ext/SpatialPlugin/graphdb/addGeometryWKTToLayer -H "Content-Type: application/json" -d '{"geometry":"POINT(10 11)", "layer":"test"}'
curl -v http://localhost:7474/db/data/ext/SpatialPlugin/graphdb/addGeometryWKTToLayer -H "Content-Type: application/json" -d '{"geometry":"POINT(9 10)", "layer":"test"}'
　　然后执行一个范围查询

curl -v http://localhost:7474/db/data/ext/SpatialPlugin/graphdb/findGeometriesInBBox -H "Content-Type: application/json" -d '{"minx":9.0,"maxx":11.0,"miny":9.0,"maxy":12.0,"layer":"test"}'
　　返回在边界内的点为两个，如图4所示：

　　图4 范围查询

  3.与GeoServer集成
　　GeoServer是一款基于java的开源的地图服务器，支持包括shapefile，postgis等多种数据源。neo4j spatial能够以插件的形式与GeoServer集成。集成方法如下：

• 解压neo4j-spatial-0.9-SNAPSHOT-server-plugin.zip，将里面除了gt-*_8.0的jar包 拷进geoserver/WEB-INF/lib 文件夹
  
• 复制neo4j/lib 里面所有jar 进入geoserver/WEB-INF/lib 文件夹
  
• 重启geoserver
  

　　通过访问GeoServer地址http://localhost:8080/geoserver/web/，我们可以看到如图-5所示，neo4j可以作为geoserver的后端，提供地图服务。

　　图5 neo4j与geoserver集成
　　但是geoserver无法显示，发布数据库内的图层。（系统环境:Ubuntu 12.04,Spatial 0.9,Neo4j 1.8M6,Geoserver 2.1.1)
　　据说是geoserver的一个bug，会在不久后修复。https://github.com/neo4j/spatial/issues/57
　　下一讲会主要讲述一个基于HBase的图数据库Titan。

参考文献
　　[17]Server Installation http://docs.neo4j.org/chunked/stable/server-installation.html
　　[18]Jetty http://jetty.codehaus.org/jetty/
　　[19]Server Configuration http://docs.neo4j.org/chunked/stable/server-configuration.html
　　[20]cURL http://curl.haxx.se/
　　[21]Well-known text  http://en.wikipedia.org/wiki/Well-known_text

本作品由VentLam创作，采用知识共享署名-非商业性使用-相同方式共享 2.5 中国大陆许可协议进行许可。