NAME

HTTP::Headers::ActionPack::LinkHeader - A Link

VERSION

version 0.09

SYNOPSIS

  use HTTP::Headers::ActionPack::LinkHeader;

  # build from string
  my $link = HTTP::Headers::ActionPack::LinkHeader->new_from_string(
      '<http://example.com/TheBook/chapter2>;rel="previous";title="previous chapter"'
  );

  # normal constructor
  my $link = HTTP::Headers::ActionPack::LinkHeader->new(
      '<http://example.com/TheBook/chapter2>' => (
          rel   => "previous",
          title => "previous chapter"
      )
  );

  # normal constructor, and <> around link are optional
  my $link = HTTP::Headers::ActionPack::LinkHeader->new(
      'http://example.com/TheBook/chapter2' => (
          rel   => "previous",
          title => "previous chapter"
      )
  );

DESCRIPTION

This is an object which represents an HTTP Link header. It is most often used as a member of a HTTP::Headers::ActionPack::LinkList object.

METHODS

"href"
"new_from_string ( $link_header_string )": This will take an HTTP header Link string and parse it into and object.
"as_string": This stringifies the link respecting the parameter order.
NOTE: This will canonicalize the header such that it will add a space between each semicolon and quotes and unquotes all headers appropriately.

AUTHOR

Stevan Little <stevan.little@iinteractive.com>

CONTRIBUTORS

Andrew Nelson <anelson@cpan.org>
Dave Rolsky <autarch@urth.org>
Florian Ragwitz <rafl@debian.org>
Jesse Luehrs <doy@tozt.net>
Karen Etheridge <ether@cpan.org>

COPYRIGHT AND LICENSE

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.