Class: Atom::Link

Inherits:
Object
  • Object
show all
Includes:
Xml::Parseable
Defined in:
lib/atom.rb

Overview

Represents a link in an Atom document.

A link defines a reference from an Atom document to a web resource.

References

See www.atomenabled.org/developers/syndication/atom-format-spec.php#element.link for a description of the different types of links.

Defined Under Namespace

Modules: Rel

Instance Method Summary collapse

Methods included from Xml::Parseable

#accessor_name, #current_node_is?, included, #next_node_is?, #parse, #to_xml

Constructor Details

#initialize(o) ⇒ Link

Create a link.

o

An XML::Reader containing a link element or a Hash of attributes.



748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
 
# File 'lib/atom.rb', line 748

def initialize(o)
  case o
  when Nokogiri::XML::Reader
    if current_node_is?(o, 'link')
      parse(o, :once => true)
    else
      raise ArgumentError, "Link created with node other than atom:link: #{o.name}"
    end
  when Hash
    [:href, :rel, :type, :length, :hreflang, :title].each do |attr|
      self.send("#{attr}=", o[attr])
    end
  else
    raise ArgumentError, "Don't know how to handle #{o}"
  end
end

Instance Method Details

#==(o) ⇒ Object 



774
775
776
 
# File 'lib/atom.rb', line 774

def ==(o)
  o.respond_to?(:href) && o.href == self.href
end

#fetch(options = {}) ⇒ Object

This will fetch the URL referenced by the link.

If the URL contains a valid feed, a Feed will be returned, otherwise, the body of the response will be returned.

TODO: Handle redirects.



785
786
787
788
789
790
791
 
# File 'lib/atom.rb', line 785

def fetch(options = {})
  begin
    Atom::Feed.load_feed(URI.parse(self.href), options)
  rescue ArgumentError
    Net::HTTP.get_response(URI.parse(self.href)).body
  end
end

#inspect ⇒ Object 



793
794
795
 
# File 'lib/atom.rb', line 793

def inspect
  "<Atom::Link href:'#{href}' type:'#{type}'>"
end

#length=(v) ⇒ Object 



766
767
768
 
# File 'lib/atom.rb', line 766

def length=(v)
  @length = v.to_i
end

#to_s ⇒ Object 



770
771
772
 
# File 'lib/atom.rb', line 770

def to_s
  self.href
end