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