Class: Hyperclient::Link Private

Inherits:
Object
  • Object
show all
Defined in:
lib/hyperclient/link.rb

Overview

This class is part of a private API. You should avoid using this class if possible, as it may be removed or be changed in the future.

The Link is used to let a Resource interact with the API.

Direct Known Subclasses

EntryPoint

Instance Method Summary collapse

Constructor Details

#initialize(key, link, entry_point, uri_variables = nil) ⇒ Link

Initializes a new Link.

Parameters:

  • key —

    The key or name of the link.

  • link —

    The String with the URI of the link.

  • entry_point —

    The EntryPoint object to inject the configuration.

  • uri_variables (defaults to: nil) —

    The optional Hash with the variables to expand the link if it is templated.



16
17
18
19
20
21
 
# File 'lib/hyperclient/link.rb', line 16

def initialize(key, link, entry_point, uri_variables = nil)
  @key           = key
  @link          = link
  @entry_point   = entry_point
  @uri_variables = uri_variables
end

Dynamic Method Handling

This class handles dynamic methods through the method_missing method

#method_missing(method, *args, &block) ⇒ Object (private)

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Delegate the method further down the API if the resource cannot serve it.



127
128
129
130
131
132
133
 
# File 'lib/hyperclient/link.rb', line 127

def method_missing(method, *args, &block)
  if _resource.respond_to?(method.to_s)
    _resource.send(method, *args, &block) || delegate_method(method, *args, &block)
  else
    super
  end
end

Instance Method Details

#_delete ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future. 



100
101
102
 
# File 'lib/hyperclient/link.rb', line 100

def _delete
  http_method(:delete)
end

#_deprecation ⇒ Object

Returns the deprecation property of the Link



64
65
66
 
# File 'lib/hyperclient/link.rb', line 64

def _deprecation
  @link['deprecation']
end

#_expand(uri_variables = {}) ⇒ Object

Expands the Link when is templated with the given variables.

Parameters:

  • uri_variables (defaults to: {}) —

    The Hash with the variables to expand the URITemplate.

Returns:

  • a new Link with the expanded variables.



36
37
38
 
# File 'lib/hyperclient/link.rb', line 36

def _expand(uri_variables = {})
  self.class.new(@key, @link, @entry_point, uri_variables)
end

#_get ⇒ Object

Returns the Resource which the Link is pointing to.



88
89
90
 
# File 'lib/hyperclient/link.rb', line 88

def _get
  http_method(:get)
end

#_head ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future. 



96
97
98
 
# File 'lib/hyperclient/link.rb', line 96

def _head
  http_method(:head)
end

#_hreflang ⇒ Object

Returns the hreflang property of the Link



79
80
81
 
# File 'lib/hyperclient/link.rb', line 79

def _hreflang
  @link['hreflang']
end

#_name ⇒ Object

Returns the name property of the Link



59
60
61
 
# File 'lib/hyperclient/link.rb', line 59

def _name
  @link['name']
end

#_options ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future. 



92
93
94
 
# File 'lib/hyperclient/link.rb', line 92

def _options
  http_method(:options)
end

#_patch(params = {}) ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future. 



112
113
114
 
# File 'lib/hyperclient/link.rb', line 112

def _patch(params = {})
  http_method(:patch, params)
end

#_post(params = {}) ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future. 



104
105
106
 
# File 'lib/hyperclient/link.rb', line 104

def _post(params = {})
  http_method(:post, params)
end

#_profile ⇒ Object

Returns the profile property of the Link



69
70
71
 
# File 'lib/hyperclient/link.rb', line 69

def _profile
  @link['profile']
end

#_put(params = {}) ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future. 



108
109
110
 
# File 'lib/hyperclient/link.rb', line 108

def _put(params = {})
  http_method(:put, params)
end

#_resource ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future. 



83
84
85
 
# File 'lib/hyperclient/link.rb', line 83

def _resource
  @resource || _get
end

#_templated? ⇒ Boolean

Indicates if the link is an URITemplate or a regular URI.

Returns:

  • (Boolean) —

    true if it is templated.

  • false if it not templated.



27
28
29
 
# File 'lib/hyperclient/link.rb', line 27

def _templated?
  !!@link['templated']
end

#_title ⇒ Object

Returns the title property of the Link



74
75
76
 
# File 'lib/hyperclient/link.rb', line 74

def _title
  @link['title']
end

#_type ⇒ Object

Returns the type property of the Link



54
55
56
 
# File 'lib/hyperclient/link.rb', line 54

def _type
  @link['type']
end

#_uri_template ⇒ Object (private)

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Memoization for a URITemplate instance



164
165
166
 
# File 'lib/hyperclient/link.rb', line 164

def _uri_template
  @uri_template ||= URITemplate.new(@link['href'])
end

#_url ⇒ Object

Returns the url of the Link.



41
42
43
44
 
# File 'lib/hyperclient/link.rb', line 41

def _url
  return @link['href'] unless _templated?
  @url ||= _uri_template.expand(@uri_variables || {})
end

#_variables ⇒ Object

Returns an array of variables from the URITemplate.

Returns:

  • an empty array for regular URIs.



49
50
51
 
# File 'lib/hyperclient/link.rb', line 49

def _variables
  _uri_template.variables
end

#delegate_method(method, *args, &block) ⇒ Object (private)

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Delegate the method to the API if the resource cannot serve it.

This allows ‘api.posts` instead of `api._links.posts.embedded.posts`



138
139
140
141
142
143
 
# File 'lib/hyperclient/link.rb', line 138

def delegate_method(method, *args, &block)
  return unless @key && _resource.respond_to?(@key)
  @delegate ||= _resource.send(@key)
  return unless @delegate && @delegate.respond_to?(method.to_s)
  @delegate.send(method, *args, &block)
end

#http_method(method, body = nil) ⇒ Object (private)

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future. 



168
169
170
171
172
173
174
175
 
# File 'lib/hyperclient/link.rb', line 168

def http_method(method, body = nil)
  @resource = begin
    response = Futuroscope::Future.new do
      @entry_point.connection.run_request(method, _url, body, nil)
    end
    Resource.new(response.body, @entry_point, response)
  end
end

#inspect ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future. 



116
117
118
 
# File 'lib/hyperclient/link.rb', line 116

def inspect
  "#<#{self.class.name}(#{@key}) #{@link}>"
end

#respond_to_missing?(method, _include_private = false) ⇒ Boolean (private)

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Accessory method to allow the link respond to the methods that will hit method_missing.

Returns:

  • (Boolean) 


147
148
149
150
151
152
153
 
# File 'lib/hyperclient/link.rb', line 147

def respond_to_missing?(method, _include_private = false)
  if @key && _resource.respond_to?(@key) && (delegate = _resource.send(@key)) && delegate.respond_to?(method.to_s)
    true
  else
    _resource.respond_to?(method.to_s)
  end
end

#to_ary ⇒ Object (private)

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

avoid delegating to resource

#to_ary is called for implicit array coercion (such as parallel assignment or Array#flatten). Returning nil tells Ruby that this record is not Array-like.



159
160
161
 
# File 'lib/hyperclient/link.rb', line 159

def to_ary
  nil
end

#to_s ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future. 



120
121
122
 
# File 'lib/hyperclient/link.rb', line 120

def to_s
  _url
end