Japanized Perl Resources Project[凍結]

[perldocjp-cvs 1845] CVS update: docs/modules/Furl-3.00/lib/Furl

ktats****@users***** ktats****@users*****
2013年 11月 18日 (月) 11:14:29 JST

• 前の記事 [perldocjp-cvs 1844] CVS update: docs/modules/Furl-3.00/lib
• 記事の並び順: [ 日付 ] [ スレッド ] [ 件名 ] [ 著者 ]

Index: docs/modules/Furl-3.00/lib/Furl/HTTP.pod
diff -u /dev/null docs/modules/Furl-3.00/lib/Furl/HTTP.pod:1.1
--- /dev/null	Mon Nov 18 11:14:29 2013
+++ docs/modules/Furl-3.00/lib/Furl/HTTP.pod	Mon Nov 18 11:14:29 2013
@@ -0,0 +1,879 @@
+=encoding utf-8
+
+=for stopwords sockaddr
+
+=head1 NAME
+
+=begin original
+
+Furl::HTTP - Low level interface to Furl
+
+=end original
+
+Furl::HTTP - Furlの低レベルのインターフェース
+
+=head1 概要
+
+    use Furl;
+
+    my $furl = Furl::HTTP->new(
+        agent   => 'MyGreatUA/2.0',
+        timeout => 10,
+    );
+
+    my ($minor_version, $code, $msg, $headers, $body) = $furl->request(
+        method     => 'GET',
+        host       => 'example.com',
+        port       => 80,
+        path_query => '/'
+    );
+    # or
+
+    # Accept-Encoding is supported but optional
+    $furl = Furl->new(
+        headers => [ 'Accept-Encoding' => 'gzip' ],
+    );
+    my $body = $furl->get('http://example.com/some/compressed');
+
+=head1 説明
+
+=begin original
+
+Furl is yet another HTTP client library. LWP is the de facto standard HTTP
+client for Perl 5, but it is too slow for some critical jobs, and too complex
+for weekend hacking. Furl resolves these issues. Enjoy it!
+
+=end original
+
+Furl はもう一つの HTTP クライアントライブラリです。LWP は Perl 5 のデファクトスタンダードな
+HTTP クライアントですが、クリティカルなジョブでは遅すぎますし、週末のハッキングには
+複雑過ぎます。Furl はこれらの問題を解決します。楽しんで下さい！
+
+=head1 INTERFACE
+
+(インターフェース)
+
+=head2 Class Methods
+
+(クラスメソッド)
+
+=head3 C<< Furl::HTTP->new(%args | \%args) :Furl >>
+
+=begin original
+
+Creates and returns a new Furl client with I<%args>. Dies on errors.
+
+=end original
+
+新しいFurlクライアントをI<%args>で作ります。エラーがあると死にます。
+
+=begin original
+
+I<%args> might be:
+
+=end original
+
+I<%args> は:
+
+=over
+
+=item agent :Str = "Furl/$VERSION"
+
+=item timeout :Int = 10
+
+=begin original
+
+Seconds until the call to $furl->request returns a timeout error (as an internally generated 500 error). The timeout might not be accurate since some underlying modules / built-ins function may block longer than the specified timeout. See the FAQ for how to support timeout during name resolution.
+
+=end original
+
+$furl->request の呼出がタイムアウトエラーを返すまでの秒数(内部的に500エラー)。基礎となるモジュール/組込の関数が指定の時間より長くブロックするかもしれないので、タイムアウトは正確ではないかもせいれません。名前解決時のタイムアウトサポートする方法はFAQを見てください。
+
+=item inactivity_timeout :Int = 600
+
+=begin original
+
+An inactivity timer for TCP read/write (in seconds). $furl->request returns a timeout error if no additional data arrives (or is sent) within the specified threshold.
+
+=end original
+
+TCP 読み/書きのための、非アクティブタイマーです(秒内)。$furl->request は、追加のデータが、指定のしきい値内にデータが来ない(か送られない)なら、タイムアウトエラーを返します。
+
+=item max_redirects :Int = 7
+
+=item proxy :Str
+
+=item no_proxy :Str
+
+=item headers :ArrayRef
+
+=item header_format :Int = HEADERS_AS_ARRAYREF
+
+=begin original
+
+This option choose return value format of C<< $furl->request >>.
+
+=end original
+
+このオプションではC<<$furl->request>>の返す値のフォーマットを選びます。
+
+=begin original
+
+This option allows HEADERS_NONE or HEADERS_AS_ARRAYREF.
+
+=end original
+
+HEADERS_NONE か HEADERS_AS_ARRAYREF を使えます。
+
+=begin original
+
+B<HEADERS_AS_ARRAYREF> is a default value. This makes B<$headers> as ArrayRef.
+
+=end original
+
+B<HEADERS_AS_ARRAYREF>> はデフォルト値です。B<$headers>をArrayRefとして作ります。
+
+=begin original
+
+B<HEADERS_NONE> makes B<$headers> as undef. Furl does not return parsing result of headers. You should take needed headers from B<special_headers>.
+
+=end original
+
+B<HEADERS_NONE> B<$headers> を undef にします。Furlヘッダを解析した結果を返しません。 B<special_headers>から必要なヘッダ受けとるべきです。
+
+=item connection_pool :Object
+
+=begin original
+
+This is the connection pool object for keep-alive requests. By default, it is a instance of L<Furl::ConnectionCache>.
+
+=end original
+
+keep-aliveリクエスト用のコネクションプールオブジェクトです。デフォルトではL<Furl::ConnectionCache>のインスタンスです。
+
+=begin original
+
+You may not customize this variable otherwise to use L<Coro>. This attribute requires a duck type object. It has two methods, C<< $obj->steal($host, $port >> and C<< $obj->push($host, $port, $sock) >>.
+
+=end original
+
+L<Coro> を使う以外の方法でこの値をカスタマイズできないでしょう。このアトリビュートはダックタイプオブジェクトを必要とします。2つのメソッド、C<< $obj->steal($host, $port >> と C<< $obj->push($host, $port, $sock) >> があります。
+
+=item stop_if :CodeRef
+
+=begin original
+
+A callback function that is called by Furl after when a blocking function call returns EINTR. Furl will abort the HTTP request and return immediately if the callback returns true. Otherwise the operation is continued (the default behaviour).
+
+=end original
+
+ブロッキング関数がEINTRを呼んだ後にFurlが呼ぶコールバック関数です。コールバックが真なら、FurlはHTTPリクエストを中断し、即座に戻ります。そうでなければ、オペレーションは続行されます(デフォルトの挙動)。
+
+=item get_address :CodeRef
+
+=begin original
+
+=begin original
+
+A callback function to override the default address resolution logic. Takes three arguments: ($hostname, $port, $timeout_in_seconds) and returns: ($sockaddr, $errReason).  If the returned $sockaddr is undef, then the resolution is considered as a failure and $errReason is propagated to the caller.
+
+=end original
+
+デフォルトのアドレス解決ロジックを上書きするコールバック関数です。3つの引数を取ります: ($hostname, $port, $timeout_in_seconds) そして、戻り値は: ($socketaddr、$errReason)。返された $socketaddr が undef であれば、解決は失敗として考えられ、$errReason が呼び出し元に広められます。
+
+=end original
+
+=item inet_aton :CodeRef
+
+=begin original
+
+Deprecated.  New applications should use B<get_address> instead.
+
+=end original
+
+廃止。新しいアプリケーションは B<get_address> を代わりに使うべきです。
+
+=begin original
+
+A callback function to customize name resolution. Takes two arguments: ($hostname, $timeout_in_seconds). If omitted, Furl calls L<Socket::inet_aton>.
+
+=end original
+
+名前解決をカスタマイズするためのコールバック関数です。2つの引数を取ります:  ($hostname, $timeout_in_seconds)。省略すると、FurlはL<Socket::inet_aton>を呼びます。
+
+=item ssl_opts :HashRef
+
+=begin original
+
+SSL configuration used on https requests, passed directly to C<< IO::Socket::SSL->new() >>,
+
+=end original
+
+https リクエストで使われるSSL設定です。C<< IO::Socket::SSL->new() >>に直接渡されます。
+
+=begin original
+
+for example:
+
+=end original
+
+例:
+
+    use IO::Socket::SSL;
+
+    my $ua = Furl::HTTP->new(
+        ssl_opts => {
+            SSL_verify_mode => SSL_VERIFY_PEER(),
+        },
+    });
+
+=begin original
+
+See L<IO::Socket::SSL> for details.
+
+=end original
+
+詳細は、L<IO::Socket::SSL> を見てください。
+
+=back
+
+=head2 Instance Methods
+
+(インスタンスメソッド)
+
+=head3 C<< $furl->request(%args) :($protocol_minor_version, $code, $msg, \@headers, $body) >>
+
+=begin original
+
+Sends an HTTP request to a specified URL and returns a protocol minor version,
+status code, status message, response headers, response body respectively.
+
+=end original
+
+HTTPリクエストを指定したURLへ送り、プロトコルのマイナーバージョン、ステータスコード、
+ステータースメッセージ、レスポンスヘッダー、レスポンスボディーをそれぞれ返します。
+
+=begin original
+
+I<%args> might be:
+
+=end original
+
+I<%args> は:
+
+=over
+
+=item scheme :Str = "http"
+
+=begin original
+
+Protocol scheme. May be C<http> or C<https>.
+
+=end original
+
+プロトコロスキーマ。C<http> か C<https> でしょう。
+
+=item host :Str
+
+=begin original
+
+Server host to connect.
+
+=end original
+
+接続するサーバホスト。
+
+=begin original
+
+You must specify at least C<host> or C<url>.
+
+=end original
+
+C<host> か C<url>のいずれかを指定しなければいけません。
+
+=item port :Int = 80
+
+=begin original
+
+Server port to connect. The default is 80 on C<< scheme => 'http' >>,
+or 443 on C<< scheme => 'https' >>.
+
+=end original
+
+接続するサーバのポート。デフォルトは、C<< schema => 'http' >>なら80で、
+C<< scheme => 'https' >>なら、443です。
+
+=item path_query :Str = "/"
+
+=begin original
+
+Path and query to request.
+
+=end original
+
+リクエストするパスとクエリ。
+
+=item url :Str
+
+=begin original
+
+URL to request.
+
+=end original
+
+リクエストするURL。
+
+=begin original
+
+You can use C<url> instead of C<scheme>, C<host>, C<port> and C<path_query>.
+
+=end original
+
+C<schema>、C<host>、C<port>、C<path_query>を指定する代わりにC<url>を使えます。
+
+=item headers :ArrayRef
+
+=begin original
+
+HTTP request headers. e.g. C<< headers => [ 'Accept-Encoding' => 'gzip' ] >>.
+
+=end original
+
+HTTPリクエストヘッダ。例 C<< headers => [ 'Accept-Encoding' => 'gzip' ] >>.
+
+=item content : Str | ArrayRef[Str] | HashRef[Str] | FileHandle
+
+=begin original
+
+Content to request.
+
+=end original
+
+リクエストする内容。
+
+=item write_file : FileHandle
+
+=begin original
+
+If this parameter is set, the response content will be saved here instead of in the response object.
+
+=end original
+
+このパラメータがセットされていると、レスポンスの内容はレスポンスオブジェクトではなく指定されたファイルハンドル
+に保存されます。
+
+=begin original
+
+It's like a C<:content_file> in L<LWP::UserAgent>.
+
+=end original
+
+L<LWP::UserAgent>のC<:content_file>と似ています。
+
+=item write_code : CodeRef
+
+=begin original
+
+If a callback is provided with the "write_code" option
+then this function will be called for each chunk of the response
+content as it is received from the server.
+
+=end original
+
+"write_code"オプションでコールバックを指定した場合、
+この関数は、サーバから受け取るレスポンスの内容のチャンク毎に呼ばれます。
+
+=begin original
+
+It's like a C<:content_cb> in L<LWP::UserAgent>.
+
+=end original
+
+L<LWP::UserAgent>の<:content_cb>と似ています。
+
+=back
+
+=begin original
+
+The C<request()> method assumes the first argument to be an instance
+of C<HTTP::Request> if the arguments are an odd number:
+
+=end original
+
+C<response()> メソッドは引数が奇数の場合、最初の引数をC<HTTP::Request>のインスタンスと想定します。
+
+    my $req = HTTP::Request->new(...);
+    my @res = $furl->request($req); # allowed
+
+=begin original
+
+You must encode all the queries or this method will die, saying
+C<Wide character in ...>.
+
+=end original
+
+すべてのクエリをエンコードする必要があります。さもなくば、C<Wide character in ...>
+を吐いて死にます。
+
+=head3 C<< $furl->get($url :Str, $headers :ArrayRef[Str] ) >>
+
+=begin original
+
+This is an easy-to-use alias to C<request()>, sending the C<GET> method.
+
+=end original
+
+C<request()>簡単に使うためのエイリアスです。C<GET>メソッドを送ります。
+
+=head3 C<< $furl->head($url :Str, $headers :ArrayRef[Str] ) >>
+
+=begin original
+
+This is an easy-to-use alias to C<request()>, sending the C<HEAD> method.
+
+=end original
+
+C<request()>簡単に使うためのエイリアスです。C<HED>メソッドを送ります。
+
+=head3 C<< $furl->post($url :Str, $headers :ArrayRef[Str], $content :Any) >>
+
+=begin original
+
+This is an easy-to-use alias to C<request()>, sending the C<POST> method.
+
+=end original
+
+C<request()>簡単に使うためのエイリアスです。C<POST>メソッドを送ります。
+
+=head3 C<< $furl->put($url :Str, $headers :ArrayRef[Str], $content :Any) >>
+
+=begin original
+
+This is an easy-to-use alias to C<request()>, sending the C<PUT> method.
+
+=end original
+
+C<request()>簡単に使うためのエイリアスです。C<PUT>メソッドを送ります。
+
+=head3 C<< $furl->delete($url :Str, $headers :ArrayRef[Str] ) >>
+
+=begin original
+
+This is an easy-to-use alias to C<request()>, sending the C<DELETE> method.
+
+=end original
+
+C<request()>簡単に使うためのエイリアスです。C<DELETE>メソッドを送ります。
+
+=head1 FAQ
+
+=over 4
+
+=item どうして IO::Socket::SSL?
+
+=begin original
+
+(Why IO::Socket::SSL?)
+
+=end original
+
+=begin original
+
+Net::SSL is not well documented.
+
+=end original
+
+Net::SSL はドキュメントが貧弱です。
+
+=item env_proxy はなぜオプショナルなのですか?
+
+=begin original
+
+(Why is env_proxy optional?)
+
+=end original
+
+=begin original
+
+Environment variables are highly dependent on each users' environment,
+and we think it may confuse users when something doesn't go right.
+
+=end original
+
+環境変数はユーザーの環境に強く依存します。
+うまく動かないときにユーザーを混乱させます。
+
+=item サポートしているオペレーティングシステムは?
+
+=begin original
+
+(What operating systems are supported?)
+
+=end original
+
+=begin original
+
+Linux 2.6 or higher, OSX Tiger or higher, Windows XP or higher.
+
+=end original
+
+Linux 2.6 以上、 OSX Tiger 以上、 Windows XP 以上。
+
+=begin original
+
+And other operating systems will be supported if you send a patch.
+
+=end original
+
+あなたがパッチを送れば、他のオペレーティングシステムもサポートされるでしょう。
+
+=item なぜFurlはチャンクされたアップロードをサポートしないのですか?
+
+=begin original
+
+(Why doesn't Furl support chunked upload?)
+
+=end original
+
+=begin original
+
+There are reasons why chunked POST/PUTs should not be used in general.
+
+=end original
+
+一般的に、チャンクされたPOST/PUTをなぜ使うべきではないかという理由があります。
+
+=begin original
+
+First, you cannot send chunked requests unless the peer server at the other end of the established TCP connection is known to be a HTTP/1.1 server.
+
+=end original
+
+まず、確立されたTCPの接続のもう一方の終端のピアサーバがHTTP/1.1のサーバとわかっていなければ、チャンクされたリクエストを送ることができません。
+
+=begin original
+
+Second, HTTP/1.1 servers disconnect their persistent connection quite quickly (compared to the time they wait for the first request), so it is not a good idea to post non-idempotent requests (e.g. POST, PUT, etc.) as a succeeding request over persistent connections.
+
+=end original
+
+次に、HTTP/1.1のサーバは永続的な接続を非常に速く切断します(最初のリクエストを待つ時間に比べて)。
+そのため、永続的な接続越しに、連続するリクエストとして不変でないリクエスト(例 POST,PUTなど)をポストするのは良くありません。
+
+=begin original
+
+These facts together makes using chunked requests virtually impossible (unless you _know_ that the server supports HTTP/1.1), and this is why we decided that supporting the feature is NOT of high priority.
+
+=end original
+
+これらの要因でチャンクされたリクエストを使うのは事実上不可能です(サーバがHTTP/1.1をサポートしているとわかっていなければ)。
+そのため、この機能のサポートは高いプライオリティではありません。
+
+=item 到達したレスポンスの内容をどのように作れますか?
+
+=begin original
+
+(How do you build the response content as it arrives?)
+
+=end original
+
+=begin original
+
+You can use L<IO::Callback> for this purpose.
+
+=end original
+
+そのためにL<IO::Callback>が使えます。
+
+    my $fh = IO::Callback->new(
+        '<',
+        sub {
+            my $x = shift @data;
+            $x ? "-$x" : undef;
+        }
+    );
+    my ( $code, $msg, $headers, $content ) =
+      $furl->put( "http://127.0.0.1:$port/", [ 'Content-Length' => $len ], $fh,
+      );
+
+=item gzip/deflate 圧縮されたコミュニケーションを使えますか?
+
+=begin original
+
+(How do you use gzip/deflate compressed communication?)
+
+=end original
+
+=begin original
+
+Add an B<Accept-Encoding> header to your request. Furl inflates response bodies transparently according to the B<Content-Encoding> response header.
+
+<<<<<<< /home/ktat/cvs/perldocjp/docs/modules/Furl-0.31//lib/Furl/HTTP.pod
+=end original
+
+B<Accept-Encoding>ヘッダをリクエストに追加してください。FurlレスポンスボディーをB<Content-Encoding>レスポンスヘッダに従って透過的にインフレートします。
+
+=item multipart/form-data を使うには?
+
+=begin original
+
+(How do you use multipart/form-data?)
+
+=begin original
+
+You can use multipart/form-data with L<HTTP::Request::Common>.
+
+=end original
+
+L<HTTP::Request::Common>を使って、multipart/form-dataを使えます。
+
+    use HTTP::Request::Common;
+
+    my $furl = Furl->new();
+    $req = POST 'http://www.perl.org/survey.cgi',
+      Content_Type => 'form-data',
+      Content      => [
+        name   => 'Hiromu Tokunaga',
+        email  => 'tokuh****@examp*****',
+        gender => 'F',
+        born   => '1978',
+        init   => ["$ENV{HOME}/.profile"],
+      ];
+    $furl->request($req);
+
+=begin original
+
+Native multipart/form-data support for L<Furl> is available if you can send a patch for me.
+
+=end original
+
+パッチを送ることができるなら、L<Furl>でネイティブのmultipart/form-dataサポートは利用可能です。
+
+=item Kee-Alive をどうやって使うのかとHEADメソッドでは何が起きるのか?
+
+=begin original
+
+(How do you use Keep-Alive and what happens on the HEAD method?)
+
+=end original
+
+=begin original
+
+Furl supports HTTP/1.1, hence C<Keep-Alive>. However, if you use the HEAD
+method, the connection is closed immediately.
+
+=end original
+
+FurlはHTTP/1.1をサポートします。従って、C<Keep-Alive>もサポートします。
+ですが、HEADメソッドで使っても、接続は即座に切断されます。
+
+=begin original
+
+RFC 2616 section 9.4 says:
+
+=end original
+
+RFC 2616 section 9.4 によると:
+
+=begin original
+
+    The HEAD method is identical to GET except that the server MUST NOT
+    return a message-body in the response.
+
+=end original
+
+    HEADメソッドは、サーバがレスポンスにメッセージボディを返さしてはいけないことを
+    除いて、GETメソッドと同一です。
+
+=begin original
+
+Some web applications, however, returns message bodies on the HEAD method,
+which might confuse C<Keep-Alive> processes, so Furl closes connection in
+such cases.
+
+=end original
+
+ですがWebアプリケーションによっては、HEADメソッドでメッセージボディを
+返すこともありますが、C<Kee-Alive>プロセスを混乱させます。そのためFurl
+はそのようなケースでは接続を閉じます。
+
+=begin original
+
+Anyway, the HEAD method is not so useful nowadays. The GET method and
+C<If-Modified-Sinse> are more suitable to cache HTTP contents.
+
+=end original
+
+いずれにせよ、HEADメソッドは、今日では、そんなに有用ではありません。GETメソッドと
+C<If-Modified-Sinse>のほうがHTTPコンテンツをキャッシュするのに合っています。
+
+=item なぜFurlはタイムアウトエラーを返すまで指定より長くかかるのですか?
+
+=begin original
+
+(Why does Furl take longer than specified until it returns a timeout error?)
+
+=end original
+
+=begin original
+
+Although Furl itself supports timeout, some underlying modules / functions do not. And the most noticeable one is L<Socket::inet_aton>, the function used for name resolution (a function that converts host names to IP addresses). If you need accurate and short timeout for name resolution, the use of L<Net::DNS::Lite> is recommended. The following code snippet describes how to use the module in conjunction with Furl.
+
+=end original
+
+Furl自身はタイムアウトをサポートしますが、基礎的なモジュールや関数はサポートしません。もっとも顕著な例としては、L<Socket::inet_aton>です。この関数は名前解決(ホストの名前からIPアドレスへの変換)に使われています。
+もし名前解決に正確で短かいタイムアウトが必要なら、L<Net::DNS::Lite>をお勧めします。下記のコードスニペットは、Furlでどのように使うかを説明しています。
+
+    use Net::DNS::Lite qw();
+
+    my $furl = Furl->new(
+        timeout   => $my_timeout_in_seconds,
+        inet_aton => sub { Net::DNS::Lite::inet_aton(@_) },
+    );
+
+=item ホスト名の代わりにHostヘッダを置き換えるには?
+
+=begin original
+
+How can I replace Host header instead of hostname?
+
+=end original
+
+=begin original
+
+Furl::HTTP does not provide a way to replace the Host header because such a design leads to security issues.
+
+=end original
+
+Furl::HTTP Hostヘッダを置き換える方法は提供していません。そのような設計は、セキュリティに問題を引き起こすからです。
+
+=begin original
+
+If you want to send HTTP requests to a dedicated server (or a UNIX socket), you should use the B<get_address> callback to designate the peer to which L<Furl> should connect as B<sockaddr>.
+
+=end original
+
+HTTPリクエストを特定のサーバ(か UNIXソケット)にリクエストしたいなら、L<Furl> は B<socketaddr> として接続すべきピアを指定する、B<get_address>コールバックを使うべきです。
+
+=begin original
+
+The example below sends all requests to 127.0.0.1:8080.
+
+=end original
+
+以下の例では、全てのリクエストを 127.0.0.1:8080 に送ります。
+
+    my $ua = Furl::HTTP->new(
+        get_address => sub {
+            my ($host, $port, $timeout) = @_;
+            sockaddr_in(8080, inet_aton("127.0.0.1"));
+        },
+    );
+
+    my ($minor_version, $code, $msg, $headers, $body) = $furl->request(
+        url => 'http://example.com/foo',
+        method => 'GET'
+    );
+
+=back
+
+=head1 TODO
+
+    - AnyEvent::Furl?
+    - ipv6 support
+    - better docs for NO_PROXY
+
+=head1 オプショナルな機能
+
+=begin original
+
+=head2 Internationalized Domain Name (IDN)
+
+=end original
+
+=head2 国際ドメイン名(IDN)
+
+=begin original
+
+This feature requires Net::IDN::Encode.
+
+=end original
+
+この機能は Net::IDN::Encode が必要です。
+
+=head2 SSL
+
+=begin original
+
+This feature requires IO::Socket::SSL.
+
+=end original
+
+この機能は IO::Socket::SSL が必要です。
+
+=head2 Content-Encoding (deflate, gzip)
+
+=begin original
+
+This feature requires Compress::Raw::Zlib.
+
+=end original
+
+この機能は Compress::Raw::Zlib が必要です。
+
+=head1 開発
+
+=begin original
+
+To setup your environment:
+
+=end original
+
+環境のセットアップ:
+
+    $ git clone http://github.com/tokuhirom/p5-Furl.git
+    $ cd p5-Furl
+
+=begin original
+
+To get picohttpparser:
+
+=end original
+
+picohttpparser の取得:
+
+    $ git submodule init
+    $ git submodule update
+
+    $ perl Makefile.PL
+    $ make
+    $ sudo make install
+
+=head2 貢献するには
+
+=begin original
+
+Please send the pull request via L<http://github.com/tokuhirom/p5-Furl/>.
+
+=end original
+
+L<http://github.com/tokuhirom/p5-Furl/> に pull request を送ってください。
+
+=head1 参照
+
+L<LWP>
+
+HTTP specs:
+L<http://www.w3.org/Protocols/HTTP/1.0/spec.html>
+L<http://www.w3.org/Protocols/HTTP/1.1/spec.html>
+
+=head1 LICENSE
+
+Copyright (C) Tokuhiro Matsuno.
+
+This library is free software; you can redistribute it and/or modify
+it under the same terms as Perl itself.
+
+
+=cut
+
Index: docs/modules/Furl-3.00/lib/Furl/Headers.pod
diff -u /dev/null docs/modules/Furl-3.00/lib/Furl/Headers.pod:1.1
--- /dev/null	Mon Nov 18 11:14:29 2013
+++ docs/modules/Furl-3.00/lib/Furl/Headers.pod	Mon Nov 18 11:14:29 2013
@@ -0,0 +1,168 @@
+=encoding utf-8
+
+=head1 名前
+
+=begin original
+
+Furl::Headers - HTTP Headers object
+
+=end original
+
+Furl::Headers - HTTPヘッダーオブジェクト
+
+=head1 概要
+
+=head1 コンストラクタ
+
+=over 4
+
+=item my $headers = Furl::Headers->new(\%headers);
+
+=begin original
+
+The constructor takes one argument. It is a hashref.
+Every key of hashref must be lower-cased.
+
+=end original
+
+コンストラクタはハッシュリファレンスの引数を一つとります。
+ハッシュリファレンスのすべてのキーは小文字でなければいけません。
+
+=begin original
+
+The format of the argument is like following:
+
+=end original
+
+引数のフォーマットは以下のようになります:
+
+    +{
+        'content-length' => [30],
+        'set-cookies'    => ['auth_token=; path=/; expires=Thu, 01 Jan 1970 00:00:00 GMT', '_twitter_sess=JKLJBNBLKSFJBLKSJBLKSJLKJFLSDJFjkDKFUFIOSDUFSDVjOTUzNzUwNTE2%250AZWFiMWRiNDZhMDcwOWEwMWQ5IgpmbGFzaElDOidBY3Rpb25Db250cm9sbGVy%250AOjpGbGFzaDo6Rmxhc2hIYXNoewAGOgpAdXNlZHsA--d9ce07496a22525bc178jlkhafklsdjflajfl411; domain=.twitter.com; path=/'],
+    }
+
+=back
+
+=head1 インスタンスメソッド
+
+=over 4
+
+=item my @values = $headers->header($key);
+
+=begin original
+
+Get the header value in array.
+
+=end original
+
+配列でヘッダの値をうけとります。
+
+=item my $values_joined = $headers->header($key);
+
+=begin original
+
+Get the header value in scalar. This is not a first value of header. This is same as:
+
+=end original
+
+スカラでヘッダの値をうけとります。これはヘッダの初めの値ではありません。次のものと同じです:
+
+    my $values = join(", ", $headers->header($key))
+
+=item $headers->header($key, $val);
+
+=item $headers->header($key, \@val);
+
+=begin original
+
+Set the new value of headers.
+
+=end original
+
+ヘッダに新しい値をセットします．
+
+=item $headers->remove_header($key);
+
+=begin original
+
+Delete key from headers.
+
+=end original
+
+ヘッダから値を削除します。
+
+=item my @h = $headers->flatten();
+
+=begin original
+
+Gets pairs of keys and values.
+
+=end original
+
+キーと値のペアを得ます。
+
+=item my @keys = $headers->keys();
+
+=item my @keys = $headers->header_field_names();
+
+=begin original
+
+Returns keys of headers in array. The return value do not contains duplicated value.
+
+=end original
+
+配列でヘッダのキーを返します。返り値は重複した値を返しません。
+
+=item my $str = $headers->as_string();
+
+=begin original
+
+Return the header fields as a formatted MIME header.
+
+=end original
+
+整形済みのMIMEヘッダとしてヘッダフィールドを返します。
+
+=item my $val = $headers->referer()
+
+=item my $val = $headers->expires()
+
+=item my $val = $headers->last_modified()
+
+=item my $val = $headers->if_modified_since()
+
+=item my $val = $headers->content_type()
+
+=item my $val = $headers->content_length()
+
+=item my $val = $headers->content_encoding()
+
+=begin original
+
+These methods are shortcut for popular headers.
+
+=end original
+
+これらのメソッドはポピュラーなヘッダのためのショートカットです。
+
+=back
+
+=item $headers->clone();
+
+=begin original
+
+Returns a copy of this "Furl::Headers" object.
+
+=end original
+
+"Furl::Headers" オブジェクトのコピーを返します。
+
+=back
+
+=head1 SEE ALSO
+
+L<HTTP::Headers>
+
+
+=cut
+
Index: docs/modules/Furl-3.00/lib/Furl/Request.pod
diff -u /dev/null docs/modules/Furl-3.00/lib/Furl/Request.pod:1.1
--- /dev/null	Mon Nov 18 11:14:29 2013
+++ docs/modules/Furl-3.00/lib/Furl/Request.pod	Mon Nov 18 11:14:29 2013
@@ -0,0 +1,166 @@
+=encoding utf-8
+
+=head1 NAME
+
+=begin original
+
+Furl::Request - Request object for Furl
+
+=end original
+
+Furl::Request - Furl のリクエストオブジェクト
+
+=head1 SYNOPSIS
+
+    my $f = Furl->new;
+    my $req = Furl::Request->new($method, $uri, $headers, $content);
+    my $res = $f->request($req);
+
+    print $req->request_line, "\n";
+    my $http_req = $req->as_http_request;
+    my $req_hash = $req->as_hashref;
+
+=head1 DESCRIPTION
+
+=begin original
+
+This is a HTTP request object in Furl.
+
+=end original
+
+Furl の HTTP リクエストオブジェクトです。
+
+=head1 CONSTRUCTOR
+
+    my $req = Furl::Request->new($method, $uri);
+    # or
+    my $req = Furl::Request->new($method, $uri, \%headers);
+    # or
+    my $req = Furl::Request->new($method, $uri, \%headers, $content);
+
+    # and
+
+    my $req = Furl::Request->parse($http_request_raw_string);
+
+=head1 INSTANCE METHODS
+
+(インスタンスメソッド)
+
+=over 4
+
+=item $req->method($method)
+
+=begin original
+
+Gets/Sets HTTP request method
+
+=end original
+
+HTTP リクエストメソッドを取得/セットします。
+
+=item $req->uri($uri)
+
+=begin original
+
+Gets/Sets request URI
+
+=end original
+
+リクエスト URI を取得/セットします。
+
+=item $req->headers($headers)
+
+=begin original
+
+Gets/Sets instance of L<Furl::Headers>
+
+=end original
+
+L<Furl::Headers> のインスタンスを取得/セットします。
+
+=item $req->content($content)
+
+=item $req->body($content)
+
+=begin original
+
+Gets/Sets request body in scalar.
+
+=end original
+
+スカラで、リクエストボディを取得/セットします。
+
+=item $req->protocol($protocol)
+
+    $req->protocol('HTTP/1.1');
+    print $req->protocol; #=> "HTTP/1.1"
+
+=begin original
+
+Gets/Sets HTTP protocol in string.
+
+=end original
+
+文字列で HTTP プロトコルを取得/セットします。
+
+=item $req->content_length
+
+=item $req->content_type
+
+=item $req->header
+
+=begin original
+
+Shorthand to access L<Furl::Headers>.
+
+=end original
+
+L<Furl::Headers>に速記でアクセスします。
+
+=item $req->as_http_request
+
+=begin original
+
+Make instance of L<HTTP::Request> from L<Furl::Request>.
+
+=end original
+
+L<Furl::Request> から L<HTTP::Request> のインスタンスを作ります。
+
+=item $req->as_hashref
+
+=begin original
+
+Convert request object to HashRef.
+
+=end original
+
+リクエストオブジェクトをハッシュリファレンスにします。
+
+=begin original
+
+Format is following:
+
+=end original
+
+フォマットは以下になります:
+
+    method: Str
+    uri: Str
+    protocol: Str
+    headers: ArrayRef[Str]
+    content: Str
+
+=item $req->request_line
+
+    print $req->request_line; #=> "GET / HTTP/1.1"
+
+=begin original
+
+Returns HTTP request line.
+
+=end original
+
+HTTP リクエストラインを返します。
+
+=back
Index: docs/modules/Furl-3.00/lib/Furl/Response.pod
diff -u /dev/null docs/modules/Furl-3.00/lib/Furl/Response.pod:1.1
--- /dev/null	Mon Nov 18 11:14:29 2013
+++ docs/modules/Furl-3.00/lib/Furl/Response.pod	Mon Nov 18 11:14:29 2013
@@ -0,0 +1,249 @@
+=encoding utf-8
+
+=begin original
+
+=for stopwords charsets
+
+=head1 NAME
+
+Furl::Response - Response object for Furl
+
+=end original
+
+Furl::Response - Furlのレスポンスオブジェクト
+
+=head1 概要
+
+    my $res = Furl::Response->new($minor_version, $code, $message, $headers, $content);
+    print $res->status, "\n";
+
+=head1 説明
+
+=begin original
+
+This is a HTTP response object in Furl.
+
+=end original
+
+これはFurl の HTTPレスポンスオブジェクトです。
+
+=head1 コンストラクタ
+
+    my $res = Furl::Response->new($minor_version, $code, $msg, \%headers, $content);
+
+=head1 インスタンスメソッド
+
+=over 4
+
+=item $res->code
+
+=item $res->status
+
+=begin original
+
+Returns HTTP status code.
+
+=end original
+
+HTTPステータスコードを返します。
+
+=item $res->message
+
+=begin original
+
+Returns HTTP status message.
+
+=end original
+
+HTTPステータスメッセージを返します。
+
+=item $res->headers
+
+=begin original
+
+Returns instance of L<Furl::Headers>
+
+=end original
+
+L<Furl::Headers>のインスタンスを返します。
+
+=item $res->content
+
+=item $res->body
+
+=begin original
+
+Returns response body in scalar.
+
+=end original
+
+レスポンスボディをスカラで返します。
+
+=item $res->decoded_content
+
+=begin original
+
+This will return the content after any C<< Content-Encoding >> and charsets have been decoded. See L<< HTTP::Message >> for details
+
+=end original
+
+これは、C<< Content-Encoding >> と文字セットがデコードされた後で、内容を返します。詳細は L<< HTTP::Message >> を見てください。
+
+=item $res->request
+
+=begin original
+
+Returns instance of L<Furl::Request> related this response.
+
+=end original
+
+レスポンスに関連する、L<Furl::Request> のインスタンスを返します。
+
+=item $res->content_length
+
+=item $res->content_type
+
+=item $res->content_encoding
+
+=item $res->header
+
+=begin original
+
+Shorthand to access L<Furl::Headers>.
+
+=end original
+
+L<Furl::Headers>へアクセスするためのショートハンドです。
+
+=item $res->protocol
+
+    $res->protocol(); # => "HTTP/1.1"
+
+=begin original
+
+Returns HTTP protocol in string.
+
+=end original
+
+HTTP プロトコルを文字列で返します。
+
+=item $res->as_http_response
+
+=begin original
+
+Make instance of L<HTTP::Response> from L<Furl::Response>.
+
+=end original
+
+L<Furl::Response>からL<HTTP::Response>のインスタンスを作ります。
+
+=item $res->to_psgi()
+
+=begin original
+
+Convert object to L<PSGI> response. It's very useful to make proxy.
+
+=end original
+
+L<PSGI> レスポンスのオブジェクトに変換します。プロキシを作るのにとても便利です。
+
+=item $res->as_hashref()
+
+=begin original
+
+Convert response object to HashRef.
+
+=end original
+
+レスポンスオブジェクトをハッシュリファレンスにします。
+
+=begin original
+
+Format is following:
+
+=end original
+
+フォーマットは以下になります:
+
+    code: Int
+    message: Str
+    protocol: Str
+    headers: ArrayRef[Str]
+    content: Str
+
+=item $res->is_success
+
+=begin original
+
+Returns true if status code is 2xx.
+
+=end original
+
+ステータスコードが2xxであれば、真を返します。
+
+=item $res->status_line
+
+
+    $res->status_line() # => "200 OK"
+
+=begin original
+
+Returns status line.
+
+=end original
+
+ステータスラインを返します。
+
+=item my $headers = $res->captured_req_headers() : Str
+
+=begin original
+
+Captured request headers in raw string.
+
+=end original
+
+キャプチャされた生の文字列のリクエストヘッダ。
+
+=begin original
+
+This method is only for debugging.
+
+=end original
+
+このメソッドはデバッグ用です。
+
+=begin original
+
+You can use this method if you are using C<< capture_request >> parameter is true.
+
+=end original
+
+C<< capture_request >> を真にして使っているなら、このメソッドを使うことができます。
+
+=item my $content = $res->captured_req_content() : Str
+
+=begin original
+
+Captured request content in raw string.
+
+=end original
+
+キャプチャされた生の文字列のリクエストの内容。
+
+=begin original
+
+This method is only for debugging.
+
+=end original
+
+このメソッドはデバッグ用です。
+
+=begin original
+
+You can use this method if you are using C<< capture_request >> parameter is true.
+
+=end original
+
+C<< capture_request >> を真にして使っているなら、このメソッドを使うことができます。
+
+=back

• 前の記事 [perldocjp-cvs 1844] CVS update: docs/modules/Furl-3.00/lib
• 記事の並び順: [ 日付 ] [ スレッド ] [ 件名 ] [ 著者 ]