Contents

require 'uri_template'

class HyperResource::Link
  attr_accessor :base_href,
                :name,
                :templated,
                :params,
                :parent_resource

  ## Returns true if this link is templated.
  def templated?; templated end

  def initialize(resource=nil, link_spec={})
    self.parent_resource = resource || HyperResource.new
    self.base_href = link_spec['href']
    self.name = link_spec['name']
    self.templated = !!link_spec['templated']
    self.params    = link_spec['params'] || {}
  end

  ## Returns this link's href, applying any URI template params.
  def href
    if self.templated?
      filtered_params = self.parent_resource.outgoing_uri_filter(params)
      URITemplate.new(self.base_href).expand(filtered_params)
    else
      self.base_href
    end
  end

  ## Returns a new scope with the given params; that is, returns a copy of
  ## itself with the given params applied.
  def where(params)
    params = Hash[ params.map{|(k,v)| [k.to_s, v]} ]
    self.class.new(self.parent_resource,
                   'href' => self.base_href,
                   'name' => self.name,
                   'templated' => self.templated,
                   'params' => self.params.merge(params))
  end

  ## Returns a HyperResource representing this link
  def resource
    parent_resource._hr_new_from_link(self.href)
  end

  ## Delegate HTTP methods to the resource.
  def get(*args);    self.resource.get(*args)    end
  def post(*args);   self.resource.post(*args)   end
  def patch(*args);  self.resource.patch(*args)  end
  def put(*args);    self.resource.put(*args)    end
  def delete(*args); self.resource.delete(*args) end

  ## If we were called with a method we don't know, load this resource
  ## and pass the message along.  This achieves implicit loading.
  def method_missing(method, *args, &block)
    self.get.send(method, *args, &block)
  end
end

Version data entries

4 entries across 4 versions & 1 rubygems

Version	Path
aptible-resource-1.1.2	lib/hyper_resource/link.rb
aptible-resource-1.1.1	lib/hyper_resource/link.rb
aptible-resource-1.1.0	lib/hyper_resource/link.rb
aptible-resource-1.1.0.pre.0	lib/hyper_resource/link.rb