Class: ActiveFedora::Reflection::AssociationReflection
- Inherits:
-
MacroReflection
- Object
- MacroReflection
- ActiveFedora::Reflection::AssociationReflection
- Defined in:
- lib/active_fedora/reflection.rb
Overview
Holds all the meta-data about an association as it was specified in the Active Record class.
Direct Known Subclasses
Constant Summary collapse
- VALID_AUTOMATIC_INVERSE_MACROS =
[:has_many, :has_and_belongs_to_many, :belongs_to].freeze
- INVALID_AUTOMATIC_INVERSE_OPTIONS =
[:conditions, :through, :polymorphic, :foreign_key].freeze
Instance Attribute Summary
Attributes inherited from MacroReflection
#active_fedora, #macro, #name, #options
Instance Method Summary collapse
- #association_class ⇒ Object
-
#chain ⇒ Object
A chain of reflections from this one back to the owner.
- #check_validity! ⇒ Object
- #check_validity_of_inverse! ⇒ Object
-
#create_association(*options) ⇒ Object
Creates a new instance of the associated class, and immediately saves it with ActiveFedora::Base#save.
- #foreign_key ⇒ Object
- #has_inverse? ⇒ Boolean
-
#initialize(macro, name, options, active_fedora) ⇒ AssociationReflection
constructor
:nodoc:.
- #inverse_of ⇒ Object
-
#predicate ⇒ Object
Returns the RDF predicate as defined by the :predicate option.
- #predicate_for_solr ⇒ Object
- #solr_key ⇒ Object
-
#validate? ⇒ Boolean
Returns whether or not the association should be validated as part of the parent’s validation.
Methods inherited from MacroReflection
#belongs_to?, #build_association, #class_name, #collection?, #has_and_belongs_to_many?, #has_many?, #klass
Constructor Details
#initialize(macro, name, options, active_fedora) ⇒ AssociationReflection
:nodoc:
174 175 176 177 |
# File 'lib/active_fedora/reflection.rb', line 174 def initialize(macro, name, , active_fedora) super @collection = [:has_many, :has_and_belongs_to_many, :directly_contains, :indirectly_contains].include?(macro) end |
Instance Method Details
#association_class ⇒ Object
245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 |
# File 'lib/active_fedora/reflection.rb', line 245 def association_class case macro when :contains Associations::BasicContainsAssociation when :belongs_to Associations::BelongsToAssociation when :has_and_belongs_to_many Associations::HasAndBelongsToManyAssociation when :has_many Associations::HasManyAssociation when :singular_rdf Associations::SingularRDF when :rdf Associations::RDF when :directly_contains Associations::DirectlyContainsAssociation when :directly_contains_one Associations::DirectlyContainsOneAssociation when :indirectly_contains Associations::IndirectlyContainsAssociation end end |
#chain ⇒ Object
A chain of reflections from this one back to the owner. For more see the explanation in ThroughReflection.
216 217 218 |
# File 'lib/active_fedora/reflection.rb', line 216 def chain [self] end |
#check_validity! ⇒ Object
205 206 207 |
# File 'lib/active_fedora/reflection.rb', line 205 def check_validity! check_validity_of_inverse! end |
#check_validity_of_inverse! ⇒ Object
209 210 211 212 |
# File 'lib/active_fedora/reflection.rb', line 209 def check_validity_of_inverse! return if [:polymorphic] || !(has_inverse? && inverse_of.nil?) raise InverseOfAssociationNotFoundError, self end |
#create_association(*options) ⇒ Object
Creates a new instance of the associated class, and immediately saves it with ActiveFedora::Base#save. options
will be passed to the class’s creation method. Returns the newly created object.
182 183 184 |
# File 'lib/active_fedora/reflection.rb', line 182 def create_association(*) klass.create(*) end |
#foreign_key ⇒ Object
186 187 188 |
# File 'lib/active_fedora/reflection.rb', line 186 def foreign_key @foreign_key ||= [:foreign_key] || derive_foreign_key end |
#has_inverse? ⇒ Boolean
222 223 224 |
# File 'lib/active_fedora/reflection.rb', line 222 def has_inverse? inverse_name end |
#inverse_of ⇒ Object
226 227 228 229 230 |
# File 'lib/active_fedora/reflection.rb', line 226 def inverse_of return unless inverse_name @inverse_of ||= klass.reflect_on_association inverse_name end |
#predicate ⇒ Object
Returns the RDF predicate as defined by the :predicate option
191 192 193 |
# File 'lib/active_fedora/reflection.rb', line 191 def predicate [:predicate] end |
#predicate_for_solr ⇒ Object
195 196 197 |
# File 'lib/active_fedora/reflection.rb', line 195 def predicate_for_solr predicate.fragment || predicate.to_s.rpartition(/\//).last end |
#solr_key ⇒ Object
199 200 201 202 203 |
# File 'lib/active_fedora/reflection.rb', line 199 def solr_key @solr_key ||= begin ActiveFedora::SolrQueryBuilder.solr_name(predicate_for_solr, :symbol) end end |
#validate? ⇒ Boolean
Returns whether or not the association should be validated as part of the parent’s validation.
Unless you explicitly disable validation with :validate => false
, validation will take place when:
-
you explicitly enable validation;
:validate => true
-
you use autosave;
:autosave => true
-
the association is a
has_many
association
241 242 243 |
# File 'lib/active_fedora/reflection.rb', line 241 def validate? ![:validate].nil? ? [:validate] : ([:autosave] == true || macro == :has_many) end |