module Neo4j module Core module Index # This class is delegated from the Neo4j::Core::Index::ClassMethod # @see Neo4j::Core::Index::ClassMethods class Indexer # @return [Neo4j::Core::Index::IndexConfig] attr_reader :config def initialize(config) @config = config @indexes = {} # key = type, value = java neo4j index # to enable subclass indexing to work properly, store a list of parent indexers and # whenever an operation is performed on this one, perform it on all end def to_s "Indexer @#{object_id} index on: [#{@config.fields.map { |f| @config.numeric?(f) ? "#{f} (numeric)" : f }.join(', ')}]" end # Add an index on a field so that it will be automatically updated by neo4j transactional events. # Notice that if you want to numerical range queries then you should specify a field_type of either Fixnum or Float. # The index type will by default be :exact. # Index on property arrays are supported. # # @example # MyIndex.index(:age, :field_type => Fixnum) # default :exact # MyIndex.index(:wheels, :field_type => Fixnum) # MyIndex.index(:description, :type => :fulltext) # # @see Neo4j::Core::Index::LuceneQuery # @see #find def index(*args) @config.index(args) end # @return [true,false] if there is an index on the given field. def index?(field) @config.index?(field) end # @return [true,false] if the def trigger_on?(props) @config.trigger_on?(props) end # @return [Symbol] the type of index for the given field (e.g. :exact or :fulltext) def index_type(field) @config.index_type(field) end # @return [true,false] if there is an index of the given type defined. def has_index_type?(type) @config.has_index_type?(type) end # Adds an index on the given entity # This is normally not needed since you can instead declare an index which will automatically keep # the lucene index in sync. # @see #index def add_index(entity, field, value) return false unless index?(field) if (java_array?(value)) conv_value = value.map{|x| indexed_value_for(field, x)}.to_java(Java::OrgNeo4jIndexLucene::ValueContext) else conv_value = indexed_value_for(field, value) end index = index_for_field(field.to_s) index.add(entity, field, conv_value) end def java_array?(value) value.respond_to?(:java_class) && value.java_class.to_s[0..0] == '[' end # Removes an index on the given entity # This is normally not needed since you can instead declare an index which will automatically keep # the lucene index in sync. # @see #index def rm_index(entity, field, value) return false unless index?(field) #return value.each {|x| rm_index(entity, field, x)} if value.respond_to?(:each) index_for_field(field).remove(entity, field, value) end # Performs a Lucene Query. # # In order to use this you have to declare an index on the fields first, see #index. # Notice that you should close the lucene query after the query has been executed. # You can do that either by provide an block or calling the Neo4j::Core::Index::LuceneQuery#close # method. When performing queries from Ruby on Rails you do not need this since it will be automatically closed # (by Rack). # # @example with a block # Person.find('name: kalle') {|query| puts "First item #{query.first}"} # # @example using an exact lucene index # query = Person.find('name: kalle') # puts "First item #{query.first}" # query.close # # @example using an fulltext lucene index # query = Person.find('name: kalle', :type => :fulltext) # puts "First item #{query.first}" # query.close # # @example Sorting, descending by one property # Person.find({:name => 'kalle'}, :sort => {:name => :desc}) # # @example Sorting using the builder pattern # Person.find(:name => 'kalle').asc(:name) # # @example Compound queries and Range queries # Person.find('name: pelle').and(:age).between(2, 5) # Person.find(:name => 'kalle', :age => (2..5)) # Person.find("name: 'asd'").and(:wheels => 8) # # @example Using the lucene java object # # using the Neo4j query method directly # # see, http://api.neo4j.org/1.6.1/org/neo4j/graphdb/index/ReadableIndex.html#query(java.lang.Object) # MyIndex.find('description: "hej"', :type => :fulltext, :wrapped => false).get_single # # @param [String, Hash] query the lucene query # @param [Hash] params lucene configuration parameters # @return [Neo4j::Core::Index::LuceneQuery] a query object which uses the builder pattern for creating compound and sort queries. # @note You must specify the index type :fulltext) if the property is index using that index (default is :exact) def find(query, params = {}) index = index_for_type(params[:type] || :exact) query.delete(:sort) if query.is_a?(Hash) && query.include?(:sort) query = (params[:wrapped].nil? || params[:wrapped]) ? LuceneQuery.new(index, @config, query, params) : index.query(query) if block_given? begin ret = yield query ensure query.close end ret else query end end # Delete all index configuration. No more automatic indexing will be performed def rm_index_config @config.rm_index_config end # delete the index, if no type is provided clear all types of indexes def rm_index_type(type=nil) if type key = @config.index_name_for_type(type) @indexes[key] && @indexes[key].delete @indexes[key] = nil else @indexes.each_value { |index| index.delete } @indexes.clear end end # Called when the neo4j shutdown in order to release references to indexes def on_neo4j_shutdown @indexes.clear end # Called from the event handler when a new node or relationships is about to be committed. def update_index_on(node, field, old_val, new_val) if index?(field) rm_index(node, field, old_val) if old_val add_index(node, field, new_val) if new_val end end # Called from the event handler when deleting a property def remove_index_on(node, old_props) @config.fields.each { |field| rm_index(node, field, old_props[field]) if old_props[field] } end # Creates a wrapped ValueContext for the given value. Checks if it's numeric value in the configuration. # @return [Java::OrgNeo4jIndexLucene::ValueContext] a wrapped neo4j lucene value context def indexed_value_for(field, value) if @config.numeric?(field) Java::OrgNeo4jIndexLucene::ValueContext.new(value).indexNumeric else Java::OrgNeo4jIndexLucene::ValueContext.new(value) end end # @return [Java::OrgNeo4jGraphdb::Index] for the given field def index_for_field(field) type = @config.index_type(field) index_name = index_name_for_type(type) @indexes[index_name] ||= create_index_with(type, index_name) end # @return [Java::OrgNeo4jGraphdb::Index] for the given index type def index_for_type(type) index_name = index_name_for_type(type) @indexes[index_name] ||= create_index_with(type, index_name) end # @return [String] the name of the index which are stored on the filesystem def index_name_for_type(type) @config.index_name_for_type(type) end # @return [Hash] the lucene config for the given index type def lucene_config(type) conf = Neo4j::Config[:lucene][type.to_s] raise "unknown lucene type #{type}" unless conf conf end # Creates a new lucene index using the lucene configuration for the given index_name # # @param [:node, :relationship] type relationship or node index # @param [String] index_name the (file) name of the index # @return [Java::OrgNeo4jGraphdb::Index] for the given index type def create_index_with(type, index_name) db = Neo4j.started_db index_config = lucene_config(type) if config.entity_type == :node db.lucene.for_nodes(index_name, index_config) else db.lucene.for_relationships(index_name, index_config) end end end end end end