X-Git-Url: http://nitlanguage.org diff --git a/lib/neo4j/neo4j.nit b/lib/neo4j/neo4j.nit index 88c151a..d512462 100644 --- a/lib/neo4j/neo4j.nit +++ b/lib/neo4j/neo4j.nit @@ -22,43 +22,43 @@ # # In order to connect to Neo4j you need a connector: # -# # Create new Neo4j client -# var client = new Neo4jClient("http://localhost:7474") -# assert client.is_ok +# # Create new Neo4j client +# var client = new Neo4jClient("http://localhost:7474") +# assert client.is_ok # # The fundamental units that form a graph are nodes and relationships. # # Nodes are used to represent entities stored in base: # -# # Create a disconnected node -# var andres = new NeoNode -# andres["name"] = "Andres" -# # Connect the node to Neo4j -# client.save_node(andres) -# assert andres.is_linked -# # -# # Create a second node -# var kate = new NeoNode -# kate["name"] = "Kate" -# client.save_node(kate) -# assert kate.is_linked +# # Create a disconnected node +# var andres = new NeoNode +# andres["name"] = "Andres" +# # Connect the node to Neo4j +# client.save_node(andres) +# assert andres.is_linked +# +# # Create a second node +# var kate = new NeoNode +# kate["name"] = "Kate" +# client.save_node(kate) +# assert kate.is_linked # # Relationships between nodes are a key part of a graph database. # They allow for finding related data. Just like nodes, relationships can have properties. # -# # Create a relationship -# var loves = new NeoEdge(andres, "LOVES", kate) -# client.save_edge(loves) -# assert loves.is_linked +# # Create a relationship +# var loves = new NeoEdge(andres, "LOVES", kate) +# client.save_edge(loves) +# assert loves.is_linked # # Nodes can also be loaded fron Neo4j: # -# # Get a node from DB and explore edges -# var url = andres.url.to_s -# var from = client.load_node(url) -# assert from["name"].to_s == "Andres" -# var to = from.out_nodes("LOVES").first # follow the first LOVES relationship -# assert to["name"].to_s == "Kate" +# # Get a node from DB and explore edges +# var url = andres.url.to_s +# var from = client.load_node(url) +# assert from["name"].to_s == "Andres" +# var to = from.out_nodes("LOVES").first # follow the first LOVES relationship +# assert to["name"].to_s == "Kate" # # For more details, see http://docs.neo4j.org/chunked/milestone/rest-api.html module neo4j @@ -98,8 +98,8 @@ end # `Neo4jClient` is needed to communicate through the REST API # -# var client = new Neo4jClient("http://localhost:7474") -# assert client.is_ok +# var client = new Neo4jClient("http://localhost:7474") +# assert client.is_ok class Neo4jClient # Neo4j REST services baseurl @@ -124,7 +124,7 @@ class Neo4jClient self.cypher_url = root["cypher"].to_s end - fun service_root: Jsonable do return get(base_url / "db/data") + fun service_root: Serializable do return get(base_url / "db/data") # Is the connection with the Neo4j server ok? fun is_ok: Bool do return service_root isa JsonObject @@ -143,7 +143,7 @@ class Neo4jClient # Save the node in base # # var client = new Neo4jClient("http://localhost:7474") - # # + # # # Create a node # var andres = new NeoNode # andres["name"] = "Andres" @@ -199,7 +199,7 @@ class Neo4jClient # From and to nodes will be created. # # var client = new Neo4jClient("http://localhost:7474") - # # + # # var andres = new NeoNode # var kate = new NeoNode # var edge = new NeoEdge(andres, "LOVES", kate) @@ -248,14 +248,14 @@ class Neo4jClient # Retrieve all nodes with specified `lbl` # # var client = new Neo4jClient("http://localhost:7474") - # # + # # var andres = new NeoNode # andres.labels.add_all(["Human", "Male"]) # client.save_node(andres) # var kate = new NeoNode # kate.labels.add_all(["Human", "Female"]) # client.save_node(kate) - # # + # # var nodes = client.nodes_with_label("Human") # assert nodes.has(andres) # assert nodes.has(kate) @@ -274,14 +274,14 @@ class Neo4jClient # Retrieve nodes belonging to all the specified `labels`. # # var client = new Neo4jClient("http://localhost:7474") - # # + # # var andres = new NeoNode # andres.labels.add_all(["Human", "Male"]) # client.save_node(andres) # var kate = new NeoNode # kate.labels.add_all(["Human", "Female"]) # client.save_node(kate) - # # + # # var nodes = client.nodes_with_labels(["Human", "Male"]) # assert nodes.has(andres) # assert not nodes.has(kate) @@ -289,7 +289,7 @@ class Neo4jClient assert not labels.is_empty # Build the query. - var buffer = new RopeBuffer + var buffer = new Buffer buffer.append "match n where \{label_0\} in labels(n)" for i in [1..labels.length[ do buffer.append " and \{label_{i}\} in labels(n)" @@ -314,42 +314,42 @@ class Neo4jClient # Perform a `CypherQuery` # see: CypherQuery - fun cypher(query: CypherQuery): Jsonable do + fun cypher(query: CypherQuery): Serializable do return post("{cypher_url}", query.to_rest) end # GET JSON data from `url` - fun get(url: String): Jsonable do + fun get(url: String): Serializable do var request = new JsonGET(url) var response = request.execute return parse_response(response) end # POST `params` to `url` - fun post(url: String, params: Jsonable): Jsonable do + fun post(url: String, params: Serializable): Serializable do var request = new JsonPOST(url) - request.data = params + request.json_data = params var response = request.execute return parse_response(response) end # PUT `params` at `url` - fun put(url: String, params: Jsonable): Jsonable do + fun put(url: String, params: Serializable): Serializable do var request = new JsonPUT(url) - request.data = params + request.json_data = params var response = request.execute return parse_response(response) end # DELETE `url` - fun delete(url: String): Jsonable do + fun delete(url: String): Serializable do var request = new JsonDELETE(url) var response = request.execute return parse_response(response) end # Parse the cURL `response` as a JSON string - private fun parse_response(response: CurlResponse): Jsonable do + private fun parse_response(response: CurlResponse): Serializable do if response isa CurlResponseSuccess then var str = response.body_str if str.is_empty then return new JsonObject @@ -389,13 +389,13 @@ end # # Example: # -# var client = new Neo4jClient("http://localhost:7474") -# var query = new CypherQuery -# query.nmatch("(n)-[r:LOVES]->(m)") -# query.nwhere("n.name=\"Andres\"") -# query.nreturn("m.name") -# var res = client.cypher(query).as(JsonObject) -# assert res["data"].as(JsonArray).first.as(JsonArray).first == "Kate" +# var client = new Neo4jClient("http://localhost:7474") +# var query = new CypherQuery +# query.nmatch("(n)-[r:LOVES]->(m)") +# query.nwhere("n.name=\"Andres\"") +# query.nreturn("m.name") +# var res = client.cypher(query).as(JsonObject) +# assert res["data"].as(JsonArray).first.as(JsonArray).first == "Kate" # # For more details, see: http://docs.neo4j.org/chunked/milestone/rest-api-cypher.html class CypherQuery @@ -415,6 +415,13 @@ class CypherQuery self.params = params end + # Pass the argument `value` as the parameter `key`. + # + # SEE: `set` + fun []=(key: String, value: nullable Serializable) do + params[key] = value + end + # Add a `CREATE` statement to the query fun ncreate(query: String): CypherQuery do self.query = "{self.query}CREATE {query} " @@ -451,6 +458,25 @@ class CypherQuery return self end + # Pass the argument `value` as the parameter `key`. + # + # Return `self`. + # + # ``` + # var query = (new CypherQuery). + # nmatch("(n)"). + # nwhere("n.key = \{key\}"). + # set("key", "foo") + # + # assert query.params["key"] == "foo" + # ``` + # + # SEE: `[]=` + fun set(key: String, value: nullable Serializable): SELF do + self[key] = value + return self + end + # Translate the query to the body of a corresponding Neo4j REST request. fun to_rest: JsonObject do var obj = new JsonObject @@ -473,11 +499,11 @@ end # # If the entity is initialized unlinked from neo4j: # -# # Create a disconnected node -# var andres = new NeoNode -# andres["name"] = "Andres" -# # At this point, the node is not linked -# assert not andres.is_linked +# # Create a disconnected node +# var andres = new NeoNode +# andres["name"] = "Andres" +# # At this point, the node is not linked +# assert not andres.is_linked # # Then we can link the entity to the base: # @@ -509,13 +535,13 @@ abstract class NeoEntity private var batch_id: nullable Int = null # Load the entity from base - private init from_neo(neo: Neo4jClient, url: String) do + private init from_neo(neo: Neo4jClient, url: String) is nosuper do self.neo = neo self.url = url end # Init entity from JSON representation - private init from_json(neo: Neo4jClient, obj: JsonObject) do + private init from_json(neo: Neo4jClient, obj: JsonObject) is nosuper do self.neo = neo self.url = obj["self"].to_s self.internal_properties = obj["data"].as(JsonObject) @@ -551,13 +577,13 @@ abstract class NeoEntity end # Get the entity property at `key` - fun [](key: String): nullable Jsonable do + fun [](key: String): nullable Serializable do if not properties.has_key(key) then return null return properties[key] end # Set the entity property `value` at `key` - fun []=(key: String, value: nullable Jsonable) do properties[key] = value + fun []=(key: String, value: nullable Serializable) do properties[key] = value # Is the property `key` set? fun has_key(key: String): Bool do return properties.has_key(key) @@ -574,21 +600,21 @@ end # # Creating new nodes: # -# var client = new Neo4jClient("http://localhost:7474") -# # -# var andres = new NeoNode -# andres.labels.add "Person" -# andres["name"] = "Andres" -# andres["age"] = 22 -# client.save_node(andres) -# assert andres.is_linked +# var client = new Neo4jClient("http://localhost:7474") +# +# var andres = new NeoNode +# andres.labels.add "Person" +# andres["name"] = "Andres" +# andres["age"] = 22 +# client.save_node(andres) +# assert andres.is_linked # # Get nodes from Neo4j: # -# var url = andres.url.to_s -# var node = client.load_node(url) -# assert node["name"] == "Andres" -# assert node["age"].to_s.to_i == 22 +# var url = andres.url.to_s +# var node = client.load_node(url) +# assert node["name"] == "Andres" +# assert node["age"].to_s.to_i == 22 class NeoNode super NeoEntity @@ -687,23 +713,23 @@ end # # Create a relationship: # -# var client = new Neo4jClient("http://localhost:7474") -# # Create nodes -# var andres = new NeoNode -# andres["name"] = "Andres" -# var kate = new NeoNode -# kate["name"] = "Kate" -# # Create a relationship of type `LOVES` -# var loves = new NeoEdge(andres, "LOVES", kate) -# client.save_edge(loves) -# assert loves.is_linked +# var client = new Neo4jClient("http://localhost:7474") +# # Create nodes +# var andres = new NeoNode +# andres["name"] = "Andres" +# var kate = new NeoNode +# kate["name"] = "Kate" +# # Create a relationship of type `LOVES` +# var loves = new NeoEdge(andres, "LOVES", kate) +# client.save_edge(loves) +# assert loves.is_linked # # Get an edge from DB: # -# var url = loves.url.to_s -# var edge = client.load_edge(url) -# assert edge.from["name"].to_s == "Andres" -# assert edge.to["name"].to_s == "Kate" +# var url = loves.url.to_s +# var edge = client.load_edge(url) +# assert edge.from["name"].to_s == "Andres" +# assert edge.to["name"].to_s == "Kate" class NeoEdge super NeoEntity @@ -780,21 +806,21 @@ end # # Example: # -# var client = new Neo4jClient("http://localhost:7474") -# # -# var node1 = new NeoNode -# var node2 = new NeoNode -# var edge = new NeoEdge(node1, "TO", node2) -# # -# var batch = new NeoBatch(client) -# batch.save_node(node1) -# batch.save_node(node2) -# batch.save_edge(edge) -# batch.execute -# # -# assert node1.is_linked -# assert node2.is_linked -# assert edge.is_linked +# var client = new Neo4jClient("http://localhost:7474") +# +# var node1 = new NeoNode +# var node2 = new NeoNode +# var edge = new NeoEdge(node1, "TO", node2) +# +# var batch = new NeoBatch(client) +# batch.save_node(node1) +# batch.save_node(node2) +# batch.save_edge(edge) +# batch.execute +# +# assert node1.is_linked +# assert node2.is_linked +# assert edge.is_linked class NeoBatch # Neo4j client connector @@ -916,14 +942,14 @@ class NeoBatch # request.headers["X-Stream"] = "true" var json_jobs = new JsonArray for job in jobs.values do json_jobs.add job.to_rest - request.data = json_jobs + request.json_data = json_jobs var response = request.execute var res = client.parse_response(response) return finalize_batch(res) end # Associate data from response in original nodes and edges - private fun finalize_batch(response: Jsonable): List[NeoError] do + private fun finalize_batch(response: Serializable): List[NeoError] do var errors = new List[NeoError] if not response isa JsonArray then errors.add(new NeoError("Unexpected batch response format.", "Neo4jError")) @@ -1013,7 +1039,7 @@ class NeoJob # Job service target: `/node`, `/labels` etc... var to: String # Body to send with the job service request - var body: nullable Jsonable = null + var body: nullable Serializable = null # JSON formated job fun to_rest: JsonObject do @@ -1027,4 +1053,3 @@ class NeoJob return job end end -