класс ActiveRecord::Type::Value
Тип значения Active Model
Базовый класс для всех типов атрибутов. Этот класс также служит типом по умолчанию для атрибутов, которые не задают тип.
Атрибуты
Открытые методы класса
# File activemodel/lib/active_model/type/value.rb, line 17 def initialize(precision: nil, limit: nil, scale: nil) super() @precision = precision @scale = scale @limit = limit end
Инициализирует тип с тремя основными настройками: точность, ограничение и масштаб. Базовый класс Value не определяет поведение для этих настроек. Он использует их только для сравнения на равенство и генерации ключей хэша.
Открытые методы экземпляра
# File activemodel/lib/active_model/type/value.rb, line 121
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 144 def as_json(*) raise NoMethodError end
# File activemodel/lib/active_model/type/value.rb, line 133 def assert_valid_value(_) end
# File activemodel/lib/active_model/type/value.rb, line 57 def cast(value) cast_value(value) unless value.nil? end
Type преобразует значение из пользовательского ввода (например, из установщика). Это значение может быть строкой из генератора форм или объектом Ruby, переданным в установщик. В настоящее время нет способа различить, из какого источника оно пришло.
Значение, возвращаемое этим методом, будет возвращено из ActiveRecord::AttributeMethods::Read#read_attribute. Также см.: Value#cast_value.
value Исходные данные, предоставленные установщику атрибута.
# File activemodel/lib/active_model/type/value.rb, line 84 def changed?(old_value, new_value, _new_value_before_type_cast) old_value != new_value end
Определяет, изменилось ли значение для проверки состояния изменения. old_value и new_value всегда будут преобразованы к типу. Типы не должны переопределять этот метод.
# File activemodel/lib/active_model/type/value.rb, line 105 def changed_in_place?(raw_old_value, new_value) false end
Определяет, был ли изменён мутируемое значение с момента его чтения. По умолчанию возвращает false. Если ваш тип возвращает объект, который может быть изменён, вы должны переопределить этот метод. Вам нужно будет либо:
-
передать
new_valueвValue#serializeи сравнить его сraw_old_value
или
-
передать
raw_old_valueвValue#deserializeи сравнить его сnew_value
raw_old_value Исходное значение до передачи в deserialize.
new_value Текущее значение после преобразования к типу.
# File activemodel/lib/active_model/type/value.rb, line 43 def deserialize(value) cast(value) end
Преобразует значение из входных данных базы данных в соответствующий тип Ruby. Возвращаемое значение этого метода будет возвращено из ActiveRecord::AttributeMethods::Read#read_attribute. По умолчанию реализация просто вызывает Value#cast.
value Исходные данные, предоставленные из базы данных.
# File activemodel/lib/active_model/type/value.rb, line 129 def hash [self.class, precision, scale, limit].hash end
# File activemodel/lib/active_model/type/value.rb, line 28 def serializable?(value) true end
Возвращает true, если этот тип может преобразовать value в тип, пригодный для использования в базе данных. Например, тип boolean может вернуть true если значение параметра — Ruby boolean, но может вернуть false если значение параметра — какой-либо другой объект.
# File activemodel/lib/active_model/type/value.rb, line 65 def serialize(value) value end
Преобразует значение из типа Ruby в тип, который база данных понимает. Возвращаемое значение этого метода должно быть String, Numeric, Date, Time, Symbol, true, false, или nil.
# File activemodel/lib/active_model/type/value.rb, line 34 def type end
Возвращает уникальное имя типа в виде Symbol. Подклассы должны переопределить этот метод.
Закрытые методы экземпляра
# File activemodel/lib/active_model/type/value.rb, line 152 def cast_value(value) # :doc: value end
Удобный метод для типов, которым не нужно отдельное поведение преобразования типа для входных данных пользователя и базы данных. Вызывается методом Value#cast для значений, кроме nil.
© 2004–2021 David Heinemeier Hansson
Licensed under the MIT License.