Class: ActionWebService::Struct

Inherits:
Object
  • Object
show all
Defined in:
lib/action_web_service/struct.rb

Overview

To send structured types across the wire, derive from ActionWebService::Struct, and use member to declare structure members.

ActionWebService::Struct should be used in method signatures when you want to accept or return structured types that have no Active Record model class representations, or you don’t want to expose your entire Active Record model to remote callers.

Example

class Person < ActionWebService::Struct
  member :id,         :int
  member :firstnames, [:string]
  member :lastname,   :string
  member :email,      :string
end
person = Person.new(:id => 5, :firstname => 'john', :lastname => 'doe')

Active Record model classes are already implicitly supported in method signatures.

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(values = {}) ⇒ Struct

If a Hash is given as argument to an ActionWebService::Struct constructor, it can contain initial values for the structure member.



24
25
26
27
28
29
30
# File 'lib/action_web_service/struct.rb', line 24

def initialize(values={})
  if values.is_a?(Hash)
    values.map do |k,v| 
      __send__('%s=' % k.to_s, v)
    end
  end
end

Class Method Details

.member(name, type) ⇒ Object

Creates a structure member with the specified name and type. Generates accessor methods for reading and writing the member value.



47
48
49
50
51
52
53
54
55
56
57
# File 'lib/action_web_service/struct.rb', line 47

def member(name, type)
  name = name.to_sym
  type = ActionWebService::SignatureTypes.canonical_signature_entry({ name => type }, 0)
  write_inheritable_hash("struct_members", name => type)
  class_eval <<-END
    def #{name}; @#{name}; end
    def #{name}=(value)
      @#{name} = value;
    end
  END
end

.member_type(name) ⇒ Object

:nodoc:



63
64
65
# File 'lib/action_web_service/struct.rb', line 63

def member_type(name) # :nodoc:
  members[name.to_sym]
end

.membersObject

:nodoc:



59
60
61
# File 'lib/action_web_service/struct.rb', line 59

def members # :nodoc:
  read_inheritable_attribute("struct_members") || {}
end

Instance Method Details

#[](name) ⇒ Object

The member with the given name



33
34
35
# File 'lib/action_web_service/struct.rb', line 33

def [](name)
  send(name.to_s)
end

#each_pair(&block) ⇒ Object

Iterates through each member



38
39
40
41
42
# File 'lib/action_web_service/struct.rb', line 38

def each_pair(&block)
  self.class.members.each do |name, type|
    yield name, self.__send__(name)
  end
end