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

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 software is copyright (c) 2012 by Infinity Interactive, Inc..

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

perl v5.38.2                                       2024-03-06              HTTP::Headers:...ack::LinkHeader(3pm)

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.

Name

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

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"
             )
         );