MAN page from RedHat Other LWP.pm-5.48-2.i386.rpm

lib::HTTP::Message

Section: User Contributed Perl Documentation (3)
Updated: libwww-perl-5.48
Index

NAME

HTTP::Message - Class encapsulating HTTP messages

SYNOPSIS

 package HTTP::Request;  # or HTTP::Response require HTTP::Message; @ISA=qw(HTTP::Message);

DESCRIPTION

A HTTP::Message object contains some headers and a content (body).The class is abstract, i.e. it only used as a base class forHTTP::Request and HTTP::Response and should never instantiatedas itself.

The following methods are available:

$mess = new HTTP::Message;

This is the object constructor. It should only be called internallyby this library. External code should construct HTTP::Request orHTTP::Response objects.

$mess->clone()

Returns a copy of the object.

$mess->protocol([$proto])

Sets the HTTP protocol used for the message. The protocol() is a stringlike ``HTTP/1.0'' or ``HTTP/1.1''.

$mess->content([$content])

The content() method sets the content if an argument is given. If noargument is given the content is not touched. In either case theprevious content is returned.

$mess->add_content($data)

The add_content() methods appends more data to the end of the previouscontent.

$mess->content_ref

The content_ref() method will return a reference to content string.It can be more efficient to access the content this way if the contentis huge, and it can be used for direct manipulation of the content,for instance:

  ${$res->content_ref} =~ s/\bfoo\b/bar/g;

$mess->headers;

Return the embedded HTTP::Headers object.

$mess->headers_as_string([$endl])

Call the HTTP::Headers->as_string() method for the headers in themessage.

All unknown HTTP::Message methods are delegated to theHTTP::Headers object that is part of every message. This allowsconvenient access to these methods. Refer to the HTTP::Headers manpage fordetails of these methods:

  $mess->header($field => $val);  $mess->scan(\&doit);  $mess->push_header($field => $val);  $mess->remove_header($field);

  $mess->date;  $mess->expires;  $mess->if_modified_since;  $mess->if_unmodified_since;  $mess->last_modified;  $mess->content_type;  $mess->content_encoding;  $mess->content_length;  $mess->content_language  $mess->title;  $mess->user_agent;  $mess->server;  $mess->from;  $mess->referer;  $mess->www_authenticate;  $mess->authorization;  $mess->proxy_authorization;  $mess->authorization_basic;  $mess->proxy_authorization_basic;

COPYRIGHT

This library is free software; you can redistribute it and/ormodify it under the same terms as Perl itself.

This document was created byman2html,using the manual pages.