aboutsummaryrefslogtreecommitdiffstats
path: root/activerecord/lib/active_record/attribute_methods/read.rb
blob: a52d36aad87f6694841c3ec1585bd0c43f3babb4 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
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
require 'active_record/attributes/translator'

module ActiveRecord
  module AttributeMethods
    module Read
      extend ActiveSupport::Concern

      ATTRIBUTE_TYPES_CACHED_BY_DEFAULT = [:datetime, :timestamp, :time, :date]

      included do
        config_attribute :attribute_types_cached_by_default, :global => true
        self.attribute_types_cached_by_default = ATTRIBUTE_TYPES_CACHED_BY_DEFAULT
      end

      module ClassMethods
        # +cache_attributes+ allows you to declare which converted attribute values should
        # be cached. Usually caching only pays off for attributes with expensive conversion
        # methods, like time related columns (e.g. +created_at+, +updated_at+).
        def cache_attributes(*attribute_names)
          cached_attributes.merge attribute_names.map { |attr| attr.to_s }
        end

        # Returns the attributes which are cached. By default time related columns
        # with datatype <tt>:datetime, :timestamp, :time, :date</tt> are cached.
        def cached_attributes
          @cached_attributes ||= columns.select { |c| cacheable_column?(c) }.map { |col| col.name }.to_set
        end

        # Returns +true+ if the provided attribute is being cached.
        def cache_attribute?(attr_name)
          cached_attributes.include?(attr_name)
        end

        def undefine_attribute_methods
          generated_external_attribute_methods.module_eval do
            instance_methods.each { |m| undef_method(m) }
          end

          super
        end

        def type_cast_attribute(attr_name, attributes, cache = {}) #:nodoc:
          return unless attr_name
          attr_name = attr_name.to_s

          if generated_external_attribute_methods.method_defined?(attr_name)
            if attributes.has_key?(attr_name) || attr_name == 'id'
              generated_external_attribute_methods.send(attr_name, attributes[attr_name], attributes, cache, attr_name)
            end
          elsif !attribute_methods_generated?
            # If we haven't generated the caster methods yet, do that and
            # then try again
            define_attribute_methods
            type_cast_attribute(attr_name, attributes, cache)
          else
            # If we get here, the attribute has no associated DB column, so
            # just return it verbatim.
            attributes[attr_name]
          end
        end

        protected
        # We want to generate the methods via module_eval rather than define_method,
        # because define_method is slower on dispatch and uses more memory (because it
        # creates a closure).
        #
        # But sometimes the database might return columns with characters that are not
        # allowed in normal method names (like 'my_column(omg)'. So to work around this
        # we first define with the __temp__ identifier, and then use alias method to
        # rename it to what we want.
        def define_method_attribute(attr_name)
          cast_code = attribute_cast_code(attr_name)

          generated_attribute_methods.module_eval <<-STR, __FILE__, __LINE__ + 1
            def __temp__
              #{internal_attribute_access_code(attr_name, cast_code)}
            end
            alias_method '#{attr_name}', :__temp__
            undef_method :__temp__
          STR

          generated_external_attribute_methods.module_eval <<-STR, __FILE__, __LINE__ + 1
            def __temp__(v, attributes, attributes_cache, attr_name)
              #{external_attribute_access_code(attr_name, cast_code)}
            end
            alias_method '#{attr_name}', :__temp__
            undef_method :__temp__
          STR
        end

        private
        def cacheable_column?(column)
          attribute_types_cached_by_default.include?(column.type)
        end

        def internal_attribute_access_code(attr_name, cast_code)
          method = instance_cast_method(attr_name)

          if cache_attribute?(attr_name)
            "cached_cast_attribute('#{attr_name}', :#{method})"
          else
            "cast_attribute('#{attr_name}', :#{method})"
          end
        end

        def external_attribute_access_code(attr_name, cast_code)
          access_code = "v && #{cast_code}"

          if cache_attribute?(attr_name)
            access_code = "attributes_cache[attr_name] ||= (#{access_code})"
          end

          access_code
        end

        def attribute_cast_code(attr_name)
          columns_hash[attr_name].type_cast_code('v')
        end

        def instance_cast_method(attr_name)
          "cast_column"
        end
      end

      # Returns the value of the attribute identified by <tt>attr_name</tt> after it has been typecast (for example,
      # "2004-12-12" in a data column is cast to a date object, like Date.new(2004, 12, 12)).
      def read_attribute(attr_name)
        if @columns_hash.key? attr_name
          @columns_hash[attr_name].type_cast @attributes[attr_name]
        else
          self.class.type_cast_attribute(attr_name, @attributes, @attributes_cache)
        end
      end

      private

      def attribute_translator
        Attributes::Translator.new(@attributes, @columns_hash)
      end

      def cached_cast_attribute(attr_name, method)
        @attributes_cache[attr_name] ||= cast_attribute(attr_name, method)
      end

      def cast_attribute(attr_name, method)
        attribute_translator.cast_attribute(attr_name, method) do
          missing_attribute(attr_name, caller)
        end
      end

      def attribute(attribute_name)
        read_attribute(attribute_name)
      end
    end
  end
end