Metadata::HTTP - metadata class for HTTP log records

NAME

Metadata::HTTP - metadata class for HTTP log records

SYNOPSIS

  use Metadata::HTTP
  ...
  $i=new Metadata::HTTP;
  open(IN, $logfile);
  while($i->read('IN')) {
    print $i->get('agent'),"\n";
  }
  ...

DESCRIPTION

The Metadata::HTTP class allows the handling of HTTP log records as metadata objects using the the Metadata::Base manpage class.

The following fields are set after using the read method:

  host ident authuser
  date day month year time hour min sec
  timezone (in format +/-NNNN)
  status bytes
  request - 'GET /foo' etc

Optionally set: referer (if supported by log) agent (if supported by log) http-version (if present) command - GET, POST, etc. path - operand to command

CONSTRUCTOR

new [OPTIONS]

An optional hash of options can be given to the constructor to set various options. There is only one Metadata::HTTP options defined:

DEBUG: This class has a separate debug class / object method that works in the same fashion as the Metadata::Base method debug. Setting it here also sets the debugging on the base Metadata::Base object too.

METHODS

The methods here describe the differences from the the Metadata::Base manpage class methods.

read HANDLE: Reads a single line from the file descriptor and uses it to fill the fields of the HTTP metadata object.
format [URL]: Returns the original HTTP line used in the parsing.

AUTHOR

By Dave Beckett - http://purl.org/net/dajobe/

COPYRIGHT

Metadata::HTTP - metadata class for HTTP log records