NAME

LWP::UserAgent::Caching - HTTP::Casing based UserAgent, finally done right

SYNOPSIS

use LWP::UserAgent::Caching;

my $cache = CHI->new(
    driver              => 'File',
    root_dir            => '/tmp/LWP_UserAgent_Caching',
    file_extension      => '.cache',
    l1_cache            => {
        driver              => 'Memory',
        global              => 1,
        max_size            => 1024*1024
    },
);

my $ua = LWP::UserAgent::Caching->new(
    http_caching => {
        cache               => $cache,
        type                => 'private',
        request_directives  => (
            'max-age=86400',            # 24hrs
            'min-fresh=60',             # not over due within the next minute
        ),
    },
    # more LWP::UserAgent options
);

my $rqst = HTTP::Request->new( GET => 'http://example.com' );

$rqst->header( cache_control => 'no-cache' ); # Oh... now we bypass it ?
$rqst->header( accept_language => 'nl, en-GB; q=0.9, en; 0.8, *' ); 

my $resp = $ua->request($rqst);

DESCRIPTION

LWP::UserAgent::Caching gives you RFC compliant caching. It respects the old HTTP/1 headerfields like 'Expires' but also implements the HTTP/1.1 'Cache-Control' directives.

Unlike many other cachng useragents, this one does actually invalidate the cache after a non-error response returned by a non-safe request (like DELETE).

METHODS

Since it's a subclass of the standard LWP::UserAgent, it inherits all those. In this module we also implemented the shortcuts from HTTP::Request::Common so that they will not call the parent class

SEE ALSO

HTTP::Caching The RFC 7234 compliant brains - DO NEVER USE THAT MODULE DIRECTLY