Class: ActiveRecord::Attribute

Inherits:
Object
  • Object
show all
Defined in:
activerecord/lib/active_record/attribute.rb,
activerecord/lib/active_record/attribute/user_provided_default.rb

Overview

:nodoc:

Direct Known Subclasses

Relation::QueryAttribute

Defined Under Namespace

Classes: UserProvidedDefault

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(name, value_before_type_cast, type, original_attribute = nil) ⇒ Attribute

This method should not be called directly. Use #from_database or #from_user


29
30
31
32
33
34
# File 'activerecord/lib/active_record/attribute.rb', line 29

def initialize(name, value_before_type_cast, type, original_attribute = nil)
  @name = name
  @value_before_type_cast = value_before_type_cast
  @type = type
  @original_attribute = original_attribute
end

Instance Attribute Details

#nameObject (readonly)

Returns the value of attribute name


25
26
27
# File 'activerecord/lib/active_record/attribute.rb', line 25

def name
  @name
end

#typeObject (readonly)

Returns the value of attribute type


25
26
27
# File 'activerecord/lib/active_record/attribute.rb', line 25

def type
  @type
end

#value_before_type_castObject (readonly)

Returns the value of attribute value_before_type_cast


25
26
27
# File 'activerecord/lib/active_record/attribute.rb', line 25

def value_before_type_cast
  @value_before_type_cast
end

Class Method Details

.from_database(name, value, type) ⇒ Object


4
5
6
# File 'activerecord/lib/active_record/attribute.rb', line 4

def from_database(name, value, type)
  FromDatabase.new(name, value, type)
end

.from_user(name, value, type, original_attribute = nil) ⇒ Object


8
9
10
# File 'activerecord/lib/active_record/attribute.rb', line 8

def from_user(name, value, type, original_attribute = nil)
  FromUser.new(name, value, type, original_attribute)
end

.null(name) ⇒ Object


16
17
18
# File 'activerecord/lib/active_record/attribute.rb', line 16

def null(name)
  Null.new(name)
end

.uninitialized(name, type) ⇒ Object


20
21
22
# File 'activerecord/lib/active_record/attribute.rb', line 20

def uninitialized(name, type)
  Uninitialized.new(name, type)
end

.with_cast_value(name, value, type) ⇒ Object


12
13
14
# File 'activerecord/lib/active_record/attribute.rb', line 12

def with_cast_value(name, value, type)
  WithCastValue.new(name, value, type)
end

Instance Method Details

#==(other) ⇒ Object Also known as: eql?


99
100
101
102
103
104
# File 'activerecord/lib/active_record/attribute.rb', line 99

def ==(other)
  self.class == other.class &&
    name == other.name &&
    value_before_type_cast == other.value_before_type_cast &&
    type == other.type
end

#came_from_user?Boolean

Returns:

  • (Boolean)

91
92
93
# File 'activerecord/lib/active_record/attribute.rb', line 91

def came_from_user?
  false
end

#changed?Boolean

Returns:

  • (Boolean)

54
55
56
# File 'activerecord/lib/active_record/attribute.rb', line 54

def changed?
  changed_from_assignment? || changed_in_place?
end

#changed_in_place?Boolean

Returns:

  • (Boolean)

58
59
60
# File 'activerecord/lib/active_record/attribute.rb', line 58

def changed_in_place?
  has_been_read? && type.changed_in_place?(original_value_for_database, value)
end

#forgetting_assignmentObject


62
63
64
# File 'activerecord/lib/active_record/attribute.rb', line 62

def forgetting_assignment
  with_value_from_database(value_for_database)
end

#has_been_read?Boolean

Returns:

  • (Boolean)

95
96
97
# File 'activerecord/lib/active_record/attribute.rb', line 95

def has_been_read?
  defined?(@value)
end

#hashObject


107
108
109
# File 'activerecord/lib/active_record/attribute.rb', line 107

def hash
  [self.class, name, value_before_type_cast, type].hash
end

#initialized?Boolean

Returns:

  • (Boolean)

87
88
89
# File 'activerecord/lib/active_record/attribute.rb', line 87

def initialized?
  true
end

#original_valueObject


42
43
44
45
46
47
48
# File 'activerecord/lib/active_record/attribute.rb', line 42

def original_value
  if assigned?
    original_attribute.original_value
  else
    type_cast(value_before_type_cast)
  end
end

#type_castObject

Raises:

  • (NotImplementedError)

83
84
85
# File 'activerecord/lib/active_record/attribute.rb', line 83

def type_cast(*)
  raise NotImplementedError
end

#valueObject


36
37
38
39
40
# File 'activerecord/lib/active_record/attribute.rb', line 36

def value  # `defined?` is cheaper than `||=` when we get back falsy values

  @value = type_cast(value_before_type_cast) unless defined?(@value)
  @value
end

#value_for_databaseObject


50
51
52
# File 'activerecord/lib/active_record/attribute.rb', line 50

def value_for_database
  type.serialize(value)
end

#with_cast_value(value) ⇒ Object


75
76
77
# File 'activerecord/lib/active_record/attribute.rb', line 75

def with_cast_value(value)
  self.class.with_cast_value(name, value, type)
end

#with_type(type) ⇒ Object


79
80
81
# File 'activerecord/lib/active_record/attribute.rb', line 79

def with_type(type)
  self.class.new(name, value_before_type_cast, type, original_attribute)
end

#with_value_from_database(value) ⇒ Object


71
72
73
# File 'activerecord/lib/active_record/attribute.rb', line 71

def with_value_from_database(value)
  self.class.from_database(name, value, type)
end

#with_value_from_user(value) ⇒ Object


66
67
68
69
# File 'activerecord/lib/active_record/attribute.rb', line 66

def with_value_from_user(value)
  type.assert_valid_value(value)
  self.class.from_user(name, value, type, original_attribute || self)
end