primary_key.rb 3.4 KB
Newer Older
1 2 3 4 5
module ActiveRecord
  module AttributeMethods
    module PrimaryKey
      extend ActiveSupport::Concern

6
      # Returns this record's primary key value wrapped in an Array if one is available
7
      def to_key
8
        key = self.id
9
        [key] if key
10 11
      end

12 13 14 15 16 17 18 19 20 21 22 23 24 25 26
      # Returns the primary key value
      def id
        read_attribute(self.class.primary_key)
      end

      # Sets the primary key value
      def id=(value)
        write_attribute(self.class.primary_key, value)
      end

      # Queries the primary key value
      def id?
        query_attribute(self.class.primary_key)
      end

27 28 29 30 31 32
      protected

      def attribute_method?(attr_name)
        attr_name == 'id' || super
      end

33
      module ClassMethods
34 35 36 37 38
        def define_method_attribute(attr_name)
          super

          if attr_name == primary_key && attr_name != 'id'
            generated_attribute_methods.send(:alias_method, :id, primary_key)
39 40
            generated_external_attribute_methods.module_eval <<-CODE, __FILE__, __LINE__
              def id(v, attributes, attributes_cache, attr_name)
41
                attr_name = '#{primary_key}'
42
                send(attr_name, attributes[attr_name], attributes, attributes_cache, attr_name)
43 44 45 46 47
              end
            CODE
          end
        end

48
        def dangerous_attribute_method?(method_name)
49
          super && !['id', 'id=', 'id?'].include?(method_name)
50 51
        end

52
        # Defines the primary key field -- can be overridden in subclasses. Overwriting will negate any effect of the
53 54
        # primary_key_prefix_type setting, though. Since primary keys are usually protected from mass assignment,
        # remember to let your database generate them or include the key in +attr_accessible+.
55
        def primary_key
56 57
          @primary_key = reset_primary_key unless defined? @primary_key
          @primary_key
58 59
        end

60 61 62 63 64
        # Returns a quoted version of the primary key name, used to construct SQL statements.
        def quoted_primary_key
          @quoted_primary_key ||= connection.quote_column_name(primary_key)
        end

65
        def reset_primary_key #:nodoc:
66 67 68 69 70
          if self == base_class
            self.primary_key = get_primary_key(base_class.name)
          else
            self.primary_key = base_class.primary_key
          end
71 72 73
        end

        def get_primary_key(base_name) #:nodoc:
74
          return 'id' unless base_name && !base_name.blank?
75

76
          case primary_key_prefix_type
A
Aaron Patterson 已提交
77
          when :table_name
78
            base_name.foreign_key(false)
A
Aaron Patterson 已提交
79
          when :table_name_with_underscore
80
            base_name.foreign_key
A
Aaron Patterson 已提交
81
          else
82
            if ActiveRecord::Base != self && table_exists?
83
              connection.schema_cache.primary_keys[table_name]
84 85 86
            else
              'id'
            end
87 88 89
          end
        end

90
        # Sets the name of the primary key column.
91 92
        #
        #   class Project < ActiveRecord::Base
93
        #     self.primary_key = "sysid"
94
        #   end
95 96 97 98 99 100 101 102 103 104 105 106 107 108
        #
        # You can also define the primary_key method yourself:
        #
        #   class Project < ActiveRecord::Base
        #     def self.primary_key
        #       "foo_" + super
        #     end
        #   end
        #   Project.primary_key # => "foo_id"
        def primary_key=(value)
          @original_primary_key = @primary_key if defined?(@primary_key)
          @primary_key          = value && value.to_s
          @quoted_primary_key   = nil
        end
109 110 111 112
      end
    end
  end
end