Module: Sequel::Model::Associations::SingularAssociationReflection

Included in:
OneThroughOneAssociationReflection, OneToOneAssociationReflection, Plugins::ManyThroughMany::OneThroughManyAssociationReflection
Defined in:
lib/sequel/model/associations.rb

Overview

Methods that turn an association that returns multiple objects into an association that returns a single object.

Instance Method Summary collapse

Instance Method Details

#assign_singular? ⇒ Boolean

Singular associations do not assign singular if they are using the ruby eager limit strategy and have a slice range, since they need to store the array of associated objects in order to pick the correct one with an offset.

Returns:

  • (Boolean) 

1125
1126
1127
 
# File 'lib/sequel/model/associations.rb', line 1125

def assign_singular?
  super && (eager_limit_strategy != :ruby || !slice_range)
end

#filter_by_associations_add_conditions? ⇒ Boolean

Add conditions when filtering by singular associations with orders, since the underlying relationship is probably not one-to-one.

Returns:

  • (Boolean) 

1131
1132
1133
 
# File 'lib/sequel/model/associations.rb', line 1131

def filter_by_associations_add_conditions?
  super || self[:order] || self[:eager_limit_strategy] || self[:filter_limit_strategy]
end

#limit_and_offset ⇒ Object

Make sure singular associations always have 1 as the limit


1136
1137
1138
1139
1140
1141
1142
1143
 
# File 'lib/sequel/model/associations.rb', line 1136

def limit_and_offset
  r = super
  if r.first == 1
    r
  else
    [1, r[1]]
  end
end

#returns_array? ⇒ Boolean

Singular associations always return a single object, not an array.

Returns:

  • (Boolean) 

1146
1147
1148
 
# File 'lib/sequel/model/associations.rb', line 1146

def returns_array?
  false
end