Ruby 4.1 リファレンスマニュアル

instance method Net::HTTP#query

query(path, data, initheader = nil, dest = nil) -> Net::HTTPResponseRuby 4.1 から[permalink][rdoc][edit]
query(path, data, initheader = nil, dest = nil) {|body_segment| .... } -> Net::HTTPResponse

サーバ上の path にあるエンティティに対し文字列 data を QUERY メソッドで送ります。

返り値は Net::HTTPResponse のインスタンスです。

ブロックと一緒に呼びだされたときはエンティティボディを少しずつ文字列としてブロックに与えます。このとき戻り値の Net::HTTPResponse オブジェクトは有効な body を持ちません。

QUERY メソッドは安全 (safe) かつ冪等 (idempotent) で、キャッシュ可能な HTTP メソッドとして [RFC10008] で定義されています。リクエストの生成には Net::HTTP::Query オブジェクトが使われます。

dest は時代遅れの引数です。利用しないでください。 dest を指定した場合にはボディを少しずつ取得して順次「dest << ボディの断片」を実行します。

[PARAM] path:
リクエストを送るパスを文字列で指定します。
[PARAM] data:
送るデータを文字列で指定します。
[PARAM] initheader:
リクエストの HTTP ヘッダをハッシュで指定します。
[PARAM] dest:
利用しないでください。

[SEE_ALSO] Net::HTTP#request_query