модуль ActiveRecord::Store
Хранилище предоставляет тонкий обертка вокруг serialize для хранения хэшей в одном столбце. Это как простое хранилище ключ/значение, встроенное в вашу запись, когда вам не нужно иметь возможность запросить это хранилище за пределами контекста одной записи.
Затем вы можете объявить аксессоры к этому хранилищу, которые будут доступны, как и любой другой атрибут модели. Это очень полезно для удобного отображения ключей хранилища в форме или в другом месте, которое уже построено вокруг доступа к атрибутам модели.
Убедитесь, что вы объявили столбец базы данных, используемый для сериализованного хранилища, как текстовый, чтобы было достаточно места.
Вы можете установить пользовательский кодер для кодирования/декодирования ваших сериализованных атрибутов в разные форматы. JSON, YAML, Marshal поддерживаются по умолчанию. В целом, это может быть любой обертка, который предоставляет load и dump.
ПРИМЕЧАНИЕ: Если вы используете специфичные для PostgreSQL столбцы, такие как hstore или json, нет необходимости в сериализации, предоставляемой .store. Просто используйте .store_accessor вместо этого, чтобы сгенерировать методы аксессора. Имейте в виду, что эти столбцы используют хэш с ключами типа строка и не позволяют доступа с использованием символа.
ПРИМЕЧАНИЕ: Валидации по умолчанию, за исключением uniqueness, будут работать. Например, если вы хотите проверить uniqueness с помощью hstore, вам потребуется использовать пользовательскую валидацию для этого.
Примеры:
class User < ActiveRecord::Base store :settings, accessors: [ :color, :homepage ], coder: JSON end u = User.new(color: 'black', homepage: '37signals.com') u.color # Accessor stored attribute u.settings[:country] = 'Denmark' # Any attribute, even if not specified with an accessor # There is no difference between strings and symbols for accessing custom attributes u.settings[:country] # => 'Denmark' u.settings['country'] # => 'Denmark' # Add additional accessors to an existing store through store_accessor class SuperUser < User store_accessor :settings, :privileges, :servants end
Имена хранимых атрибутов можно получить с помощью .stored_attributes.
User.stored_attributes[:settings] # [:color, :homepage]
Переопределение аксессоров по умолчанию
Все сохранённые значения автоматически доступны через аксессоры объекта Active Record, но иногда вам нужно специализировать это поведение. Это можно сделать, переопределив аксессоры по умолчанию (используя то же имя, что и у атрибута) и вызвав super для фактического изменения.
class Song < ActiveRecord::Base
# Uses a stored integer to hold the volume adjustment of the song
store :settings, accessors: [:volume_adjustment]
def volume_adjustment=(decibels)
super(decibels.to_i)
end
def volume_adjustment
super.to_i
end
end
Атрибуты
Закрытые методы экземпляра
# File activerecord/lib/active_record/store.rb, line 125 def read_store_attribute(store_attribute, key) # :doc: accessor = store_accessor_for(store_attribute) accessor.read(self, store_attribute, key) end
# File activerecord/lib/active_record/store.rb, line 130 def write_store_attribute(store_attribute, key, value) # :doc: accessor = store_accessor_for(store_attribute) accessor.write(self, store_attribute, key, value) end
© 2004–2018 David Heinemeier Hansson
Licensed under the MIT License.