module Neo4j module ActiveNode module Query # Methods related to returning nodes and rels from QueryProxy module QueryProxyEnumerable include Enumerable # Just like every other each but it allows for optional params to support the versions that also return relationships. # The node and rel params are typically used by those other methods but there's nothing stopping you from # using `your_node.each(true, true)` instead of `your_node.each_with_rel`. # @return [Enumerable] An enumerable containing some combination of nodes and rels. def each(node = true, rel = nil, &_block) if node && rel enumerable_query(identity, rel_var).each { |returned_node, returned_rel| yield returned_node, returned_rel } else pluck_this = !rel ? identity : @rel_var enumerable_query(pluck_this).each { |returned_node| yield returned_node } end end # When called at the end of a QueryProxy chain, it will return the resultant relationship objects intead of nodes. # For example, to return the relationship between a given student and their lessons: # student.lessons.each_rel do |rel| # @return [Enumerable] An enumerable containing any number of applicable relationship objects. def each_rel(&block) block_given? ? each(false, true, &block) : to_enum(:each, false, true) end # When called at the end of a QueryProxy chain, it will return the nodes and relationships of the last link. # For example, to return a lesson and each relationship to a given student: # student.lessons.each_with_rel do |lesson, rel| def each_with_rel(&block) block_given? ? each(true, true, &block) : to_enum(:each, true, true) end # Does exactly what you would hope. Without it, comparing `bobby.lessons == sandy.lessons` would evaluate to false because it # would be comparing the QueryProxy objects, not the lessons themselves. def ==(other) self.to_a == other end # For getting variables which have been defined as part of the association chain def pluck(*args) self.query.pluck(*args) end private # Executes the query against the database if the results are not already present in a node's association cache. This method is # shared by each, each_rel, and each_with_rel. # @param [String,Symbol] node The string or symbol of the node to return from the database. # @param [String,Symbol] rel The string or symbol of a relationship to return from the database. def enumerable_query(node, rel = nil) pluck_this = rel.nil? ? [node] : [node, rel] return self.pluck(*pluck_this) if @association.nil? || caller.nil? cypher_string = self.to_cypher_with_params(pluck_this) association_collection = caller.association_instance_get(cypher_string, @association) if association_collection.nil? association_collection = self.pluck(*pluck_this) caller.association_instance_set(cypher_string, association_collection, @association) unless association_collection.empty? end association_collection end end end end end