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

#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.



722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
 
# File 'lib/atom.rb', line 722

def initialize(o)
  case o
  when 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 



748
749
750
 
# File 'lib/atom.rb', line 748

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.



759
760
761
762
763
764
765
 
# File 'lib/atom.rb', line 759

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 



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

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

#length=(v) ⇒ Object 



740
741
742
 
# File 'lib/atom.rb', line 740

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

#to_s ⇒ Object 



744
745
746
 
# File 'lib/atom.rb', line 744

def to_s
  self.href
end