Class: ActiveRestClient::Base

Inherits:
Object
  • Object
show all
Includes:
Caching, Configuration, Mapping, Recording, RequestFiltering, Validation
Defined in:
lib/active_rest_client/base.rb

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Methods included from Recording

included

Methods included from Caching

included

Methods included from Validation

#_errors, included, #valid?

Methods included from RequestFiltering

included

Methods included from Configuration

included

Methods included from Mapping

included

Constructor Details

#initialize(attrs = {}) ⇒ Base

Returns a new instance of Base.

Raises:

  • (Exception)


19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
# File 'lib/active_rest_client/base.rb', line 19

def initialize(attrs={})
  @attributes = {}
  @dirty_attributes = Set.new

  raise Exception.new("Cannot instantiate Base class") if self.class.name == "ActiveRestClient::Base"

  attrs.each do |attribute_name, attribute_value|
    attribute_name = attribute_name.to_sym
    if attribute_value.to_s[/^([\+-]?\d{4}(?!\d{2}\b))((-?)((0[1-9]|1[0-2])(\3([12]\d|0[1-9]|3[01]))?|W([0-4]\d|5[0-2])(-?[1-7])?|(00[1-9]|0[1-9]\d|[12]\d{2}|3([0-5]\d|6[1-6]))))$/]
      @attributes[attribute_name] = Date.parse(attribute_value)
    elsif attribute_value.to_s[/^([\+-]?\d{4}(?!\d{2}\b))((-?)((0[1-9]|1[0-2])(\3([12]\d|0[1-9]|3[01]))?|W([0-4]\d|5[0-2])(-?[1-7])?|(00[1-9]|0[1-9]\d|[12]\d{2}|3([0-5]\d|6[1-6])))([T\s]((([01]\d|2[0-3])((:?)[0-5]\d)?|24\:?00)([\.,]\d+(?!:))?)?(\17[0-5]\d([\.,]\d+)?)?([zZ]|([\+-])([01]\d|2[0-3]):?([0-5]\d)?)?)?)?$/]
      @attributes[attribute_name] = DateTime.parse(attribute_value)
    else
      @attributes[attribute_name] = attribute_value
    end
    @dirty_attributes << attribute_name
  end
end

Dynamic Method Handling

This class handles dynamic methods through the method_missing method

#method_missing(name, *args) ⇒ Object



120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
# File 'lib/active_rest_client/base.rb', line 120

def method_missing(name, *args)
  if name.to_s[-1,1] == "="
    name = name.to_s.chop.to_sym
    @attributes[name] = args.first
    @dirty_attributes << name
  else
    name_sym = name.to_sym
    name = name.to_s

    if @attributes.has_key? name_sym
      @attributes[name_sym]
    else
      if name[/^lazy_/] && mapped = self.class._mapped_method(name_sym)
        raise ValidationFailedException.new unless valid?
        request = Request.new(mapped, self, args.first)
        ActiveRestClient::LazyLoader.new(request)
      elsif mapped = self.class._mapped_method(name_sym)
        raise ValidationFailedException.new unless valid?
        request = Request.new(mapped, self, args.first)
        request.call
      elsif self.class.whiny_missing
        raise NoAttributeException.new("Missing attribute #{name_sym}")
      else
        nil
      end
    end
  end
end

Instance Attribute Details

#_etagObject

Returns the value of attribute _etag.



11
12
13
# File 'lib/active_rest_client/base.rb', line 11

def _etag
  @_etag
end

#_headersObject

Returns the value of attribute _headers.



12
13
14
# File 'lib/active_rest_client/base.rb', line 12

def _headers
  @_headers
end

#_statusObject

Returns the value of attribute _status.



10
11
12
# File 'lib/active_rest_client/base.rb', line 10

def _status
  @_status
end

Class Method Details

._lazy_request(request, method = :get, params = nil) ⇒ Object



67
68
69
# File 'lib/active_rest_client/base.rb', line 67

def self._lazy_request(request, method = :get, params = nil)
  ActiveRestClient::LazyLoader.new(prepare_direct_request(request, method), params)
end

._plain_request(request, method = :get, params = nil) ⇒ Object



63
64
65
# File 'lib/active_rest_client/base.rb', line 63

def self._plain_request(request, method = :get, params = nil)
  prepare_direct_request(request, method, plain:true).call(params)
end

._request(request, method = :get, params = nil) ⇒ Object



59
60
61
# File 'lib/active_rest_client/base.rb', line 59

def self._request(request, method = :get, params = nil)
  prepare_direct_request(request, method).call(params)
end

._request_for(method_name, *args) ⇒ Object



81
82
83
84
85
86
87
88
89
# File 'lib/active_rest_client/base.rb', line 81

def self._request_for(method_name, *args)
  if mapped = self._mapped_method(method_name)
    params = (args.first.is_a?(Hash) ? args.first : nil)
    request = Request.new(mapped, self, params)
    request
  else
    nil
  end
end

.prepare_direct_request(request, method, options = {}) ⇒ Object



71
72
73
74
75
76
77
78
79
# File 'lib/active_rest_client/base.rb', line 71

def self.prepare_direct_request(request, method, options={})
  unless request.is_a? ActiveRestClient::Request
    options[:plain] ||= false
    mapped = {url:"DIRECT-CALLED-#{request}", method:method, options:{url:request, plain:options[:plain]}}

    request = Request.new(mapped, self)
  end
  request
end

Instance Method Details

#[](key) ⇒ Object



91
92
93
# File 'lib/active_rest_client/base.rb', line 91

def [](key)
  @attributes[key.to_sym]
end

#[]=(key, value) ⇒ Object



95
96
97
98
# File 'lib/active_rest_client/base.rb', line 95

def []=(key, value)
  @attributes[key.to_sym] = value
  @dirty_attributes << key
end

#_attributesObject



42
43
44
# File 'lib/active_rest_client/base.rb', line 42

def _attributes
  @attributes
end

#_clean!Object



38
39
40
# File 'lib/active_rest_client/base.rb', line 38

def _clean!
  @dirty_attributes = Set.new
end

#_copy_from(result) ⇒ Object



46
47
48
49
# File 'lib/active_rest_client/base.rb', line 46

def _copy_from(result)
  @attributes =  result._attributes
  @_status = result._status
end

#dirty?Boolean

Returns:

  • (Boolean)


51
52
53
# File 'lib/active_rest_client/base.rb', line 51

def dirty?
  @dirty_attributes.size > 0
end

#eachObject



100
101
102
103
104
# File 'lib/active_rest_client/base.rb', line 100

def each
  @attributes.each do |key, value|
    yield key, value
  end
end

#errorsObject



55
56
57
# File 'lib/active_rest_client/base.rb', line 55

def errors
  @attributes[:errors] || (_errors != {} ? _errors : nil)
end

#inspectObject



106
107
108
109
110
111
112
113
114
115
116
117
118
# File 'lib/active_rest_client/base.rb', line 106

def inspect
  inspection = if @attributes.any?
                 @attributes.collect { |key, value|
                   "#{key}: #{value_for_inspect(value)}"
                 }.compact.join(", ")
               else
                 "[uninitialized]"
               end
  inspection += "#{"," if @attributes.any?} ETag: #{@_etag}" unless @_etag.nil?
  inspection += "#{"," if @attributes.any?} Status: #{@_status}" unless @_status.nil?
  inspection += " (unsaved: #{@dirty_attributes.map(&:to_s).join(", ")})" if @dirty_attributes.any?
  "#<#{self.class} #{inspection}>"
end

#respond_to_missing?(method_name, include_private = false) ⇒ Boolean

Returns:

  • (Boolean)


149
150
151
# File 'lib/active_rest_client/base.rb', line 149

def respond_to_missing?(method_name, include_private = false)
  @attributes.has_key? method_name.to_sym
end

#to_hashObject



153
154
155
156
157
158
159
160
161
162
163
164
165
# File 'lib/active_rest_client/base.rb', line 153

def to_hash
  output = {}
  @attributes.each do |key, value|
    if value.is_a? ActiveRestClient::Base
      output[key.to_s] = value.to_hash
    elsif value.is_a? Array
      output[key.to_s] = value.map(&:to_hash)
    else
      output[key.to_s] = value
    end
  end
  output
end

#to_jsonObject



167
168
169
170
# File 'lib/active_rest_client/base.rb', line 167

def to_json
  output = to_hash
  output.to_json
end