Class: Talis::Feeds::Feed

Inherits:

Resource

• Object
• Resource
• Talis::Feeds::Feed

Defined in:

lib/talis/feeds/feed.rb

Overview

Represents a feed, as a way of bringing back a collection of annotations.

Class Method Summary

• .find(request_id: new_req_id, target_uri:) ⇒ Array<Talis::Feeds::Annotation>

  Returns a collection of annotations matching the provided target.

Methods inherited from Resource

handle_response, new_req_id

Class Method Details

.find(request_id: new_req_id, target_uri:) ⇒ Array<Talis::Feeds::Annotation>

Returns a collection of annotations matching the provided target.

Parameters:

• request_id (String) (defaults to: new_req_id) —

  (‘uuid’) unique ID for the remote request.

• target_uri (String) —

  The URI uniquely identifying the target.

Returns:

• (Array<Talis::Feeds::Annotation>) —

  An array of annotations or an empty array if the feed was not found.

Raises:

• (Talis::ClientError) —

  if the request was invalid.

• (Talis::ServerError) —

  if there was a problem with the request.

• (Talis::ServerCommunicationError) —

  for network issues.

# File 'lib/talis/feeds/feed.rb', line 16

def find(request_id: new_req_id, target_uri:)
  md5_target_uri = Digest::MD5.hexdigest(target_uri)
  response = fetch_feed(request_id, md5_target_uri)
  begin
    build handle_response(response)
  rescue Talis::NotFoundError
    []
  end
rescue SocketError
  raise Talis::ServerCommunicationError
end