Class: AppDirect::AppDirectObject

Inherits:
Object
  • Object
show all
Includes:
Enumerable
Defined in:
lib/appdirect/appdirect_object.rb

Direct Known Subclasses

Event

Constant Summary collapse

@@permanent_attributes = 
Set.new([:consumer_key, :secret, :id])

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(id = nil, consumer_key = nil, secret = nil) ⇒ AppDirectObject

Returns a new instance of AppDirectObject.



13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
 
# File 'lib/appdirect/appdirect_object.rb', line 13

def initialize(id=nil, consumer_key=nil, secret=nil)
  
  # parameter overloading!
  if id.kind_of?(Hash)
    @retrieve_options = id.dup
    @retrieve_options.delete(:id)
    id = id[:id]
  else
    @retrieve_options = {}
  end

  @consumer_key = consumer_key
  @secret = secret
  @values = {}
  # This really belongs in APIResource, but not putting it there allows us
  # to have a unified inspect method
  @unsaved_values = Set.new
  @transient_values = Set.new
  @values[:id] = id if id
end

Dynamic Method Handling

This class handles dynamic methods through the method_missing method

#method_missing(name, *args) ⇒ Object (protected) 



163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
 
# File 'lib/appdirect/appdirect_object.rb', line 163

def method_missing(name, *args)
  # TODO: only allow setting in updateable classes.
  if name.to_s.end_with?('=')
    attr = name.to_s[0...-1].to_sym
    add_accessors([attr])
    begin
      mth = method(name)
    rescue NameError
      raise NoMethodError.new("Cannot set #{attr} on this object. HINT: you can't set: #{@@permanent_attributes.to_a.join(', ')}")
    end
    return mth.call(args[0])
  else
    return @values[name] if @values.has_key?(name)
  end

  begin
    super
  rescue NoMethodError => e
    if @transient_values.include?(name)
      raise NoMethodError.new(e.message + ".  HINT: The '#{name}' attribute was set in the past, however.  It was then wiped when refreshing the object with the result returned by AppDirect's API, probably as a result of a save().  The attributes currently available on this object are: #{@values.keys.join(', ')}")
    else
      raise
    end
  end
end

Instance Attribute Details

#consumer_key ⇒ Object

Returns the value of attribute consumer_key.



5
6
7
 
# File 'lib/appdirect/appdirect_object.rb', line 5

def consumer_key
  @consumer_key
end

#secret ⇒ Object

Returns the value of attribute secret.



5
6
7
 
# File 'lib/appdirect/appdirect_object.rb', line 5

def secret
  @secret
end

Class Method Details

._load(args) ⇒ Object 



115
116
117
118
 
# File 'lib/appdirect/appdirect_object.rb', line 115

def self._load(args)
  values, api_key = Marshal.load(args)
  construct_from(values, consumer_key, secret)
end

.construct_from(values, consumer_key = nil, secret = nil) ⇒ Object 



34
35
36
37
38
 
# File 'lib/appdirect/appdirect_object.rb', line 34

def self.construct_from(values, consumer_key=nil, secret=nil)
  obj = self.new(values[:id], consumer_key, secret)
  obj.refresh_from(values, consumer_key, secret)
  obj
end

Instance Method Details

#[](k) ⇒ Object 



76
77
78
 
# File 'lib/appdirect/appdirect_object.rb', line 76

def [](k)
  @values[k.to_sym]
end

#[]=(k, v) ⇒ Object 



80
81
82
 
# File 'lib/appdirect/appdirect_object.rb', line 80

def []=(k, v)
  send(:"#{k}=", v)
end

#_dump(level) ⇒ Object 



111
112
113
 
# File 'lib/appdirect/appdirect_object.rb', line 111

def _dump(level)
  Marshal.dump([@values, @consumer_key, @secret])
end

#as_json(*a) ⇒ Object 



96
97
98
 
# File 'lib/appdirect/appdirect_object.rb', line 96

def as_json(*a)
  @values.as_json(*a)
end

#each(&blk) ⇒ Object 



107
108
109
 
# File 'lib/appdirect/appdirect_object.rb', line 107

def each(&blk)
  @values.each(&blk)
end

#inspect ⇒ Object 



44
45
46
47
 
# File 'lib/appdirect/appdirect_object.rb', line 44

def inspect()
  id_string = (self.respond_to?(:id) && !self.id.nil?) ? " id=#{self.id}" : ""
  "#<#{self.class}:0x#{self.object_id.to_s(16)}#{id_string}> JSON: " + JSON.pretty_generate(@values)
end

#keys ⇒ Object 



84
85
86
 
# File 'lib/appdirect/appdirect_object.rb', line 84

def keys
  @values.keys
end

#refresh_from(values, consumer_key, secret, partial = false) ⇒ Object 



49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
 
# File 'lib/appdirect/appdirect_object.rb', line 49

def refresh_from(values, consumer_key, secret, partial=false)
  @consumer_key = consumer_key
  @secret = secret

  @previous_metadata = values[:metadata]
  removed = partial ? Set.new : Set.new(@values.keys - values.keys)
  added = Set.new(values.keys - @values.keys)
  # Wipe old state before setting new.  This is useful for e.g. updating a
  # customer, where there is no persistent card parameter.  Mark those values
  # which don't persist as transient

  instance_eval do
    remove_accessors(removed)
    add_accessors(added)
  end
  removed.each do |k|
    @values.delete(k)
    @transient_values.add(k)
    @unsaved_values.delete(k)
  end
  values.each do |k, v|
    @values[k] = Util.convert_to_appdirect_object(v, consumer_key, secret)
    @transient_values.delete(k)
    @unsaved_values.delete(k)
  end
end

#respond_to?(symbol) ⇒ Boolean

Returns:

  • (Boolean) 


121
122
123
 
# File 'lib/appdirect/appdirect_object.rb', line 121

def respond_to?(symbol)
  @values.has_key?(symbol) || super
end

#to_hash ⇒ Object 



100
101
102
103
104
105
 
# File 'lib/appdirect/appdirect_object.rb', line 100

def to_hash
  @values.inject({}) do |acc, (key, value)|
    acc[key] = value.respond_to?(:to_hash) ? value.to_hash : value
    acc
  end
end

#to_json(*a) ⇒ Object 



92
93
94
 
# File 'lib/appdirect/appdirect_object.rb', line 92

def to_json(*a)
  JSON.generate(@values)
end

#to_s(*args) ⇒ Object 



40
41
42
 
# File 'lib/appdirect/appdirect_object.rb', line 40

def to_s(*args)
  JSON.pretty_generate(@values)
end

#values ⇒ Object 



88
89
90
 
# File 'lib/appdirect/appdirect_object.rb', line 88

def values
  @values.values
end