NAME

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

VERSION

version 0.10

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

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.

SUPPORT

Bugs may be submitted at https://github.com/sartak/http-headers-actionpack/issues.

SOURCE

The source code repository for HTTP-Headers-ActionPack can be found at https://github.com/sartak/http-headers-actionpack.

AUTHORS

  • Stevan Little <stevan@cpan.org>

  • Dave Rolsky <autarch@urth.org>

  • Robert Rothenberg <perl@rhizomnic.com>

COPYRIGHT AND LICENSE

This software is copyright (c) 2012 - 2026 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.

The full text of the license can be found in the LICENSE file included with this distribution.