класс 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.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
Реализация
OpenStruct использует структуру поиска методов Ruby для поиска и определения необходимых методов для свойств. Это достигается с помощью методов method_missing и define_singleton_method.
Это следует учитывать, если есть опасения по поводу производительности создаваемых объектов, так как при установке этих свойств гораздо больше накладных расходов по сравнению с использованием Хэша или Структуры.
Публичные методы класса
# File lib/ostruct.rb, line 90
def initialize(hash=nil)
@table = {}
if hash
hash.each_pair do |k, v|
k = k.to_sym
@table[k] = v
end
end
end Создаёт новый объект OpenStruct. По умолчанию, создаваемый объект OpenStruct не будет иметь атрибутов.
Необязательный параметр hash, если задан, сгенерирует атрибуты и значения (может быть Хэшем, OpenStruct или Структурой). Например:
require "ostruct"
hash = { "country" => "Australia", :capital => "Canberra" }
data = OpenStruct.new(hash)
data # => #<OpenStruct country="Australia", capital="Canberra">
Методы публичного экземпляра
# File lib/ostruct.rb, line 346 def ==(other) return false unless other.kind_of?(OpenStruct) @table == other.table! end
Сравнивает этот объект и other на равенство. Объект OpenStruct равен other, когда other является объектом OpenStruct, и таблицы хешей двух объектов равны.
require "ostruct"
first_pet = OpenStruct.new("name" => "Rowdy")
second_pet = OpenStruct.new(:name => "Rowdy")
third_pet = OpenStruct.new("name" => "Rowdy", :age => nil)
first_pet == second_pet # => true
first_pet == third_pet # => false
# File lib/ostruct.rb, line 226 def [](name) @table[name.to_sym] end
Возвращает значение атрибута.
require "ostruct"
person = OpenStruct.new("name" => "John Smith", "age" => 70)
person[:age] # => 70, same as person.age
# File lib/ostruct.rb, line 241 def []=(name, value) modifiable?[new_ostruct_member!(name)] = value end
Устанавливает значение атрибута.
require "ostruct"
person = OpenStruct.new("name" => "John Smith", "age" => 70)
person[:age] = 42 # equivalent to person.age = 42
person.age # => 42
# File ext/json/lib/json/add/ostruct.rb, line 17
def as_json(*)
klass = self.class.name
klass.to_s.empty? and raise JSON::JSONError, "Only named structs are supported!"
{
JSON.create_id => klass,
't' => table,
}
end Возвращает хеш, который будет преобразован в объект JSON и представит этот объект.
# File lib/ostruct.rb, line 290
def delete_field(name)
sym = name.to_sym
begin
singleton_class.__send__(:remove_method, sym, "#{sym}=")
rescue NameError
end
@table.delete(sym) do
raise NameError.new("no field `#{sym}' in #{self}", sym)
end
end Удаляет поле с заданным именем из объекта. Возвращает значение, содержащееся в поле, если оно было определено.
require "ostruct"
person = OpenStruct.new(name: "John", age: 70, pension: 300)
person.delete_field("age") # => 70
person # => #<OpenStruct name="John", pension=300>
Установление значения в nil не удалит атрибут:
person.pension = nil person # => #<OpenStruct name="John", pension=nil>
# File lib/ostruct.rb, line 265
def dig(name, *names)
begin
name = name.to_sym
rescue NoMethodError
raise TypeError, "#{name} is not a symbol nor a string"
end
@table.dig(name, *names)
end Извлекает вложенное значение, указанное последовательностью name объектов, вызывая dig на каждом шаге, возвращая nil, если любой промежуточный шаг nil.
require "ostruct"
address = OpenStruct.new("city" => "Anytown NC", "zip" => 12345)
person = OpenStruct.new("name" => "John Smith", "address" => address)
person.dig(:address, "zip") # => 12345
person.dig(:business_address, "zip") # => nil
data = OpenStruct.new(:array => [1, [2, 3]])
data.dig(:array, 1, 0) # => 2
data.dig(:array, 0, 0) # TypeError: Integer does not have #dig method
# File lib/ostruct.rb, line 130
def each_pair
return to_enum(__method__) { @table.size } unless block_given?
@table.each_pair{|p| yield p}
self
end Выводит все атрибуты (как символы) вместе с соответствующими значениями или возвращает перечислитель, если блок не указан.
require "ostruct"
data = OpenStruct.new("country" => "Australia", :capital => "Canberra")
data.each_pair.to_a # => [[:country, "Australia"], [:capital, "Canberra"]]
# File lib/ostruct.rb, line 356 def eql?(other) return false unless other.kind_of?(OpenStruct) @table.eql?(other.table!) end
Сравнивает этот объект и other на равенство. Объект OpenStruct равен other, когда other является объектом OpenStruct, и таблицы хешей двух объектов равны.
# File lib/ostruct.rb, line 187
def freeze
@table.each_key {|key| new_ostruct_member!(key)}
super
end # File lib/ostruct.rb, line 366 def hash @table.hash end
Вычисляет код хеша для этого объекта OpenStruct. Два объекта OpenStruct с одинаковым содержимым будут иметь одинаковый код хеша (и будут сравниваться с помощью eql?).
См. также Object#hash.
# File lib/ostruct.rb, line 306
def inspect
str = "#<#{self.class}"
ids = (Thread.current[InspectKey] ||= [])
if ids.include?(object_id)
return str << ' ...>'
end
ids << object_id
begin
first = true
for k,v in @table
str << "," unless first
first = false
str << " #{k}=#{v.inspect}"
end
return str << '>'
ensure
ids.pop
end
end Возвращает строку, содержащую подробное описание ключей и значений.
# File lib/ostruct.rb, line 139 def marshal_dump @table end
Обеспечивает поддержку маршаллирования для использования библиотекой Marshal.
# File lib/ostruct.rb, line 146 def marshal_load(x) @table = x end
Обеспечивает поддержку маршаллирования для использования библиотекой Marshal.
# File lib/ostruct.rb, line 114 def to_h @table.dup end
Преобразует OpenStruct в хеш, где ключи представляют каждое атрибут (в виде символов) и их соответствующие значения.
require "ostruct"
data = OpenStruct.new("country" => "Australia", :capital => "Canberra")
data.to_h # => {:country => "Australia", :capital => "Canberra" }
# File ext/json/lib/json/add/ostruct.rb, line 28 def to_json(*args) as_json.to_json(*args) end
Хранит имя класса (OpenStruct) вместе со значениями этой структуры v в виде строки JSON.
Ruby Core © 1993–2017 Yukihiro Matsumoto
Licensed under the Ruby License.
Ruby Standard Library © contributors
Licensed under their own licenses.