一個快速的REST例子

首先來看些基本知識。如果沒有服務(wù)API，Neo4j就不能支持其他語言。該接口提供一組基于JSON消息格式的RESTful Web服務(wù)和一個全面的發(fā)現(xiàn)機制。使用中使用這個接口的最快和最容易的方法是通過使用cURL：
 

$ curl http://localhost:7474/db/data/
{
 "extensions" : {
 },
 "node" : "http://localhost:7474/db/data/node",
 "node_index" : "http://localhost:7474/db/data/index/node",
 "relationship_index" : "http://localhost:7474/db/data/index/relationship",
 "extensions_info" : "http://localhost:7474/db/data/ext",
 "relationship_types" : "http://localhost:7474/db/data/relationship/types",
 "batch" : "http://localhost:7474/db/data/batch",
 "cypher" : "http://localhost:7474/db/data/cypher",
 "transaction" : "http://localhost:7474/db/data/transaction",
 "neo4j_version" : "2.0.0-M03"
}

從這個端點返回JSON對象包含一組資源名稱和URI下可以找到的Cypher端點。在消息載荷中接受傳送來的Cyper請求并執(zhí)行這些查詢，在HTTP響應(yīng)中返回結(jié)果。

正是這種REST API接口，使得現(xiàn)在已有的各種Neo4j驅(qū)動得以建立。py2neo提供了這些REST資源的簡單封裝，這使Python應(yīng)用程序開發(fā)者可以放心使用Neo4j而不用考慮底層的客戶機-服務(wù)器協(xié)議。

一個簡單的應(yīng)用

為實際驗證py2neo，我們將著眼于建立一個簡單的用于存儲姓名和電子郵件地址的通訊錄管理系統(tǒng)。我們自然會使用節(jié)點來模擬每一個獨立實體，但它是要記住，Neo4j沒有類型的概念。類型是從周圍的關(guān)系和屬性推斷來的。

下面的關(guān)系圖中人顯示為紅色、電子郵件地址節(jié)點顯示為藍色。這些當(dāng)然是純粹的邏輯演示節(jié)點，但數(shù)據(jù)本身并沒有區(qū)別。 

 我們的應(yīng)用程序?qū)⑼瓿蓛蓚€功能：添加新的聯(lián)系人信息和檢索聯(lián)系人的完整列表。為此,我們將創(chuàng)建一個Person類包裝Py2neoNodeobject，這使我們有一個底層處理的實現(xiàn)且留出用戶級的功能。上圖中的ROOT節(jié)點是指上圖中一個固定的參考點，我們沿著這個點開始。

讓我們直接看看代碼。下面是一個完整的小型應(yīng)用。這個程序允許添加新的名字與一個或者更多email地址相連接的以及提供了一個容易的方式來顯示這些連接信息的一個命令行工具。沒有參數(shù)的運行是顯示使用模式，而且這個唯一的依賴只是需要一個本地未修改的Neo4j實例(instance)而已。
 

#!/usr/bin/env python
# -*- coding: utf-8 -*-
 
from __future__ import print_function
 
import sys
from py2neo import neo4j, node, rel
 
graph_db = neo4j.GraphDatabaseService()
 
class Person(object):
   
  _root = graph_db.get_or_create_indexed_node("reference",
     "contacts", "root")
   
  @classmethod
  def create(cls, name, *emails):
    person_node, _ = graph_db.create(node(name=name),
       rel(cls._root, "PERSON", 0))
    for email in emails:
      graph_db.create(node(email=email), rel(cls._root, "EMAIL", 0),
         rel(person_node, "EMAIL", 0))
    return Person(person_node)
   
  @classmethod
  def get_all(cls):
    return [Person(person.end_node) for person in
       cls._root.match("PERSON")]
   
  def __init__(self, node):
    self._node = node
   
  def __str__(self):
    return self.name + "\n" + "\n".join(" <{0}>"
       .format(email) for email in self.emails)
   
  @property
  def name(self):
    return self._node["name"]
   
  @property
  def emails(self):
    return [rel.end_node["email"] for rel in
       self._node.match("EMAIL")]
 
if __name__ == "__main__":
  if len(sys.argv) < 2:
    app = sys.argv[0]
    print("Usage: {0} add <name> <email>
       [<email>...]".format(app))
    print("    {0} list".format(app))
    sys.exit()
  method = sys.argv[1]
  if method == "add":
    print(Person.create(*sys.argv[2:]))
  elif method == "list":
    for person in Person.get_all():
      print(person)
  else:
print("Unknown command")

在第09行上是第一行Py2neo代碼，用來創(chuàng)建了一個GraphDatabaseService對象。通過這個，我們就可以訪問使用Neo4j server的大多數(shù)功能?？蛇x一個URI傳遞到這個構(gòu)造器里，盡管如果什么都沒有提供，代而取之的是使用默認的本地參數(shù)。也就是說下面兩行是完全相等的：
 

graph_db = neo4j.GraphDatabaseService()
graph_db = neo4j.GraphDatabaseService
("http://localhost:7474/db/data/")

第13行介紹了調(diào)用了get_or_create_indexed_node,它提供一種在圖形里創(chuàng)建固定引用點的漂亮方式。傳統(tǒng)的Neo4j索引允許節(jié)點和關(guān)系通過鍵值對訪問，而在這個代碼里我們使用了帶連接的關(guān)鍵字和root值的引用索引實例。在第一次執(zhí)行時，會創(chuàng)建一個新的節(jié)點，而且在隨后的執(zhí)行中，這個節(jié)點(即root)會復(fù)用(reused)。

在第17行，我們看見了推薦的節(jié)點和關(guān)系抽象的標(biāo)記，以及接受和使用節(jié)點和關(guān)系抽象的 create方法。任意多的抽象都可以被傳遞到這個方法中，并且在單個批處理轉(zhuǎn)換中創(chuàng)建實體并以指定它們的順序作為一個列表返回。抽象節(jié)點用 節(jié)點函數(shù)表示并帶有一些屬性，然而抽象關(guān)系使用rel函數(shù)接受一個起始節(jié)點，類型和終止節(jié)點。上下文中，其他節(jié)點，關(guān)系起始和終止節(jié)點可能整合引用到在其他批處理中其他節(jié)點。在我們的例子中，我們把根節(jié)點連接到新創(chuàng)建的person節(jié)點，否則就作為項目0(item 0)了。

這次我們在第24行和38行上以match方法形式和關(guān)系見面[@Lesus 注： oschina代碼行數(shù)有問題。對應(yīng)于本文的第28和44行]。它試圖使用一個特殊的條件集合(set)標(biāo)識關(guān)系，然后使用列表（list）返回它們。這這些示例中，這個關(guān)系和PERSON關(guān)系相匹配，從root節(jié)點和EMAIL關(guān)系開始到所給定的person節(jié)點。和Cypher很相似，用來查詢包含MATCH關(guān)鍵字的場景。

最后值得注意的一點是在上面的代碼中訪問節(jié)點屬性的方式只是其中一種簡單的方式。Py2neo重寫了標(biāo)準python的__getitem__和 __setitem__方法，通過方括號標(biāo)識來方便訪問任何屬性。這點在第34和38行上可以看到。[@Lesus 注：對應(yīng)于本文的第39和44行]

總結(jié)

在那里(代碼行34和38)我們這樣做了，這顯示了它是如何快速簡易地在JAVA環(huán)境之外拼湊出一個Neo4j應(yīng)用程序，也顯示了Py2neo是如何通過REST API來抽象出大多數(shù)沉重的負擔(dān)。這里的例子并沒有解決唯一性，盡管功能上提供了唯一索引和CypherCREATE UNIQUE語句。Django開發(fā)者可能也想要考慮一個層，如Neomodel，它在Py2neo頂層上表示了一個Djangoesque ORM-style 層。