activerecord 4.2.0 → 5.2.8.1
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +5 -5
- data/CHANGELOG.md +640 -928
- data/MIT-LICENSE +2 -2
- data/README.rdoc +10 -11
- data/examples/performance.rb +32 -31
- data/examples/simple.rb +5 -4
- data/lib/active_record/aggregations.rb +264 -247
- data/lib/active_record/association_relation.rb +24 -6
- data/lib/active_record/associations/alias_tracker.rb +29 -35
- data/lib/active_record/associations/association.rb +87 -41
- data/lib/active_record/associations/association_scope.rb +106 -132
- data/lib/active_record/associations/belongs_to_association.rb +55 -36
- data/lib/active_record/associations/belongs_to_polymorphic_association.rb +8 -8
- data/lib/active_record/associations/builder/association.rb +29 -38
- data/lib/active_record/associations/builder/belongs_to.rb +77 -30
- data/lib/active_record/associations/builder/collection_association.rb +14 -23
- data/lib/active_record/associations/builder/has_and_belongs_to_many.rb +50 -39
- data/lib/active_record/associations/builder/has_many.rb +6 -4
- data/lib/active_record/associations/builder/has_one.rb +13 -6
- data/lib/active_record/associations/builder/singular_association.rb +15 -11
- data/lib/active_record/associations/collection_association.rb +145 -266
- data/lib/active_record/associations/collection_proxy.rb +242 -138
- data/lib/active_record/associations/foreign_association.rb +13 -0
- data/lib/active_record/associations/has_many_association.rb +35 -75
- data/lib/active_record/associations/has_many_through_association.rb +51 -69
- data/lib/active_record/associations/has_one_association.rb +39 -24
- data/lib/active_record/associations/has_one_through_association.rb +18 -9
- data/lib/active_record/associations/join_dependency/join_association.rb +40 -81
- data/lib/active_record/associations/join_dependency/join_base.rb +10 -9
- data/lib/active_record/associations/join_dependency/join_part.rb +12 -12
- data/lib/active_record/associations/join_dependency.rb +134 -154
- data/lib/active_record/associations/preloader/association.rb +85 -116
- data/lib/active_record/associations/preloader/through_association.rb +85 -74
- data/lib/active_record/associations/preloader.rb +83 -93
- data/lib/active_record/associations/singular_association.rb +27 -40
- data/lib/active_record/associations/through_association.rb +48 -23
- data/lib/active_record/associations.rb +1732 -1596
- data/lib/active_record/attribute_assignment.rb +58 -182
- data/lib/active_record/attribute_decorators.rb +39 -15
- data/lib/active_record/attribute_methods/before_type_cast.rb +12 -5
- data/lib/active_record/attribute_methods/dirty.rb +94 -125
- data/lib/active_record/attribute_methods/primary_key.rb +86 -71
- data/lib/active_record/attribute_methods/query.rb +4 -2
- data/lib/active_record/attribute_methods/read.rb +45 -63
- data/lib/active_record/attribute_methods/serialization.rb +40 -20
- data/lib/active_record/attribute_methods/time_zone_conversion.rb +62 -36
- data/lib/active_record/attribute_methods/write.rb +31 -46
- data/lib/active_record/attribute_methods.rb +170 -117
- data/lib/active_record/attributes.rb +201 -74
- data/lib/active_record/autosave_association.rb +118 -45
- data/lib/active_record/base.rb +60 -48
- data/lib/active_record/callbacks.rb +97 -57
- data/lib/active_record/coders/json.rb +3 -1
- data/lib/active_record/coders/yaml_column.rb +37 -13
- data/lib/active_record/collection_cache_key.rb +53 -0
- data/lib/active_record/connection_adapters/abstract/connection_pool.rb +712 -284
- data/lib/active_record/connection_adapters/abstract/database_limits.rb +10 -5
- data/lib/active_record/connection_adapters/abstract/database_statements.rb +254 -87
- data/lib/active_record/connection_adapters/abstract/query_cache.rb +72 -22
- data/lib/active_record/connection_adapters/abstract/quoting.rb +119 -52
- data/lib/active_record/connection_adapters/abstract/savepoints.rb +6 -4
- data/lib/active_record/connection_adapters/abstract/schema_creation.rb +67 -46
- data/lib/active_record/connection_adapters/abstract/schema_definitions.rb +328 -217
- data/lib/active_record/connection_adapters/abstract/schema_dumper.rb +81 -36
- data/lib/active_record/connection_adapters/abstract/schema_statements.rb +617 -212
- data/lib/active_record/connection_adapters/abstract/transaction.rb +139 -75
- data/lib/active_record/connection_adapters/abstract_adapter.rb +332 -191
- data/lib/active_record/connection_adapters/abstract_mysql_adapter.rb +567 -563
- data/lib/active_record/connection_adapters/column.rb +50 -41
- data/lib/active_record/connection_adapters/connection_specification.rb +147 -135
- data/lib/active_record/connection_adapters/determine_if_preparable_visitor.rb +33 -0
- data/lib/active_record/connection_adapters/mysql/column.rb +27 -0
- data/lib/active_record/connection_adapters/mysql/database_statements.rb +140 -0
- data/lib/active_record/connection_adapters/mysql/explain_pretty_printer.rb +72 -0
- data/lib/active_record/connection_adapters/mysql/quoting.rb +44 -0
- data/lib/active_record/connection_adapters/mysql/schema_creation.rb +73 -0
- data/lib/active_record/connection_adapters/mysql/schema_definitions.rb +87 -0
- data/lib/active_record/connection_adapters/mysql/schema_dumper.rb +80 -0
- data/lib/active_record/connection_adapters/mysql/schema_statements.rb +148 -0
- data/lib/active_record/connection_adapters/mysql/type_metadata.rb +35 -0
- data/lib/active_record/connection_adapters/mysql2_adapter.rb +42 -195
- data/lib/active_record/connection_adapters/postgresql/column.rb +35 -11
- data/lib/active_record/connection_adapters/postgresql/database_statements.rb +46 -115
- data/lib/active_record/connection_adapters/postgresql/explain_pretty_printer.rb +44 -0
- data/lib/active_record/connection_adapters/postgresql/oid/array.rb +50 -57
- data/lib/active_record/connection_adapters/postgresql/oid/bit.rb +10 -6
- data/lib/active_record/connection_adapters/postgresql/oid/bit_varying.rb +2 -0
- data/lib/active_record/connection_adapters/postgresql/oid/bytea.rb +5 -2
- data/lib/active_record/connection_adapters/postgresql/oid/cidr.rb +5 -1
- data/lib/active_record/connection_adapters/postgresql/oid/date.rb +13 -1
- data/lib/active_record/connection_adapters/postgresql/oid/date_time.rb +9 -13
- data/lib/active_record/connection_adapters/postgresql/oid/decimal.rb +3 -1
- data/lib/active_record/connection_adapters/postgresql/oid/enum.rb +7 -3
- data/lib/active_record/connection_adapters/postgresql/oid/hstore.rb +31 -19
- data/lib/active_record/connection_adapters/postgresql/oid/inet.rb +2 -0
- data/lib/active_record/connection_adapters/postgresql/oid/jsonb.rb +3 -11
- data/lib/active_record/connection_adapters/postgresql/oid/legacy_point.rb +45 -0
- data/lib/active_record/connection_adapters/postgresql/oid/money.rb +7 -9
- data/lib/active_record/connection_adapters/postgresql/oid/{integer.rb → oid.rb} +6 -2
- data/lib/active_record/connection_adapters/postgresql/oid/point.rb +33 -11
- data/lib/active_record/connection_adapters/postgresql/oid/range.rb +52 -34
- data/lib/active_record/connection_adapters/postgresql/oid/specialized_string.rb +4 -1
- data/lib/active_record/connection_adapters/postgresql/oid/type_map_initializer.rb +65 -51
- data/lib/active_record/connection_adapters/postgresql/oid/uuid.rb +5 -3
- data/lib/active_record/connection_adapters/postgresql/oid/vector.rb +3 -1
- data/lib/active_record/connection_adapters/postgresql/oid/xml.rb +3 -1
- data/lib/active_record/connection_adapters/postgresql/oid.rb +23 -25
- data/lib/active_record/connection_adapters/postgresql/quoting.rb +107 -47
- data/lib/active_record/connection_adapters/postgresql/referential_integrity.rb +27 -14
- data/lib/active_record/connection_adapters/postgresql/schema_creation.rb +65 -0
- data/lib/active_record/connection_adapters/postgresql/schema_definitions.rb +144 -90
- data/lib/active_record/connection_adapters/postgresql/schema_dumper.rb +50 -0
- data/lib/active_record/connection_adapters/postgresql/schema_statements.rb +466 -280
- data/lib/active_record/connection_adapters/postgresql/type_metadata.rb +39 -0
- data/lib/active_record/connection_adapters/postgresql/utils.rb +12 -8
- data/lib/active_record/connection_adapters/postgresql_adapter.rb +439 -330
- data/lib/active_record/connection_adapters/schema_cache.rb +48 -24
- data/lib/active_record/connection_adapters/sql_type_metadata.rb +34 -0
- data/lib/active_record/connection_adapters/sqlite3/explain_pretty_printer.rb +21 -0
- data/lib/active_record/connection_adapters/sqlite3/quoting.rb +67 -0
- data/lib/active_record/connection_adapters/sqlite3/schema_creation.rb +17 -0
- data/lib/active_record/connection_adapters/sqlite3/schema_definitions.rb +19 -0
- data/lib/active_record/connection_adapters/sqlite3/schema_dumper.rb +18 -0
- data/lib/active_record/connection_adapters/sqlite3/schema_statements.rb +106 -0
- data/lib/active_record/connection_adapters/sqlite3_adapter.rb +269 -324
- data/lib/active_record/connection_adapters/statement_pool.rb +34 -13
- data/lib/active_record/connection_handling.rb +40 -27
- data/lib/active_record/core.rb +205 -202
- data/lib/active_record/counter_cache.rb +80 -37
- data/lib/active_record/define_callbacks.rb +22 -0
- data/lib/active_record/dynamic_matchers.rb +87 -105
- data/lib/active_record/enum.rb +136 -90
- data/lib/active_record/errors.rb +180 -52
- data/lib/active_record/explain.rb +23 -11
- data/lib/active_record/explain_registry.rb +4 -2
- data/lib/active_record/explain_subscriber.rb +11 -6
- data/lib/active_record/fixture_set/file.rb +35 -9
- data/lib/active_record/fixtures.rb +193 -135
- data/lib/active_record/gem_version.rb +5 -3
- data/lib/active_record/inheritance.rb +148 -112
- data/lib/active_record/integration.rb +70 -28
- data/lib/active_record/internal_metadata.rb +45 -0
- data/lib/active_record/legacy_yaml_adapter.rb +48 -0
- data/lib/active_record/locale/en.yml +3 -2
- data/lib/active_record/locking/optimistic.rb +92 -98
- data/lib/active_record/locking/pessimistic.rb +15 -3
- data/lib/active_record/log_subscriber.rb +95 -33
- data/lib/active_record/migration/command_recorder.rb +133 -90
- data/lib/active_record/migration/compatibility.rb +217 -0
- data/lib/active_record/migration/join_table.rb +8 -6
- data/lib/active_record/migration.rb +594 -267
- data/lib/active_record/model_schema.rb +292 -111
- data/lib/active_record/nested_attributes.rb +266 -214
- data/lib/active_record/no_touching.rb +8 -2
- data/lib/active_record/null_relation.rb +24 -37
- data/lib/active_record/persistence.rb +350 -119
- data/lib/active_record/query_cache.rb +13 -24
- data/lib/active_record/querying.rb +19 -17
- data/lib/active_record/railtie.rb +117 -35
- data/lib/active_record/railties/console_sandbox.rb +2 -0
- data/lib/active_record/railties/controller_runtime.rb +9 -3
- data/lib/active_record/railties/databases.rake +160 -174
- data/lib/active_record/readonly_attributes.rb +5 -4
- data/lib/active_record/reflection.rb +447 -288
- data/lib/active_record/relation/batches/batch_enumerator.rb +69 -0
- data/lib/active_record/relation/batches.rb +204 -55
- data/lib/active_record/relation/calculations.rb +259 -244
- data/lib/active_record/relation/delegation.rb +67 -60
- data/lib/active_record/relation/finder_methods.rb +290 -253
- data/lib/active_record/relation/from_clause.rb +26 -0
- data/lib/active_record/relation/merger.rb +91 -68
- data/lib/active_record/relation/predicate_builder/array_handler.rb +24 -23
- data/lib/active_record/relation/predicate_builder/association_query_value.rb +46 -0
- data/lib/active_record/relation/predicate_builder/base_handler.rb +19 -0
- data/lib/active_record/relation/predicate_builder/basic_object_handler.rb +20 -0
- data/lib/active_record/relation/predicate_builder/polymorphic_array_value.rb +56 -0
- data/lib/active_record/relation/predicate_builder/range_handler.rb +42 -0
- data/lib/active_record/relation/predicate_builder/relation_handler.rb +7 -1
- data/lib/active_record/relation/predicate_builder.rb +118 -92
- data/lib/active_record/relation/query_attribute.rb +45 -0
- data/lib/active_record/relation/query_methods.rb +446 -389
- data/lib/active_record/relation/record_fetch_warning.rb +51 -0
- data/lib/active_record/relation/spawn_methods.rb +18 -16
- data/lib/active_record/relation/where_clause.rb +186 -0
- data/lib/active_record/relation/where_clause_factory.rb +34 -0
- data/lib/active_record/relation.rb +287 -339
- data/lib/active_record/result.rb +54 -36
- data/lib/active_record/runtime_registry.rb +6 -4
- data/lib/active_record/sanitization.rb +155 -124
- data/lib/active_record/schema.rb +30 -24
- data/lib/active_record/schema_dumper.rb +91 -87
- data/lib/active_record/schema_migration.rb +19 -19
- data/lib/active_record/scoping/default.rb +102 -84
- data/lib/active_record/scoping/named.rb +81 -32
- data/lib/active_record/scoping.rb +45 -26
- data/lib/active_record/secure_token.rb +40 -0
- data/lib/active_record/serialization.rb +5 -5
- data/lib/active_record/statement_cache.rb +45 -35
- data/lib/active_record/store.rb +42 -36
- data/lib/active_record/suppressor.rb +61 -0
- data/lib/active_record/table_metadata.rb +82 -0
- data/lib/active_record/tasks/database_tasks.rb +136 -95
- data/lib/active_record/tasks/mysql_database_tasks.rb +59 -89
- data/lib/active_record/tasks/postgresql_database_tasks.rb +84 -31
- data/lib/active_record/tasks/sqlite_database_tasks.rb +44 -16
- data/lib/active_record/timestamp.rb +70 -38
- data/lib/active_record/touch_later.rb +64 -0
- data/lib/active_record/transactions.rb +208 -123
- data/lib/active_record/translation.rb +2 -0
- data/lib/active_record/type/adapter_specific_registry.rb +136 -0
- data/lib/active_record/type/date.rb +4 -41
- data/lib/active_record/type/date_time.rb +4 -38
- data/lib/active_record/type/decimal_without_scale.rb +6 -2
- data/lib/active_record/type/hash_lookup_type_map.rb +13 -5
- data/lib/active_record/type/internal/timezone.rb +17 -0
- data/lib/active_record/type/json.rb +30 -0
- data/lib/active_record/type/serialized.rb +30 -15
- data/lib/active_record/type/text.rb +2 -2
- data/lib/active_record/type/time.rb +11 -16
- data/lib/active_record/type/type_map.rb +15 -17
- data/lib/active_record/type/unsigned_integer.rb +9 -7
- data/lib/active_record/type.rb +79 -23
- data/lib/active_record/type_caster/connection.rb +33 -0
- data/lib/active_record/type_caster/map.rb +23 -0
- data/lib/active_record/type_caster.rb +9 -0
- data/lib/active_record/validations/absence.rb +25 -0
- data/lib/active_record/validations/associated.rb +13 -4
- data/lib/active_record/validations/length.rb +26 -0
- data/lib/active_record/validations/presence.rb +14 -13
- data/lib/active_record/validations/uniqueness.rb +41 -32
- data/lib/active_record/validations.rb +38 -35
- data/lib/active_record/version.rb +3 -1
- data/lib/active_record.rb +36 -21
- data/lib/rails/generators/active_record/application_record/application_record_generator.rb +27 -0
- data/lib/rails/generators/active_record/application_record/templates/application_record.rb.tt +5 -0
- data/lib/rails/generators/active_record/migration/migration_generator.rb +43 -35
- data/lib/rails/generators/active_record/migration/templates/{create_table_migration.rb → create_table_migration.rb.tt} +8 -6
- data/lib/rails/generators/active_record/migration/templates/{migration.rb → migration.rb.tt} +8 -7
- data/lib/rails/generators/active_record/migration.rb +18 -1
- data/lib/rails/generators/active_record/model/model_generator.rb +18 -22
- data/lib/rails/generators/active_record/model/templates/{model.rb → model.rb.tt} +3 -0
- data/lib/rails/generators/active_record.rb +7 -5
- metadata +77 -53
- data/lib/active_record/associations/preloader/belongs_to.rb +0 -17
- data/lib/active_record/associations/preloader/collection_association.rb +0 -24
- data/lib/active_record/associations/preloader/has_many.rb +0 -17
- data/lib/active_record/associations/preloader/has_many_through.rb +0 -19
- data/lib/active_record/associations/preloader/has_one.rb +0 -23
- data/lib/active_record/associations/preloader/has_one_through.rb +0 -9
- data/lib/active_record/associations/preloader/singular_association.rb +0 -21
- data/lib/active_record/attribute.rb +0 -149
- data/lib/active_record/attribute_set/builder.rb +0 -86
- data/lib/active_record/attribute_set.rb +0 -77
- data/lib/active_record/connection_adapters/mysql_adapter.rb +0 -491
- data/lib/active_record/connection_adapters/postgresql/array_parser.rb +0 -93
- data/lib/active_record/connection_adapters/postgresql/oid/float.rb +0 -21
- data/lib/active_record/connection_adapters/postgresql/oid/infinity.rb +0 -13
- data/lib/active_record/connection_adapters/postgresql/oid/json.rb +0 -35
- data/lib/active_record/connection_adapters/postgresql/oid/time.rb +0 -11
- data/lib/active_record/railties/jdbcmysql_error.rb +0 -16
- data/lib/active_record/serializers/xml_serializer.rb +0 -193
- data/lib/active_record/type/big_integer.rb +0 -13
- data/lib/active_record/type/binary.rb +0 -50
- data/lib/active_record/type/boolean.rb +0 -30
- data/lib/active_record/type/decimal.rb +0 -40
- data/lib/active_record/type/decorator.rb +0 -14
- data/lib/active_record/type/float.rb +0 -19
- data/lib/active_record/type/integer.rb +0 -55
- data/lib/active_record/type/mutable.rb +0 -16
- data/lib/active_record/type/numeric.rb +0 -36
- data/lib/active_record/type/string.rb +0 -36
- data/lib/active_record/type/time_value.rb +0 -38
- data/lib/active_record/type/value.rb +0 -101
- /data/lib/rails/generators/active_record/model/templates/{module.rb → module.rb.tt} +0 -0
@@ -1,266 +1,283 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
1
3
|
module ActiveRecord
|
2
|
-
#
|
3
|
-
module Aggregations
|
4
|
+
# See ActiveRecord::Aggregations::ClassMethods for documentation
|
5
|
+
module Aggregations
|
4
6
|
extend ActiveSupport::Concern
|
5
7
|
|
6
|
-
def
|
7
|
-
@aggregation_cache
|
8
|
+
def initialize_dup(*) # :nodoc:
|
9
|
+
@aggregation_cache = {}
|
10
|
+
super
|
8
11
|
end
|
9
12
|
|
10
|
-
|
11
|
-
|
12
|
-
|
13
|
-
|
14
|
-
# the entity object (when the entity is initialized either as a new object or from finding an
|
15
|
-
# existing object) and how it can be turned back into attributes (when the entity is saved to
|
16
|
-
# the database).
|
17
|
-
#
|
18
|
-
# class Customer < ActiveRecord::Base
|
19
|
-
# composed_of :balance, class_name: "Money", mapping: %w(balance amount)
|
20
|
-
# composed_of :address, mapping: [ %w(address_street street), %w(address_city city) ]
|
21
|
-
# end
|
22
|
-
#
|
23
|
-
# The customer class now has the following methods to manipulate the value objects:
|
24
|
-
# * <tt>Customer#balance, Customer#balance=(money)</tt>
|
25
|
-
# * <tt>Customer#address, Customer#address=(address)</tt>
|
26
|
-
#
|
27
|
-
# These methods will operate with value objects like the ones described below:
|
28
|
-
#
|
29
|
-
# class Money
|
30
|
-
# include Comparable
|
31
|
-
# attr_reader :amount, :currency
|
32
|
-
# EXCHANGE_RATES = { "USD_TO_DKK" => 6 }
|
33
|
-
#
|
34
|
-
# def initialize(amount, currency = "USD")
|
35
|
-
# @amount, @currency = amount, currency
|
36
|
-
# end
|
37
|
-
#
|
38
|
-
# def exchange_to(other_currency)
|
39
|
-
# exchanged_amount = (amount * EXCHANGE_RATES["#{currency}_TO_#{other_currency}"]).floor
|
40
|
-
# Money.new(exchanged_amount, other_currency)
|
41
|
-
# end
|
42
|
-
#
|
43
|
-
# def ==(other_money)
|
44
|
-
# amount == other_money.amount && currency == other_money.currency
|
45
|
-
# end
|
46
|
-
#
|
47
|
-
# def <=>(other_money)
|
48
|
-
# if currency == other_money.currency
|
49
|
-
# amount <=> other_money.amount
|
50
|
-
# else
|
51
|
-
# amount <=> other_money.exchange_to(currency).amount
|
52
|
-
# end
|
53
|
-
# end
|
54
|
-
# end
|
55
|
-
#
|
56
|
-
# class Address
|
57
|
-
# attr_reader :street, :city
|
58
|
-
# def initialize(street, city)
|
59
|
-
# @street, @city = street, city
|
60
|
-
# end
|
61
|
-
#
|
62
|
-
# def close_to?(other_address)
|
63
|
-
# city == other_address.city
|
64
|
-
# end
|
65
|
-
#
|
66
|
-
# def ==(other_address)
|
67
|
-
# city == other_address.city && street == other_address.street
|
68
|
-
# end
|
69
|
-
# end
|
70
|
-
#
|
71
|
-
# Now it's possible to access attributes from the database through the value objects instead. If
|
72
|
-
# you choose to name the composition the same as the attribute's name, it will be the only way to
|
73
|
-
# access that attribute. That's the case with our +balance+ attribute. You interact with the value
|
74
|
-
# objects just like you would with any other attribute:
|
75
|
-
#
|
76
|
-
# customer.balance = Money.new(20) # sets the Money value object and the attribute
|
77
|
-
# customer.balance # => Money value object
|
78
|
-
# customer.balance.exchange_to("DKK") # => Money.new(120, "DKK")
|
79
|
-
# customer.balance > Money.new(10) # => true
|
80
|
-
# customer.balance == Money.new(20) # => true
|
81
|
-
# customer.balance < Money.new(5) # => false
|
82
|
-
#
|
83
|
-
# Value objects can also be composed of multiple attributes, such as the case of Address. The order
|
84
|
-
# of the mappings will determine the order of the parameters.
|
85
|
-
#
|
86
|
-
# customer.address_street = "Hyancintvej"
|
87
|
-
# customer.address_city = "Copenhagen"
|
88
|
-
# customer.address # => Address.new("Hyancintvej", "Copenhagen")
|
89
|
-
#
|
90
|
-
# customer.address_street = "Vesterbrogade"
|
91
|
-
# customer.address # => Address.new("Hyancintvej", "Copenhagen")
|
92
|
-
# customer.clear_aggregation_cache
|
93
|
-
# customer.address # => Address.new("Vesterbrogade", "Copenhagen")
|
94
|
-
#
|
95
|
-
# customer.address = Address.new("May Street", "Chicago")
|
96
|
-
# customer.address_street # => "May Street"
|
97
|
-
# customer.address_city # => "Chicago"
|
98
|
-
#
|
99
|
-
# == Writing value objects
|
100
|
-
#
|
101
|
-
# Value objects are immutable and interchangeable objects that represent a given value, such as
|
102
|
-
# a Money object representing $5. Two Money objects both representing $5 should be equal (through
|
103
|
-
# methods such as <tt>==</tt> and <tt><=></tt> from Comparable if ranking makes sense). This is
|
104
|
-
# unlike entity objects where equality is determined by identity. An entity class such as Customer can
|
105
|
-
# easily have two different objects that both have an address on Hyancintvej. Entity identity is
|
106
|
-
# determined by object or relational unique identifiers (such as primary keys). Normal
|
107
|
-
# ActiveRecord::Base classes are entity objects.
|
108
|
-
#
|
109
|
-
# It's also important to treat the value objects as immutable. Don't allow the Money object to have
|
110
|
-
# its amount changed after creation. Create a new Money object with the new value instead. The
|
111
|
-
# Money#exchange_to method is an example of this. It returns a new value object instead of changing
|
112
|
-
# its own values. Active Record won't persist value objects that have been changed through means
|
113
|
-
# other than the writer method.
|
114
|
-
#
|
115
|
-
# The immutable requirement is enforced by Active Record by freezing any object assigned as a value
|
116
|
-
# object. Attempting to change it afterwards will result in a RuntimeError.
|
117
|
-
#
|
118
|
-
# Read more about value objects on http://c2.com/cgi/wiki?ValueObject and on the dangers of not
|
119
|
-
# keeping value objects immutable on http://c2.com/cgi/wiki?ValueObjectsShouldBeImmutable
|
120
|
-
#
|
121
|
-
# == Custom constructors and converters
|
122
|
-
#
|
123
|
-
# By default value objects are initialized by calling the <tt>new</tt> constructor of the value
|
124
|
-
# class passing each of the mapped attributes, in the order specified by the <tt>:mapping</tt>
|
125
|
-
# option, as arguments. If the value class doesn't support this convention then +composed_of+ allows
|
126
|
-
# a custom constructor to be specified.
|
127
|
-
#
|
128
|
-
# When a new value is assigned to the value object, the default assumption is that the new value
|
129
|
-
# is an instance of the value class. Specifying a custom converter allows the new value to be automatically
|
130
|
-
# converted to an instance of value class if necessary.
|
131
|
-
#
|
132
|
-
# For example, the NetworkResource model has +network_address+ and +cidr_range+ attributes that should be
|
133
|
-
# aggregated using the NetAddr::CIDR value class (http://www.ruby-doc.org/gems/docs/n/netaddr-1.5.0/NetAddr/CIDR.html).
|
134
|
-
# The constructor for the value class is called +create+ and it expects a CIDR address string as a parameter.
|
135
|
-
# New values can be assigned to the value object using either another NetAddr::CIDR object, a string
|
136
|
-
# or an array. The <tt>:constructor</tt> and <tt>:converter</tt> options can be used to meet
|
137
|
-
# these requirements:
|
138
|
-
#
|
139
|
-
# class NetworkResource < ActiveRecord::Base
|
140
|
-
# composed_of :cidr,
|
141
|
-
# class_name: 'NetAddr::CIDR',
|
142
|
-
# mapping: [ %w(network_address network), %w(cidr_range bits) ],
|
143
|
-
# allow_nil: true,
|
144
|
-
# constructor: Proc.new { |network_address, cidr_range| NetAddr::CIDR.create("#{network_address}/#{cidr_range}") },
|
145
|
-
# converter: Proc.new { |value| NetAddr::CIDR.create(value.is_a?(Array) ? value.join('/') : value) }
|
146
|
-
# end
|
147
|
-
#
|
148
|
-
# # This calls the :constructor
|
149
|
-
# network_resource = NetworkResource.new(network_address: '192.168.0.1', cidr_range: 24)
|
150
|
-
#
|
151
|
-
# # These assignments will both use the :converter
|
152
|
-
# network_resource.cidr = [ '192.168.2.1', 8 ]
|
153
|
-
# network_resource.cidr = '192.168.0.1/24'
|
154
|
-
#
|
155
|
-
# # This assignment won't use the :converter as the value is already an instance of the value class
|
156
|
-
# network_resource.cidr = NetAddr::CIDR.create('192.168.2.1/8')
|
157
|
-
#
|
158
|
-
# # Saving and then reloading will use the :constructor on reload
|
159
|
-
# network_resource.save
|
160
|
-
# network_resource.reload
|
161
|
-
#
|
162
|
-
# == Finding records by a value object
|
163
|
-
#
|
164
|
-
# Once a +composed_of+ relationship is specified for a model, records can be loaded from the database
|
165
|
-
# by specifying an instance of the value object in the conditions hash. The following example
|
166
|
-
# finds all customers with +balance_amount+ equal to 20 and +balance_currency+ equal to "USD":
|
167
|
-
#
|
168
|
-
# Customer.where(balance: Money.new(20, "USD"))
|
169
|
-
#
|
170
|
-
module ClassMethods
|
171
|
-
# Adds reader and writer methods for manipulating a value object:
|
172
|
-
# <tt>composed_of :address</tt> adds <tt>address</tt> and <tt>address=(new_address)</tt> methods.
|
173
|
-
#
|
174
|
-
# Options are:
|
175
|
-
# * <tt>:class_name</tt> - Specifies the class name of the association. Use it only if that name
|
176
|
-
# can't be inferred from the part id. So <tt>composed_of :address</tt> will by default be linked
|
177
|
-
# to the Address class, but if the real class name is CompanyAddress, you'll have to specify it
|
178
|
-
# with this option.
|
179
|
-
# * <tt>:mapping</tt> - Specifies the mapping of entity attributes to attributes of the value
|
180
|
-
# object. Each mapping is represented as an array where the first item is the name of the
|
181
|
-
# entity attribute and the second item is the name of the attribute in the value object. The
|
182
|
-
# order in which mappings are defined determines the order in which attributes are sent to the
|
183
|
-
# value class constructor.
|
184
|
-
# * <tt>:allow_nil</tt> - Specifies that the value object will not be instantiated when all mapped
|
185
|
-
# attributes are +nil+. Setting the value object to +nil+ has the effect of writing +nil+ to all
|
186
|
-
# mapped attributes.
|
187
|
-
# This defaults to +false+.
|
188
|
-
# * <tt>:constructor</tt> - A symbol specifying the name of the constructor method or a Proc that
|
189
|
-
# is called to initialize the value object. The constructor is passed all of the mapped attributes,
|
190
|
-
# in the order that they are defined in the <tt>:mapping option</tt>, as arguments and uses them
|
191
|
-
# to instantiate a <tt>:class_name</tt> object.
|
192
|
-
# The default is <tt>:new</tt>.
|
193
|
-
# * <tt>:converter</tt> - A symbol specifying the name of a class method of <tt>:class_name</tt>
|
194
|
-
# or a Proc that is called when a new value is assigned to the value object. The converter is
|
195
|
-
# passed the single value that is used in the assignment and is only called if the new value is
|
196
|
-
# not an instance of <tt>:class_name</tt>. If <tt>:allow_nil</tt> is set to true, the converter
|
197
|
-
# can return nil to skip the assignment.
|
198
|
-
#
|
199
|
-
# Option examples:
|
200
|
-
# composed_of :temperature, mapping: %w(reading celsius)
|
201
|
-
# composed_of :balance, class_name: "Money", mapping: %w(balance amount),
|
202
|
-
# converter: Proc.new { |balance| balance.to_money }
|
203
|
-
# composed_of :address, mapping: [ %w(address_street street), %w(address_city city) ]
|
204
|
-
# composed_of :gps_location
|
205
|
-
# composed_of :gps_location, allow_nil: true
|
206
|
-
# composed_of :ip_address,
|
207
|
-
# class_name: 'IPAddr',
|
208
|
-
# mapping: %w(ip to_i),
|
209
|
-
# constructor: Proc.new { |ip| IPAddr.new(ip, Socket::AF_INET) },
|
210
|
-
# converter: Proc.new { |ip| ip.is_a?(Integer) ? IPAddr.new(ip, Socket::AF_INET) : IPAddr.new(ip.to_s) }
|
211
|
-
#
|
212
|
-
def composed_of(part_id, options = {})
|
213
|
-
options.assert_valid_keys(:class_name, :mapping, :allow_nil, :constructor, :converter)
|
13
|
+
def reload(*) # :nodoc:
|
14
|
+
clear_aggregation_cache
|
15
|
+
super
|
16
|
+
end
|
214
17
|
|
215
|
-
|
216
|
-
class_name = options[:class_name] || name.camelize
|
217
|
-
mapping = options[:mapping] || [ name, name ]
|
218
|
-
mapping = [ mapping ] unless mapping.first.is_a?(Array)
|
219
|
-
allow_nil = options[:allow_nil] || false
|
220
|
-
constructor = options[:constructor] || :new
|
221
|
-
converter = options[:converter]
|
18
|
+
private
|
222
19
|
|
223
|
-
|
224
|
-
|
20
|
+
def clear_aggregation_cache
|
21
|
+
@aggregation_cache.clear if persisted?
|
22
|
+
end
|
225
23
|
|
226
|
-
|
227
|
-
|
24
|
+
def init_internals
|
25
|
+
@aggregation_cache = {}
|
26
|
+
super
|
228
27
|
end
|
229
28
|
|
230
|
-
|
231
|
-
|
232
|
-
|
233
|
-
|
234
|
-
|
235
|
-
|
236
|
-
|
237
|
-
|
238
|
-
|
239
|
-
|
240
|
-
|
241
|
-
|
29
|
+
# Active Record implements aggregation through a macro-like class method called #composed_of
|
30
|
+
# for representing attributes as value objects. It expresses relationships like "Account [is]
|
31
|
+
# composed of Money [among other things]" or "Person [is] composed of [an] address". Each call
|
32
|
+
# to the macro adds a description of how the value objects are created from the attributes of
|
33
|
+
# the entity object (when the entity is initialized either as a new object or from finding an
|
34
|
+
# existing object) and how it can be turned back into attributes (when the entity is saved to
|
35
|
+
# the database).
|
36
|
+
#
|
37
|
+
# class Customer < ActiveRecord::Base
|
38
|
+
# composed_of :balance, class_name: "Money", mapping: %w(balance amount)
|
39
|
+
# composed_of :address, mapping: [ %w(address_street street), %w(address_city city) ]
|
40
|
+
# end
|
41
|
+
#
|
42
|
+
# The customer class now has the following methods to manipulate the value objects:
|
43
|
+
# * <tt>Customer#balance, Customer#balance=(money)</tt>
|
44
|
+
# * <tt>Customer#address, Customer#address=(address)</tt>
|
45
|
+
#
|
46
|
+
# These methods will operate with value objects like the ones described below:
|
47
|
+
#
|
48
|
+
# class Money
|
49
|
+
# include Comparable
|
50
|
+
# attr_reader :amount, :currency
|
51
|
+
# EXCHANGE_RATES = { "USD_TO_DKK" => 6 }
|
52
|
+
#
|
53
|
+
# def initialize(amount, currency = "USD")
|
54
|
+
# @amount, @currency = amount, currency
|
55
|
+
# end
|
56
|
+
#
|
57
|
+
# def exchange_to(other_currency)
|
58
|
+
# exchanged_amount = (amount * EXCHANGE_RATES["#{currency}_TO_#{other_currency}"]).floor
|
59
|
+
# Money.new(exchanged_amount, other_currency)
|
60
|
+
# end
|
61
|
+
#
|
62
|
+
# def ==(other_money)
|
63
|
+
# amount == other_money.amount && currency == other_money.currency
|
64
|
+
# end
|
65
|
+
#
|
66
|
+
# def <=>(other_money)
|
67
|
+
# if currency == other_money.currency
|
68
|
+
# amount <=> other_money.amount
|
69
|
+
# else
|
70
|
+
# amount <=> other_money.exchange_to(currency).amount
|
71
|
+
# end
|
72
|
+
# end
|
73
|
+
# end
|
74
|
+
#
|
75
|
+
# class Address
|
76
|
+
# attr_reader :street, :city
|
77
|
+
# def initialize(street, city)
|
78
|
+
# @street, @city = street, city
|
79
|
+
# end
|
80
|
+
#
|
81
|
+
# def close_to?(other_address)
|
82
|
+
# city == other_address.city
|
83
|
+
# end
|
84
|
+
#
|
85
|
+
# def ==(other_address)
|
86
|
+
# city == other_address.city && street == other_address.street
|
87
|
+
# end
|
88
|
+
# end
|
89
|
+
#
|
90
|
+
# Now it's possible to access attributes from the database through the value objects instead. If
|
91
|
+
# you choose to name the composition the same as the attribute's name, it will be the only way to
|
92
|
+
# access that attribute. That's the case with our +balance+ attribute. You interact with the value
|
93
|
+
# objects just like you would with any other attribute:
|
94
|
+
#
|
95
|
+
# customer.balance = Money.new(20) # sets the Money value object and the attribute
|
96
|
+
# customer.balance # => Money value object
|
97
|
+
# customer.balance.exchange_to("DKK") # => Money.new(120, "DKK")
|
98
|
+
# customer.balance > Money.new(10) # => true
|
99
|
+
# customer.balance == Money.new(20) # => true
|
100
|
+
# customer.balance < Money.new(5) # => false
|
101
|
+
#
|
102
|
+
# Value objects can also be composed of multiple attributes, such as the case of Address. The order
|
103
|
+
# of the mappings will determine the order of the parameters.
|
104
|
+
#
|
105
|
+
# customer.address_street = "Hyancintvej"
|
106
|
+
# customer.address_city = "Copenhagen"
|
107
|
+
# customer.address # => Address.new("Hyancintvej", "Copenhagen")
|
108
|
+
#
|
109
|
+
# customer.address = Address.new("May Street", "Chicago")
|
110
|
+
# customer.address_street # => "May Street"
|
111
|
+
# customer.address_city # => "Chicago"
|
112
|
+
#
|
113
|
+
# == Writing value objects
|
114
|
+
#
|
115
|
+
# Value objects are immutable and interchangeable objects that represent a given value, such as
|
116
|
+
# a Money object representing $5. Two Money objects both representing $5 should be equal (through
|
117
|
+
# methods such as <tt>==</tt> and <tt><=></tt> from Comparable if ranking makes sense). This is
|
118
|
+
# unlike entity objects where equality is determined by identity. An entity class such as Customer can
|
119
|
+
# easily have two different objects that both have an address on Hyancintvej. Entity identity is
|
120
|
+
# determined by object or relational unique identifiers (such as primary keys). Normal
|
121
|
+
# ActiveRecord::Base classes are entity objects.
|
122
|
+
#
|
123
|
+
# It's also important to treat the value objects as immutable. Don't allow the Money object to have
|
124
|
+
# its amount changed after creation. Create a new Money object with the new value instead. The
|
125
|
+
# <tt>Money#exchange_to</tt> method is an example of this. It returns a new value object instead of changing
|
126
|
+
# its own values. Active Record won't persist value objects that have been changed through means
|
127
|
+
# other than the writer method.
|
128
|
+
#
|
129
|
+
# The immutable requirement is enforced by Active Record by freezing any object assigned as a value
|
130
|
+
# object. Attempting to change it afterwards will result in a +RuntimeError+.
|
131
|
+
#
|
132
|
+
# Read more about value objects on http://c2.com/cgi/wiki?ValueObject and on the dangers of not
|
133
|
+
# keeping value objects immutable on http://c2.com/cgi/wiki?ValueObjectsShouldBeImmutable
|
134
|
+
#
|
135
|
+
# == Custom constructors and converters
|
136
|
+
#
|
137
|
+
# By default value objects are initialized by calling the <tt>new</tt> constructor of the value
|
138
|
+
# class passing each of the mapped attributes, in the order specified by the <tt>:mapping</tt>
|
139
|
+
# option, as arguments. If the value class doesn't support this convention then #composed_of allows
|
140
|
+
# a custom constructor to be specified.
|
141
|
+
#
|
142
|
+
# When a new value is assigned to the value object, the default assumption is that the new value
|
143
|
+
# is an instance of the value class. Specifying a custom converter allows the new value to be automatically
|
144
|
+
# converted to an instance of value class if necessary.
|
145
|
+
#
|
146
|
+
# For example, the +NetworkResource+ model has +network_address+ and +cidr_range+ attributes that should be
|
147
|
+
# aggregated using the +NetAddr::CIDR+ value class (http://www.rubydoc.info/gems/netaddr/1.5.0/NetAddr/CIDR).
|
148
|
+
# The constructor for the value class is called +create+ and it expects a CIDR address string as a parameter.
|
149
|
+
# New values can be assigned to the value object using either another +NetAddr::CIDR+ object, a string
|
150
|
+
# or an array. The <tt>:constructor</tt> and <tt>:converter</tt> options can be used to meet
|
151
|
+
# these requirements:
|
152
|
+
#
|
153
|
+
# class NetworkResource < ActiveRecord::Base
|
154
|
+
# composed_of :cidr,
|
155
|
+
# class_name: 'NetAddr::CIDR',
|
156
|
+
# mapping: [ %w(network_address network), %w(cidr_range bits) ],
|
157
|
+
# allow_nil: true,
|
158
|
+
# constructor: Proc.new { |network_address, cidr_range| NetAddr::CIDR.create("#{network_address}/#{cidr_range}") },
|
159
|
+
# converter: Proc.new { |value| NetAddr::CIDR.create(value.is_a?(Array) ? value.join('/') : value) }
|
160
|
+
# end
|
161
|
+
#
|
162
|
+
# # This calls the :constructor
|
163
|
+
# network_resource = NetworkResource.new(network_address: '192.168.0.1', cidr_range: 24)
|
164
|
+
#
|
165
|
+
# # These assignments will both use the :converter
|
166
|
+
# network_resource.cidr = [ '192.168.2.1', 8 ]
|
167
|
+
# network_resource.cidr = '192.168.0.1/24'
|
168
|
+
#
|
169
|
+
# # This assignment won't use the :converter as the value is already an instance of the value class
|
170
|
+
# network_resource.cidr = NetAddr::CIDR.create('192.168.2.1/8')
|
171
|
+
#
|
172
|
+
# # Saving and then reloading will use the :constructor on reload
|
173
|
+
# network_resource.save
|
174
|
+
# network_resource.reload
|
175
|
+
#
|
176
|
+
# == Finding records by a value object
|
177
|
+
#
|
178
|
+
# Once a #composed_of relationship is specified for a model, records can be loaded from the database
|
179
|
+
# by specifying an instance of the value object in the conditions hash. The following example
|
180
|
+
# finds all customers with +address_street+ equal to "May Street" and +address_city+ equal to "Chicago":
|
181
|
+
#
|
182
|
+
# Customer.where(address: Address.new("May Street", "Chicago"))
|
183
|
+
#
|
184
|
+
module ClassMethods
|
185
|
+
# Adds reader and writer methods for manipulating a value object:
|
186
|
+
# <tt>composed_of :address</tt> adds <tt>address</tt> and <tt>address=(new_address)</tt> methods.
|
187
|
+
#
|
188
|
+
# Options are:
|
189
|
+
# * <tt>:class_name</tt> - Specifies the class name of the association. Use it only if that name
|
190
|
+
# can't be inferred from the part id. So <tt>composed_of :address</tt> will by default be linked
|
191
|
+
# to the Address class, but if the real class name is +CompanyAddress+, you'll have to specify it
|
192
|
+
# with this option.
|
193
|
+
# * <tt>:mapping</tt> - Specifies the mapping of entity attributes to attributes of the value
|
194
|
+
# object. Each mapping is represented as an array where the first item is the name of the
|
195
|
+
# entity attribute and the second item is the name of the attribute in the value object. The
|
196
|
+
# order in which mappings are defined determines the order in which attributes are sent to the
|
197
|
+
# value class constructor.
|
198
|
+
# * <tt>:allow_nil</tt> - Specifies that the value object will not be instantiated when all mapped
|
199
|
+
# attributes are +nil+. Setting the value object to +nil+ has the effect of writing +nil+ to all
|
200
|
+
# mapped attributes.
|
201
|
+
# This defaults to +false+.
|
202
|
+
# * <tt>:constructor</tt> - A symbol specifying the name of the constructor method or a Proc that
|
203
|
+
# is called to initialize the value object. The constructor is passed all of the mapped attributes,
|
204
|
+
# in the order that they are defined in the <tt>:mapping option</tt>, as arguments and uses them
|
205
|
+
# to instantiate a <tt>:class_name</tt> object.
|
206
|
+
# The default is <tt>:new</tt>.
|
207
|
+
# * <tt>:converter</tt> - A symbol specifying the name of a class method of <tt>:class_name</tt>
|
208
|
+
# or a Proc that is called when a new value is assigned to the value object. The converter is
|
209
|
+
# passed the single value that is used in the assignment and is only called if the new value is
|
210
|
+
# not an instance of <tt>:class_name</tt>. If <tt>:allow_nil</tt> is set to true, the converter
|
211
|
+
# can return +nil+ to skip the assignment.
|
212
|
+
#
|
213
|
+
# Option examples:
|
214
|
+
# composed_of :temperature, mapping: %w(reading celsius)
|
215
|
+
# composed_of :balance, class_name: "Money", mapping: %w(balance amount)
|
216
|
+
# composed_of :address, mapping: [ %w(address_street street), %w(address_city city) ]
|
217
|
+
# composed_of :gps_location
|
218
|
+
# composed_of :gps_location, allow_nil: true
|
219
|
+
# composed_of :ip_address,
|
220
|
+
# class_name: 'IPAddr',
|
221
|
+
# mapping: %w(ip to_i),
|
222
|
+
# constructor: Proc.new { |ip| IPAddr.new(ip, Socket::AF_INET) },
|
223
|
+
# converter: Proc.new { |ip| ip.is_a?(Integer) ? IPAddr.new(ip, Socket::AF_INET) : IPAddr.new(ip.to_s) }
|
224
|
+
#
|
225
|
+
def composed_of(part_id, options = {})
|
226
|
+
options.assert_valid_keys(:class_name, :mapping, :allow_nil, :constructor, :converter)
|
227
|
+
|
228
|
+
name = part_id.id2name
|
229
|
+
class_name = options[:class_name] || name.camelize
|
230
|
+
mapping = options[:mapping] || [ name, name ]
|
231
|
+
mapping = [ mapping ] unless mapping.first.is_a?(Array)
|
232
|
+
allow_nil = options[:allow_nil] || false
|
233
|
+
constructor = options[:constructor] || :new
|
234
|
+
converter = options[:converter]
|
235
|
+
|
236
|
+
reader_method(name, class_name, mapping, allow_nil, constructor)
|
237
|
+
writer_method(name, class_name, mapping, allow_nil, converter)
|
238
|
+
|
239
|
+
reflection = ActiveRecord::Reflection.create(:composed_of, part_id, nil, options, self)
|
240
|
+
Reflection.add_aggregate_reflection self, part_id, reflection
|
242
241
|
end
|
243
242
|
|
244
|
-
|
245
|
-
|
246
|
-
|
247
|
-
|
248
|
-
|
243
|
+
private
|
244
|
+
def reader_method(name, class_name, mapping, allow_nil, constructor)
|
245
|
+
define_method(name) do
|
246
|
+
if @aggregation_cache[name].nil? && (!allow_nil || mapping.any? { |key, _| !_read_attribute(key).nil? })
|
247
|
+
attrs = mapping.collect { |key, _| _read_attribute(key) }
|
248
|
+
object = constructor.respond_to?(:call) ?
|
249
|
+
constructor.call(*attrs) :
|
250
|
+
class_name.constantize.send(constructor, *attrs)
|
251
|
+
@aggregation_cache[name] = object
|
252
|
+
end
|
253
|
+
@aggregation_cache[name]
|
249
254
|
end
|
255
|
+
end
|
250
256
|
|
251
|
-
|
252
|
-
|
253
|
-
|
257
|
+
def writer_method(name, class_name, mapping, allow_nil, converter)
|
258
|
+
define_method("#{name}=") do |part|
|
259
|
+
klass = class_name.constantize
|
260
|
+
|
261
|
+
unless part.is_a?(klass) || converter.nil? || part.nil?
|
262
|
+
part = converter.respond_to?(:call) ? converter.call(part) : klass.send(converter, part)
|
263
|
+
end
|
264
|
+
|
265
|
+
hash_from_multiparameter_assignment = part.is_a?(Hash) &&
|
266
|
+
part.each_key.all? { |k| k.is_a?(Integer) }
|
267
|
+
if hash_from_multiparameter_assignment
|
268
|
+
raise ArgumentError unless part.size == part.each_key.max
|
269
|
+
part = klass.new(*part.sort.map(&:last))
|
270
|
+
end
|
254
271
|
|
255
|
-
|
256
|
-
|
257
|
-
|
258
|
-
|
259
|
-
|
260
|
-
|
272
|
+
if part.nil? && allow_nil
|
273
|
+
mapping.each { |key, _| self[key] = nil }
|
274
|
+
@aggregation_cache[name] = nil
|
275
|
+
else
|
276
|
+
mapping.each { |key, value| self[key] = part.send(value) }
|
277
|
+
@aggregation_cache[name] = part.freeze
|
278
|
+
end
|
261
279
|
end
|
262
280
|
end
|
263
|
-
|
264
|
-
end
|
281
|
+
end
|
265
282
|
end
|
266
283
|
end
|
@@ -1,7 +1,9 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
1
3
|
module ActiveRecord
|
2
4
|
class AssociationRelation < Relation
|
3
|
-
def initialize(klass,
|
4
|
-
super(klass
|
5
|
+
def initialize(klass, association)
|
6
|
+
super(klass)
|
5
7
|
@association = association
|
6
8
|
end
|
7
9
|
|
@@ -10,13 +12,29 @@ module ActiveRecord
|
|
10
12
|
end
|
11
13
|
|
12
14
|
def ==(other)
|
13
|
-
other ==
|
15
|
+
other == records
|
14
16
|
end
|
15
17
|
|
16
|
-
|
18
|
+
def build(*args, &block)
|
19
|
+
scoping { @association.build(*args, &block) }
|
20
|
+
end
|
21
|
+
alias new build
|
22
|
+
|
23
|
+
def create(*args, &block)
|
24
|
+
scoping { @association.create(*args, &block) }
|
25
|
+
end
|
17
26
|
|
18
|
-
def
|
19
|
-
|
27
|
+
def create!(*args, &block)
|
28
|
+
scoping { @association.create!(*args, &block) }
|
20
29
|
end
|
30
|
+
|
31
|
+
private
|
32
|
+
|
33
|
+
def exec_queries
|
34
|
+
super do |record|
|
35
|
+
@association.set_inverse_instance_from_queries(record)
|
36
|
+
yield record if block_given?
|
37
|
+
end
|
38
|
+
end
|
21
39
|
end
|
22
40
|
end
|