HTTP::OAI::UserAgent.3pm

Langue: en

Version: 2010-04-08 (ubuntu - 24/10/10)

Section: 3 (Bibliothèques de fonctions)

NAME

HTTP::OAI::UserAgent - Extension of the LWP::UserAgent for OAI HTTP requests

DESCRIPTION

This module provides a simplified mechanism for making requests to an OAI repository, using the existing LWP::UserAgent module.

SYNOPSIS

         require HTTP::OAI::UserAgent;
 
         my $ua = new HTTP::OAI::UserAgent;
 
         my $response = $ua->request(
                 baseURL=>'http://arXiv.org/oai1',
                 verb=>'ListRecords',
                 from=>'2001-08-01',
                 until=>'2001-08-31'
         );
 
         print $response->content;
 
 

METHODS

$ua = new HTTP::OAI::UserAgent(proxy=>'www-cache',...)
This constructor method returns a new instance of a HTTP::OAI::UserAgent module. All arguments are passed to the LWP::UserAgent constructor.
$r = $ua->request($req)
Requests the HTTP response defined by $req, which is a HTTP::Request object.
$r = $ua->request(baseURL=>$baseref, verb=>$verb, %opts)
Makes an HTTP request to the given OAI server (baseURL) with OAI arguments. Returns an HTTP::Response object.

OAI-PMH related options:

         from => $from
         until => $until
         resumptionToken => $token
         metadataPrefix => $mdp
         set => $set
 
 
$str = $ua->url(baseURL=>$baseref, verb=>$verb, ...)
Takes the same arguments as request, but returns the URL that would be requested.