本章中你将会学到如何在node.js中使用neo4j图形数据库。
当你想存储或者查询和数据紧密关联的数据的时候,图形数据库很有用。
neo4j是一个可有效存储,处理和查询你数据模型中紧密相连的元素的数据库。
neo4j有很强大且灵活的数据模型,你可以使用其来表示你真实的,易变结构的信息,且不失真。
使用内置的REST API来和Neo4j通讯
Neo4j数据库有内在的HTTP REST接口,我们可以使用其直接和Neo4j数据库交接(interface)。
你需要简单的使用POST向一个HTTP URL发送请求,且接受来自Neo4j的响应。
在下面的实例中你可以看见Node.js请求模块调用了REST,在请求模块(request module)中这样做很便利。
安装request模块是:
> npm install request
让我们创建一个空的文件,且在文档中写下下述代码:
//Let’s load the request module var request = require("request");
上面我们将使用require函数来在我们的项目中加载request模块
创建一个将会触发密码查询(cypher query)的方法:
下面我们将要创建一个函数,使用密码查询(cypher query)作为输入,且使用HTTP接口在数据库中触发这个密码查询(cypher query)。我们在manual中可以详尽看到端点协议(endpoint protocol)和格式。你可以使用其做更多的事情:例如,在每个请求中发送很多标准 或者 在众多请求中保持通讯打开(keep transactions)。你可在neoe4j手册中多看看。
下面让我们定义数据库的host
//Define your host and port. This is where your database is running. Here it is defined on localhost. var host = 'localhost', port = 7474;
定义我们需要连接的URL,在Neo4说明文档中指明:
//This is the URL where we will POST our data to fire the cypher query. This is specified in Neo4j docs. var httpUrlForTransaction = 'http://' + host + ':' + port + '/db/data/transaction/commit';
接下来,你需要定义可将cyper作为参数的函数,用来执行密码查询。
参数可以是任何的用来密码查询的参数,且当数据库有响应的时候要触发回调函数。
//Let’s define a function which fires the cypher query. function runCypherQuery(query, params, callback) { request.post({ uri: httpUrlForTransaction, json: {statements: [{statement: query, parameters: params}]} }, function (err, res, body) { callback(err, body); }) }
触发一些查询:
现在我们需要一个可以在neo4.js中触发查询的函数,让我们通过保存neo4j中一个节点的方法来使用这个函数。
/** * Let’s fire some queries below. * */ runCypherQuery( 'CREATE (somebody:Person { name: {name}, from: {company}, age: {age} }) RETURN somebody', { name: 'Ghuffran', company: 'Modulus', age: 44 }, function (err, resp) { if (err) { console.log(err); } else { console.log(resp); } } );
在上面的例子中,我们使用了一个密码查询来保存节点(node)
注意:使用上述的参数来进行查询是好想法。因为Neo4j缓存查询路径,然后结合我们传递的不同参数来运行这个查询路径。这增加了查询执行的速度。
现在让我们总结上面的所有代码,我们的文件应该看上去是:
//Let’s load the request module var request = require("request"); //Define your host and port. This is where your database is running. Here it’s on localhost. var host = 'localhost', port = 7474; //This is the url where we will POST our data to fire the cypher query. This is specified in Neo4j docs. var httpUrlForTransaction = 'http://' + host + ':' + port + '/db/data/transaction/commit'; //Let’s define a function which fires the cypher query. function runCypherQuery(query, params, callback) { request.post({ uri: httpUrlForTransaction, json: {statements: [{statement: query, parameters: params}]} }, function (err, res, body) { callback(err, body); }) } /** * Let’s fire some queries as shown below. * */ runCypherQuery( 'CREATE (somebody:Person { name: {name}, from: {company}, age: {age} }) RETURN somebody', { name: 'Ghuffran', company: 'Modulus', age: 44 }, function (err, resp) { if (err) { console.log(err); } else { console.log(resp); } } );
现在我们只要使用内置的HTTP REST API和Neo4j 数据库进行交接就可。
使用Node.js 的node-neo4j(philippkueng)模块和neo4j进行通信
你可使用一些模块来和Node.js只的neo4j进行interface,但是node-neo4j(Thingdom)和node-neo4j(philipkueng)是使用最广泛的。
你可以根据个人喜好进行选择使用。
下面例子中使用的是node-neo4j()philippkueng模块,因为其利于说明:
我们可以加载这个模块:
> npm install node-neo4j
现在让我们看看如何使用node-neo4j模块来触发密码查询,就像使用其他的对象接口一样。
//Require the Neo4J module var neo4j = require('node-neo4j'); //Create a db object. We will using this object to work on the DB. db = new neo4j('http://localhost:7474'); //Run raw cypher with params db.cypherQuery( 'CREATE (somebody:Person { name: {name}, from: {company}, age: {age} }) RETURN somebody', { name: 'Ghuffran', company: 'Modulus', age: ~~(Math.random() * 100) //generate random age }, function (err, result) { if (err) { return console.log(err); } console.log(result.data); // delivers an array of query results console.log(result.columns); // delivers an array of names of objects getting returned } );
上麦我们使用模块提供的db.cypherQuery(query, [params|Optional], [include_stats|Optional], callback) 方法来运行我们的密码查询。
node-neo4j模块提供了一系列的帮助方法。
让我们看看我们如何通过使用帮助函数来保存我们的节点。
//Require the Neo4J module var neo4j = require('node-neo4j'); //Create a db object. We will using this object to work on the DB. db = new neo4j('http://localhost:7474'); //Let’s create a node db.insertNode({ name: 'Ghuffran', company: 'Modulus', age: ~~(Math.random() * 100) }, function (err, node) { if (err) { return console.log(err); } // Output node data. console.log(node); });
上面我们使用 db.insertNode 来帮助我们创建一个特殊的节点。
存在一些可以用来更新,读取和删除的方法,你可使用这些方法和neo4j数据库进行交互,而不需要处理密码查询。你可以在API文档中查看更多。