class Net::HTTPPartialContent + Net::HTTPSuccess + Net::HTTPResponse
クラスの継承リスト: Net::HTTPPartialContent < Net::HTTPSuccess < Net::HTTPResponse < Net::HTTPHeader < Object < Kernel
要約
HTTP レスポンス 206 (Partial Content) を表現するクラスです。
詳しくは [RFC2616] を見てください。
特異メソッド
body_permitted? -> bool
-
エンティティボディを含むことが許されているレスポンスクラス ならば真を、そうでなければ偽を返します。
インスタンスメソッド
body -> String | () | nil
entity -> String | () | nil
-
エンティティボディを返します。
レスポンスにボディがない場合には nil を返します。
Net::HTTPResponse#read_body をブロック付きで呼んだ場合には このメソッドはNet::ReadAdapter のインスタンスを返しますが、 これは使わないでください。
entity は obsolete です。
code -> String
-
HTTP のリザルトコードです。例えば '302' などです。
この値を見ることでレスポンスの種類を判別できますが、 レスポンスオブジェクトがどのクラスのインスタンスかを 見ることでもレスポンスの種類を判別できます。
response -> self
header -> self
reader_header -> self
-
互換性を保つためだけに導入されたメソッドです。 使わないでください。
自分自身を返します。
http_version -> String
-
サーバがサポートしている HTTP のバージョンを文字列で返します。
message -> String
msg -> String
-
HTTP サーバがリザルトコードに付加して返すメッセージです。 例えば 'Not Found' などです。
msg は obsolete です。使わないでください。
read_body(dest=nil) -> String|nil
read_body {|str| .... } -> ()
-
ブロックを与えなかった場合にはエンティティボディを 文字列で返します。 ブロックを与えた場合には エンティティボディを少しずつ取得して順次ブロックに 文字列で与えます。
レスポンスがボディを持たない場合には nil を返します。
一度ブロックを与えずにこのメソッドを呼んだ場合には、 次からはすでに読みだしたボディを文字列として 返します。また一度ブロックを与えてこのメソッドを呼んだ場合には、 次からは Net::ReadAdapter のインスタンスが返ってきますが、 その場合はそのオブジェクトは使わないでください。
dest は obsolete です。使わないでください。 dest を指定した場合には ボディを少しずつ取得して順次 「dest << ボディの断片」を実行します。
- [PARAM] dest:
- obsoleteな引数です。利用しないでください。
to_ary -> [Net::HTTPResponse, String]
-
このメソッドは net/http.rb 1.1 との互換性のために存在します。
[self, self.body] を返します。
value -> nil
-
レスポンスが 2xx(成功)でなかった場合に、対応する 例外を発生させます。
- [EXCEPTION] HTTPError:
- レスポンスが 1xx であるか、 net/http が知らない 種類のレスポンスである場合に発生します。
- [EXCEPTION] HTTPRetriableError:
- レスポンスが 3xx である場合に発生します。
- [EXCEPTION] HTTPFatalError:
- レスポンスが 4xx である場合に発生します。
- [EXCEPTION] HTTPServerError:
- レスポンスが 5xx である場合に発生します。