W3cubDocs

/Ruby on Rails 7.0

class ActiveRecord::Type::Value

Parent:
Object

Attributes

limit[R]
precision[R]
scale[R]

Public Class Methods

new(precision: nil, limit: nil, scale: nil) Show source
# 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

Public Instance Methods

==(other) Show source
# 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
Also aliased as: eql?
assert_valid_value(_) Show source
# File activemodel/lib/active_model/type/value.rb, line 121
def assert_valid_value(_)
end
cast(value) Show source
# 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.

changed?(old_value, new_value, _new_value_before_type_cast) Show source
# 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.

changed_in_place?(raw_old_value, new_value) Show source
# 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:

or

raw_old_value The original value, before being passed to deserialize.

new_value The current value, after type casting.

deserialize(value) Show source
# 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.

eql?(other)
Alias for: ==
hash() Show source
# File activemodel/lib/active_model/type/value.rb, line 117
def hash
  [self.class, precision, scale, limit].hash
end
serializable?(value) Show source
# 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.

serialize(value) Show source
# 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.

Private Instance Methods

cast_value(value) Show source
# 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.