Class: ActionKitApi::ApiDataModel

Inherits:
Object
  • Object
show all
Defined in:
lib/action_kit_api/data_model.rb

Direct Known Subclasses

Action, Event, EventCampaign, Page, User

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(hash = {}) ⇒ ApiDataModel

Returns a new instance of ApiDataModel.



11
12
13
14
15
16
17
18
 
# File 'lib/action_kit_api/data_model.rb', line 11

def initialize(hash = {})
  @required_attrs ||= []

  @read_only_attrs ||= []
  @read_only_attrs.concat([:created_at, :updated_at])

  self.update(hash)
end

Instance Attribute Details

#created_at ⇒ Object

All the different types of objects have at least these



9
10
11
 
# File 'lib/action_kit_api/data_model.rb', line 9

def created_at
  @created_at
end

#updated_at ⇒ Object

All the different types of objects have at least these



9
10
11
 
# File 'lib/action_kit_api/data_model.rb', line 9

def updated_at
  @updated_at
end

Instance Method Details

#safe_hash ⇒ Object 



104
105
106
107
108
109
110
111
 
# File 'lib/action_kit_api/data_model.rb', line 104

def safe_hash
  attrs_hash = self.to_hash
  attrs_hash.delete_if do |k, v| 
    @read_only_attrs.include?(k)
  end

  attrs_hash
end

#save ⇒ Object

Raises:



20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
 
# File 'lib/action_kit_api/data_model.rb', line 20

def save

  class_name = self.class.to_s.split("::").last

  raise MissingRequiredAttributeException unless self.valid?

  if self.id.nil?
    if self.respond_to?('before_create')
      self.send('before_create')
    end
    
    call = "#{class_name}.create"
    response = ActionKitApi.connection.call(call, self.safe_hash)
    
    if self.respond_to?('after_create')
      self.send('after_create')
    end
  else
    if self.respond_to?('before_save')
      self.send('before_save')
    end
    
    call = "#{class_name}.save_or_create"
    response = ActionKitApi.connection.call(call, self.safe_hash)
    
    if self.respond_to?('after_save')
      self.send('after_save')
    end
  end


  # Update ourselves to include the data that the server populated 
  self.update(response)
  

  self
end

#to_hash ⇒ Object 



85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
 
# File 'lib/action_kit_api/data_model.rb', line 85

def to_hash
  user_hash = {}

  self.instance_variables.each do |iv|
    key = iv.to_s.delete("@").to_sym

    next if key == :required_attrs
    next if key == :read_only_attrs
    user_hash[key] = self.instance_variable_get(iv)
  end

  # XMLRPC::Client doesn't like empty values
  user_hash.delete_if do |k, v|
    v.to_s.empty? || v.nil?
  end

  user_hash
end

#update(hash = {}) ⇒ Object

Updates all the instance variables in our local object with the values in the hash. This will selectively update only the keys in the hash that is passed, and will not update/add non-existant attributes



62
63
64
65
66
67
68
69
70
71
72
73
74
75
 
# File 'lib/action_kit_api/data_model.rb', line 62

def update(hash = {})
  hash.each do |k,v|
    # The name of the setter for the value of k
    setter = "#{k}="

    # Check if there is a matching setter
    if self.respond_to?(setter)
      # Yes, there is. Call the setter with the value
      self.send(setter, v)
    end
  end

  self
end

#valid? ⇒ Boolean

Returns:

  • (Boolean) 


77
78
79
80
81
82
83
 
# File 'lib/action_kit_api/data_model.rb', line 77

def valid?
  @required_attrs.each do |k|
    return false if self.send(k).nil?
  end

  true
end