Class: Sequel::Model::Associations::OneToManyAssociationReflection

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

Direct Known Subclasses

OneToOneAssociationReflection

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?, #eager_limit_strategy, #eager_loading_use_associated_key?, #limit_and_offset, #need_associated_primary_key?, #qualify, #qualify_assoc, #qualify_cur, #reciprocal, #remove_all_method, #remove_method, #returns_array?, #select, #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_object_keysObject

The keys in the associated model’s table related to this association



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

def associated_object_keys
  self[:keys]
end

#can_have_associated_objects?(obj) ⇒ Boolean

one_to_many associations can only have associated objects if none of the :keys options have a nil value.

Returns:

  • (Boolean)


324
325
326
# File 'lib/sequel/model/associations.rb', line 324

def can_have_associated_objects?(obj)
  !self[:primary_keys].any?{|k| obj.send(k).nil?}
end

#default_keyObject

Default foreign key name symbol for key in associated table that points to current table’s primary key.



330
331
332
# File 'lib/sequel/model/associations.rb', line 330

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

#eager_loader_keyObject

The key to use for the key hash when eager loading



335
336
337
# File 'lib/sequel/model/associations.rb', line 335

def eager_loader_key
  self[:eager_loader_key] ||= primary_key
end

#eager_loading_predicate_keyObject Also known as: qualified_key

The hash key to use for the eager loading predicate (left side of IN (1, 2, 3))



340
341
342
# File 'lib/sequel/model/associations.rb', line 340

def eager_loading_predicate_key
  self[:eager_loading_predicate_key] ||= qualify_assoc(self[:key])
end

#primary_keyObject

The column in the current table that the key in the associated table references.



346
347
348
# File 'lib/sequel/model/associations.rb', line 346

def primary_key
 self[:primary_key]
end

#qualified_primary_keyObject

#primary_key qualified by the current table



351
352
353
# File 'lib/sequel/model/associations.rb', line 351

def qualified_primary_key
  self[:qualified_primary_key] ||= qualify_cur(primary_key)
end

#reciprocal_array?Boolean

Whether the reciprocal of this association returns an array of objects instead of a single object, false for a one_to_many association.

Returns:

  • (Boolean)


357
358
359
# File 'lib/sequel/model/associations.rb', line 357

def reciprocal_array?
  false
end

#remove_before_destroy?Boolean

Destroying one_to_many associated objects automatically deletes the foreign key.

Returns:

  • (Boolean)


362
363
364
# File 'lib/sequel/model/associations.rb', line 362

def remove_before_destroy?
  false
end

#remove_should_check_existing?Boolean

The one_to_many association needs to check that an object to be removed already is associated.

Returns:

  • (Boolean)


367
368
369
# File 'lib/sequel/model/associations.rb', line 367

def remove_should_check_existing?
  true
end

#set_reciprocal_to_self?Boolean

One to many associations set the reciprocal to self when loading associated records.

Returns:

  • (Boolean)


372
373
374
# File 'lib/sequel/model/associations.rb', line 372

def set_reciprocal_to_self?
  true
end