Module: Familia::Features::Relationships::Indexing::ModelClassMethods

Defined in:
lib/familia/features/relationships/indexing.rb

Overview

Indexing::ModelClassMethods

Instance Method Summary collapse

Instance Method Details

#ensure_index_field(target_class, index_name, field_type) ⇒ Object

Ensure proper DataType field is declared for index Similar to ensure_collection_field in participation system



139
140
141
142
143
 
# File 'lib/familia/features/relationships/indexing.rb', line 139

def ensure_index_field(target_class, index_name, field_type)
  return if target_class.method_defined?(index_name) || target_class.respond_to?(index_name)

  target_class.send(field_type, index_name)
end

#indexing_relationships ⇒ Object

Get all indexing relationships for this class



133
134
135
 
# File 'lib/familia/features/relationships/indexing.rb', line 133

def indexing_relationships
  @indexing_relationships ||= []
end

#multi_index(field, index_name, within:, query: true) ⇒ Object

Define an indexed_by relationship for fast lookups

Define a multi-value index (1:many mapping)

Examples:

Instance-scoped multi-value indexing

multi_index :department, :dept_index, within: Company

Parameters:

  • field (Symbol) —

    The field to index on

  • index_name (Symbol) —

    Name of the index

  • within (Class, Symbol) —

    The parent class that owns the index

  • query (Boolean) (defaults to: true) —

    Whether to generate query methods



98
99
100
101
102
103
104
105
106
 
# File 'lib/familia/features/relationships/indexing.rb', line 98

def multi_index(field, index_name, within:, query: true)
  MultiIndexGenerators.setup(
    indexed_class: self,
    field: field,
    index_name: index_name,
    within: within,
    query: query,
  )
end

#unique_index(field, index_name, within: nil, query: true) ⇒ Object

Define a unique index lookup (1:1 mapping)

Examples:

Class-level unique index

unique_index :email, :email_lookup
unique_index :username, :username_lookup, query: false

Instance-scoped unique index

unique_index :badge_number, :badge_index, within: Company

Parameters:

  • field (Symbol) —

    The field to index on

  • index_name (Symbol) —

    Name of the index hash

  • within (Class, Symbol) (defaults to: nil) —

    Optional parent class for instance-scoped unique index

  • query (Boolean) (defaults to: true) —

    Whether to generate query methods



122
123
124
125
126
127
128
129
130
 
# File 'lib/familia/features/relationships/indexing.rb', line 122

def unique_index(field, index_name, within: nil, query: true)
  UniqueIndexGenerators.setup(
    indexed_class: self,
    field: field,
    index_name: index_name,
    within: within,
    query: query,
  )
end