class OpenStruct

OpenStruct 是一种数据结构，类似于哈希表，允许定义任意属性及其对应的值。这是通过使用 Ruby 的元编程在类本身上定义方法来实现的。

示例¶ ↑

require "ostruct"

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

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

OpenStruct 内部使用哈希表来存储属性和值，甚至可以用哈希表进行初始化

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

带有空格或通常不能用于方法调用的字符（例如()[]*）的哈希键将不会立即在 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 方法实现的。

如果担心创建的对象的性能，这应该是一个考虑因素，因为与使用哈希表或结构体相比，设置这些属性的开销要大得多。从小型哈希表创建 open struct 并访问其中的几个条目可能比直接访问哈希表慢 200 倍。

这是一个潜在的安全问题；从不受信任的用户数据（例如 JSON Web 请求）构建 OpenStruct 可能会受到“符号拒绝服务”攻击的影响，因为键会创建方法，并且方法的名称永远不会被垃圾回收。

这也可能是 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 仅使用以 ! 结尾的 protected/private 方法，并通过添加 ! 为内置的公共方法定义别名

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

建议（但不是强制）不要使用以 ! 结尾的字段；请注意，子类的方法可能不会被覆盖，OpenStruct 自身以 ! 结尾的方法也不会被覆盖。

出于所有这些原因，请考虑完全不使用 OpenStruct。