Module: LHS::Record::Endpoints::ClassMethods

Defined in:
lib/lhs/concerns/record/endpoints.rb

Instance Method Summary collapse

Instance Method Details

#compute_url(params, url = nil) ⇒ Object



72
73
74
75
# File 'lib/lhs/concerns/record/endpoints.rb', line 72

def compute_url(params, url = nil)
  find_endpoint(params, url)
    .compile(params)
end

#compute_url!(params) ⇒ Object

Computes the url from params by identifiying endpoint and compiles it if necessary.



65
66
67
68
69
70
# File 'lib/lhs/concerns/record/endpoints.rb', line 65

def compute_url!(params)
  endpoint = find_endpoint(params)
  url = endpoint.compile(params)
  endpoint.remove_interpolated_params!(params)
  url
end

#endpoint(url, options = nil) ⇒ Object

Adds the endpoint to the list of endpoints.



24
25
26
27
28
29
30
31
32
# File 'lib/lhs/concerns/record/endpoints.rb', line 24

def endpoint(url, options = nil)
  self.endpoints = endpoints.clone
  validates_deprecation_check!(options)
  endpoint = LHC::Endpoint.new(url, options)
  sanity_check(endpoint)
  endpoints.push(endpoint)
  LHS::Record::Endpoints.all ||= {}
  LHS::Record::Endpoints.all[url] = self
end

#find_endpoint(params = {}, url = nil) ⇒ Object

Find an endpoint based on the provided parameters. If no parameters are provided it finds the base endpoint otherwise it finds the endpoint that matches the parameters best.



45
46
47
48
49
50
51
# File 'lib/lhs/concerns/record/endpoints.rb', line 45

def find_endpoint(params = {}, url = nil)
  endpoint = find_best_endpoint(params) if params && params.keys.count > 0
  endpoint ||= find_endpoint_by_url(url) if url.present?
  endpoint ||= LHC::Endpoint.new(url) if url.present?
  endpoint ||= find_base_endpoint
  endpoint
end

#for_url(url) ⇒ Object



34
35
36
37
38
39
40
# File 'lib/lhs/concerns/record/endpoints.rb', line 34

def for_url(url)
  return unless url
  _template, record = LHS::Record::Endpoints.all.detect do |template, _|
    LHC::Endpoint.match?(url, template)
  end
  record
end

#sanity_check(new_endpoint) ⇒ Object

Prevent ambiguous endpoints



54
55
56
57
58
59
60
61
# File 'lib/lhs/concerns/record/endpoints.rb', line 54

def sanity_check(new_endpoint)
  endpoints.each do |existing_endpoint|
    invalid = existing_endpoint.placeholders.sort == new_endpoint.placeholders.sort &&
      existing_endpoint.url != new_endpoint.url
    next unless invalid
    raise "Ambiguous endpoints! Cannot differentiate between #{existing_endpoint.url} and #{new_endpoint.url}"
  end
end