=encoding UTF-8

=head1 NAME

Gungho::Request.ja - Gunghoリクエストオブジェクト

=head1 SYNOPSIS

  use Gungho::Request;
  my $r = Gungho::Request->new(GET => "http://example.com");
  $r->notes(foo => 2);
  my $foo = $r->notes('foo');

  my $id     = $r->id;
  my $cloned = $r->clone;
  my $string = $r->format();

=head1 DESCRIPTION

Gungho::RequestはHTTP::Requestの小クラスです。基本実装はHTTP::Requestから
変更はありませんが、いくつかの機能が追加されています。

=head1 METHODS

=head2 new()

新規インスタンスを作成します。

=head2 id()

このリクエスト固有IDを返します。

=head2 clone()

このリクエストのクローンを作成します。クローンはnotes()の中身もクローンされて
返されます。

=head2 notes($key[, $value])

HTTP::Requestが提供するもの以外のメタデータ／付随データを格納します。

=head2 original_uri

リクエストのURIのクローンを返します。URIのホスト名はGunghoがDNS解決を行う場合
はIPアドレスに変換されている可能性がありますが、このメソッドを使うと必ず
最初に指定されていたホスト名を使用して返されます。

=head2 requires_name_lookup

リクエストURIのホスト名がDNS解決を行う必要がある場合は正を返します。

=head2 format

HTTPリクエスト内容を文字列として返します。実装はGungho::Request::httpに
格納されています。

=head2 SEE ALSO

L<Gungho::Request::http|Gungho::Request::http>

=cut