HTTP::Request

Hippo2000 (2000/7/28)

HTTP::Requestモジュールなのです。

作者はGisle Aasさんです。メールで許可をいただきました。

名前

HTTP::Request - HTTPリクエストをカプセル化するクラス

概要

 require HTTP::Request;
 $request = HTTP::Request->;new(GET => 'http://www.oslonett.no/');

説明

HTTP::RequestクラスはHTTP形式のリクエストをカプセル化します。レスポンスはリクエスト行、いくつかのヘッダ、そして（潜在的には空の）内容で構成されます。LWPライブラリはHTTPプロトコルでないスキームにも、HTTP形式のリクエストを使っていることに注意してください。

このクラスのインスタンスは通常、LWP::UserAgentオブジェクトのrequestメソッドに渡されます：

 $ua = LWP::UserAgent->new;
 $request = HTTP::Request->;new(GET => 'http://www.oslonett.no/');
 $response = $ua->request($request);

HTTP::RequestはHTTP::Messageのサブクラスで、このためそのメソッドを継承しています。よく使われる継承されたメソッドはheader()、push_header()、remove_header()、headers_as_string()そしてcontent()です。詳細はHTTP::Messageをご覧下さい。

以下の追加のメソッドが利用できます：

$r = HTTP::Request->new($method, $uri, [$header, [$content]])

オブジェクト$uriへメソッド$methodを使ったリクエストについて記述するHTTP::Requestオブジェクトを組みたてます。$uri引数は文字列かURIオブジェクトへのリファレンスが指定できます。$header引数はHTTP::Headersオブジェクトへのリファレンスでなければなりません。

$r->method([$val])

$r->uri([$val])

これらのメソッドは、それぞれリクエストのメソッドとそのリクエストのURIオブジェクトが入った属性へのパブリックなアクセスを提供します。

引数が与えられるとそれが新しい値となります。引数が与えられないと値は触られません。どちらの場合も前の値が返されます。

uri()メソッドはその引数としてURIオブジェクトと文字列の両方と受取ります。もし文字列が与えられると、絶対的なURIとして解析できるものでなければなりません。

$r->as_string()

リクエストのテキスト形式表現を返します。主にデバッグ目的で使われます。引数は取りません。