# File activemodel/lib/active_model/type/value.rb, line 8 def initialize(precision: nil, limit: nil, scale: nil) @precision = precision @scale = scale @limit = limit end
# File activemodel/lib/active_model/type/value.rb, line 109 def ==(other) self.class == other.class && precision == other.precision && scale == other.scale && limit == other.limit end
# File activemodel/lib/active_model/type/value.rb, line 121 def assert_valid_value(_) end
# File activemodel/lib/active_model/type/value.rb, line 45 def cast(value) cast_value(value) unless value.nil? end
Type
casts a value from user input (e.g. from a setter). This value may be a string from the form builder, or a ruby object passed to a setter. There is currently no way to differentiate between which source it came from.
The return value of this method will be returned from ActiveRecord::AttributeMethods::Read#read_attribute
. See also: Value#cast_value
.
value
The raw input, as provided to the attribute setter.
# File activemodel/lib/active_model/type/value.rb, line 72 def changed?(old_value, new_value, _new_value_before_type_cast) old_value != new_value end
Determines whether a value has changed for dirty checking. old_value
and new_value
will always be type-cast. Types should not need to override this method.
# File activemodel/lib/active_model/type/value.rb, line 93 def changed_in_place?(raw_old_value, new_value) false end
Determines whether the mutable value has been modified since it was read. Returns false
by default. If your type returns an object which could be mutated, you should override this method. You will need to either:
pass new_value
to Value#serialize
and compare it to raw_old_value
or
pass raw_old_value
to Value#deserialize
and compare it to new_value
raw_old_value
The original value, before being passed to deserialize
.
new_value
The current value, after type casting.
# File activemodel/lib/active_model/type/value.rb, line 31 def deserialize(value) cast(value) end
Converts a value from database input to the appropriate ruby type. The return value of this method will be returned from ActiveRecord::AttributeMethods::Read#read_attribute
. The default implementation just calls Value#cast
.
value
The raw input, as provided from the database.
# File activemodel/lib/active_model/type/value.rb, line 117 def hash [self.class, precision, scale, limit].hash end
# File activemodel/lib/active_model/type/value.rb, line 18 def serializable?(value) true end
Returns true if this type can convert value
to a type that is usable by the database. For example a boolean type can return true
if the value parameter is a Ruby boolean, but may return false
if the value parameter is some other object.
# File activemodel/lib/active_model/type/value.rb, line 53 def serialize(value) value end
Casts a value from the ruby type to a type that the database knows how to understand. The returned value from this method should be a String
, Numeric
, Date
, Time
, Symbol
, true
, false
, or nil
.
# File activemodel/lib/active_model/type/value.rb, line 128 def cast_value(value) # :doc: value end
Convenience method for types which do not need separate type casting behavior for user and database inputs. Called by Value#cast
for values except nil
.
© 2004–2021 David Heinemeier Hansson
Licensed under the MIT License.