Class: Sequel::Model::Associations::ManyToManyAssociationReflection

Inherits:
AssociationReflection show all
Defined in:
lib/sequel/lib/sequel/model/associations.rb

Constant Summary

Constants included from Inflections

Inflections::CAMELIZE_CONVERT_REGEXP, Inflections::CAMELIZE_MODULE_REGEXP, Inflections::DASH, Inflections::DEMODULIZE_CONVERT_REGEXP, Inflections::EMPTY_STRING, Inflections::SLASH, Inflections::UNDERSCORE, Inflections::UNDERSCORE_CONVERT_REGEXP1, Inflections::UNDERSCORE_CONVERT_REGEXP2, Inflections::UNDERSCORE_CONVERT_REPLACE, Inflections::UNDERSCORE_MODULE_REGEXP, Inflections::VALID_CONSTANT_NAME_REGEXP

Instance Method Summary collapse

Methods inherited from AssociationReflection

#_add_method, #_dataset_method, #_remove_all_method, #_remove_method, #_setter_method, #add_method, #associated_class, #association_method, #dataset_helper_method, #dataset_method, #dataset_need_primary_key?, #eager_graph_lazy_dataset?, #reciprocal_array?, #remove_all_method, #remove_method, #returns_array?, #set_reciprocal_to_self?, #setter_method

Methods included from Inflections

clear, irregular, plural, singular, uncountable

Methods inherited from Hash

#&, #case, #sql_expr, #sql_negate, #sql_or, #|, #~

Instance Method Details

#associated_key_aliasObject

The alias to use for the associated key when eagerly loading


239
240
241
# File 'lib/sequel/lib/sequel/model/associations.rb', line 239

def associated_key_alias
  self[:left_key_alias]
end

#associated_key_columnObject

The column to use for the associated key when eagerly loading


244
245
246
# File 'lib/sequel/lib/sequel/model/associations.rb', line 244

def associated_key_column
  self[:left_key]
end

#associated_key_tableObject

The table containing the column to use for the associated key when eagerly loading


249
250
251
# File 'lib/sequel/lib/sequel/model/associations.rb', line 249

def associated_key_table
  self[:join_table]
end

#default_associated_key_aliasObject

The default associated key alias(es) to use when eager loading associations via eager.


255
256
257
# File 'lib/sequel/lib/sequel/model/associations.rb', line 255

def default_associated_key_alias
  self[:uses_left_composite_keys] ? (0...self[:left_keys].length).map{|i| :"x_foreign_key_#{i}_x"} : :x_foreign_key_x
end

#default_join_tableObject

Default name symbol for the join table.


260
261
262
# File 'lib/sequel/lib/sequel/model/associations.rb', line 260

def default_join_table
  [self[:class_name], self[:model].name].map{|i| underscore(pluralize(demodulize(i)))}.sort.join('_').to_sym
end

#default_left_keyObject

Default foreign key name symbol for key in join table that points to current table's primary key (or :left_primary_key column).


266
267
268
# File 'lib/sequel/lib/sequel/model/associations.rb', line 266

def default_left_key
  :"#{underscore(demodulize(self[:model].name))}_id"
end

#default_right_keyObject

Default foreign key name symbol for foreign key in join table that points to the association's table's primary key (or :right_primary_key column).


272
273
274
# File 'lib/sequel/lib/sequel/model/associations.rb', line 272

def default_right_key
  :"#{singularize(self[:name])}_id"
end

#eager_loader_keyObject

The key to use for the key hash when eager loading


277
278
279
# File 'lib/sequel/lib/sequel/model/associations.rb', line 277

def eager_loader_key
  self[:left_primary_key]
end

#eager_loading_use_associated_key?Boolean

many_to_many associations need to select a key in an associated table to eagerly load


282
283
284
# File 'lib/sequel/lib/sequel/model/associations.rb', line 282

def eager_loading_use_associated_key?
  true
end

#need_associated_primary_key?Boolean

Whether the associated object needs a primary key to be added/removed, true for many_to_many associations.


288
289
290
# File 'lib/sequel/lib/sequel/model/associations.rb', line 288

def need_associated_primary_key?
  true
end

#reciprocalObject

Returns the reciprocal association symbol, if one exists.


293
294
295
296
297
298
299
300
301
302
303
304
305
306
# File 'lib/sequel/lib/sequel/model/associations.rb', line 293

def reciprocal
  return self[:reciprocal] if include?(:reciprocal)
  left_keys = self[:left_keys]
  right_keys = self[:right_keys]
  join_table = self[:join_table]
  associated_class.all_association_reflections.each do |assoc_reflect|
    if assoc_reflect[:type] == :many_to_many && assoc_reflect[:left_keys] == right_keys &&
       assoc_reflect[:right_keys] == left_keys && assoc_reflect[:join_table] == join_table &&
       assoc_reflect.associated_class == self[:model]
      return self[:reciprocal] = assoc_reflect[:name]
    end
  end
  self[:reciprocal] = nil
end

#right_primary_keyObject

The primary key column(s) to use in the associated table (can be symbol or array).


309
310
311
# File 'lib/sequel/lib/sequel/model/associations.rb', line 309

def right_primary_key
  self[:right_primary_key] ||= associated_class.primary_key
end

#right_primary_keysObject

The primary key columns to use in the associated table (always array).


314
315
316
# File 'lib/sequel/lib/sequel/model/associations.rb', line 314

def right_primary_keys
  self[:right_primary_keys] ||= Array(right_primary_key)
end

#selectObject

The columns to select when loading the association, associated_class.table_name.* by default.


319
320
321
322
# File 'lib/sequel/lib/sequel/model/associations.rb', line 319

def select
 return self[:select] if include?(:select)
 self[:select] ||= Sequel::SQL::ColumnAll.new(associated_class.table_name)
end