Method: Puppet::Indirector::Indirection#find

Defined in:
lib/puppet/indirector/indirection.rb

#find(key, options = {}) ⇒ Object

Search for an instance in the appropriate terminus, caching the results if caching is configured..



183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
 
# File 'lib/puppet/indirector/indirection.rb', line 183

def find(key, options={})
  request = request(:find, key, nil, options)
  terminus = prepare(request)

  result = find_in_cache(request)
  if not result.nil?
    result
  elsif request.ignore_terminus?
    nil
  else
    # Otherwise, return the result from the terminus, caching if
    # appropriate.
    result = terminus.find(request)
    if not result.nil?
      result.expiration ||= self.expiration if result.respond_to?(:expiration)
      if cache?
        Puppet.info _("Caching %{indirection} for %{request}") % { indirection: self.name, request: request.key }
        begin
          cache.save request(:save, key, result, options)
        rescue => detail
          Puppet.log_exception(detail)
          raise detail
        end
      end

      filtered = result
      if terminus.respond_to?(:filter)
        Puppet::Util::Profiler.profile(_("Filtered result for %{indirection} %{request}") % { indirection: self.name, request: request.key }, [:indirector, :filter, self.name, request.key]) do
          begin
            filtered = terminus.filter(result)
          rescue Puppet::Error => detail
            Puppet.log_exception(detail)
            raise detail
          end
        end
      end
      filtered
    end
  end
end