класс OpenStruct

Структура данных OpenStruct, похожая на Hash, позволяет определять произвольные атрибуты со значениями. Это достигается использованием метапрограммирования Ruby для определения методов самого класса.

Примеры

require "ostruct"

person = OpenStruct.new
person.name = "John Smith"
person.age  = 70

person.name      # => "John Smith"
person.age       # => 70
person.address   # => nil

Объект OpenStruct использует Hash внутри для хранения атрибутов и значений и может быть инициализирован с помощью него:

australia = OpenStruct.new(:country => "Australia", :capital => "Canberra")
  # => #<OpenStruct country="Australia", capital="Canberra">

Ключи Hash с пробелами или символами, которые обычно не могут быть использованы для вызовов методов (например, ()[]*), не будут немедленно доступны в виде методов для получения или присвоения значений для объекта OpenStruct, но всё равно могут быть доступны через метод Object#send или с помощью [].

measurements = OpenStruct.new("length (in inches)" => 24)
measurements[:"length (in inches)"]       # => 24
measurements.send("length (in inches)")   # => 24

message = OpenStruct.new(:queued? => true)
message.queued?                           # => true
message.send("queued?=", false)
message.queued?                           # => false

Для удаления атрибута необходимо выполнить метод delete_field, так как установка значения свойства в nil не удалит атрибут.

first_pet  = OpenStruct.new(:name => "Rowdy", :owner => "John Smith")
second_pet = OpenStruct.new(:name => "Rowdy")

first_pet.owner = nil
first_pet                 # => #<OpenStruct name="Rowdy", owner=nil>
first_pet == second_pet   # => false

first_pet.delete_field(:owner)
first_pet                 # => #<OpenStruct name="Rowdy">
first_pet == second_pet   # => true

Совместимость с Ractor: Замороженный OpenStruct с общими значениями сам по себе является общим.

Ограничения

Объект OpenStruct использует структуру поиска методов Ruby для поиска и определения необходимых методов для свойств. Это достигается с помощью методов `method_missing` и `define_singleton_method`.

Это следует учитывать, если есть опасения по поводу производительности создаваемых объектов, так как при настройке этих свойств гораздо больше накладных расходов по сравнению с использованием Hash или Struct. Создание открытой структуры из небольшого Hash и доступ к нескольким записям может быть в 200 раз медленнее, чем прямой доступ к хэшу.

Это потенциальная проблема безопасности; создание OpenStruct из недоверенных данных пользователя (например, JSON веб-запроса) может быть уязвимо для атаки «отказа в обслуживании» символов, так как ключи создают методы, а имена методов никогда не удаляются из памяти.

Это также может быть причиной несовместимости между версиями Ruby:

o = OpenStruct.new
o.then # => nil in Ruby < 2.6, enumerator for Ruby >= 2.6

Встроенные методы могут быть перезаписаны таким образом, что это может стать источником ошибок или проблем с безопасностью:

o = OpenStruct.new
o.methods # => [:to_h, :marshal_load, :marshal_dump, :each_pair, ...
o.methods = [:foo, :bar]
o.methods # => [:foo, :bar]

Для устранения конфликтов, OpenStruct использует только защищённые/приватные методы, оканчивающиеся на ! , и определяет псевдонимы для встроенных публичных методов, добавляя !:

o = OpenStruct.new(make: 'Bentley', class: :luxury)
o.class # => :luxury
o.class! # => OpenStruct

Рекомендуется (но не принудительно) не использовать поля, заканчивающиеся на !; Обратите внимание, что методы подкласса не могут быть перезаписаны, а также методы самого OpenStruct, заканчивающиеся на !.

По всем этим причинам, рассмотрите возможность полного отказа от использования OpenStruct.