検索結果

Net::HTTPHeader#each_value {|value| .... } -> () (37210.0)

• 2.5.0

• インスタンスメソッド

保持しているヘッダの値をブロックに渡し、呼びだします。

...値をブロックに渡し、呼びだします。

渡される文字列は ", " で連結したものです。

//emlist[例][ruby]{
require 'net/http'

uri = URI.parse('http://www.example.com/index.html')
req = Net::HTTP::Get.new(uri.request_uri)
req.each_value { |value| puts value }

# => gzip;...

• Net::HTTPHeader

Net::HTTP#keep_alive_timeout -> Integer (36610.0)

• 2.5.0

• インスタンスメソッド

以前のリクエストで使ったコネクションの再利用(keep-alive)を許可する秒数を 返します。

以前のリクエストで使ったコネクションの再利用(keep-alive)を許可する秒数を
返します。

デフォルトは2(秒)です。

@see Net::HTTP#keep_alive_timeout=

• Net::HTTP

Net::HTTP#keep_alive_timeout=(seconds) (36610.0)

• 2.5.0

• インスタンスメソッド

以前のリクエストで使ったコネクションの再利用(keep-alive)を許可する秒数を 設定します。

以前のリクエストで使ったコネクションの再利用(keep-alive)を許可する秒数を
設定します。

この秒数以内に同じホストに次のリクエストを送った場合、
ソケットを再利用します。

デフォルトは2(秒)です。これは一般的にサーバ側の keep-alive の秒数
が2秒である場合が多いからです。

@see Net::HTTP#keep_alive_timeout

• Net::HTTP

Net::HTTP#ssl_timeout -> Integer | nil (36610.0)

• 2.5.0

• インスタンスメソッド

SSL/TLS のタイムアウト秒数を返します。

SSL/TLS のタイムアウト秒数を返します。

設定されていない場合は nil を返します。

@see Net::HTTP#ssl_timeout=,
OpenSSL::SSL::SSLContext#ssl_timeout

• Net::HTTP

Net::HTTP#ssl_timeout=(sec) (36610.0)

• 2.5.0

• インスタンスメソッド

SSL/TLS のタイムアウト秒数を設定します。

SSL/TLS のタイムアウト秒数を設定します。

HTTP セッション開始時(Net::HTTP#start など)に
OpenSSL::SSL::SSLContext#ssl_timeout= で
タイムアウトを設定します。

デフォルト値は OpenSSL::SSL::SSLContext#ssl_timeout= と
同じで、OpenSSL のデフォルト値(300秒)を用います。

@param sec タイムアウト秒数
@see Net::HTTP#ssl_timeout,
OpenSSL::SSL::SSLContext#ssl_timeout=

• Net::HTTP

絞り込み条件を変える

Net::HTTP#unlock(path, body, initheader = nil) -> Net::HTTPResponse (36610.0)

• 2.5.0

• インスタンスメソッド

サーバの path に UNLOCK リクエストを ヘッダを initheader, ボディを body として送ります。

サーバの path に UNLOCK リクエストを
ヘッダを initheader, ボディを body として送ります。

レスポンスを Net::HTTPResponse のオブジェクト
で返します。

@param path リクエストを送るパスを文字列で与えます。
@param body リクエストのボディを文字列で与えます。
@param initheader リクエストのヘッダを「文字列=>文字列」の
ハッシュで与えます。
@see Net::HTTP::Unlock

• Net::HTTP
• Net::HTTP::Unlock
• Net::HTTPResponse

Net::HTTP#use_ssl=(bool) (36610.0)

• 2.5.0

• インスタンスメソッド

HTTP で SSL/TLS を使うかどうかを設定します。

HTTP で SSL/TLS を使うかどうかを設定します。

HTTPS 使う場合は true を設定します。
セッションを開始する前に設定をしなければなりません。

デフォルトでは false です。
つまり SSL/TLS を有効にするには必ず use_ssl = true を呼ぶ必要があります。

@param bool SSL/TLS を利用するかどうか
@raise IOError セッション開始後に設定を変更しようとすると発生します

• Net::HTTP

Net::HTTP#use_ssl? -> bool (36610.0)

• 2.5.0

• インスタンスメソッド

SSLを利用して接続する場合に真を返します。

...SSLを利用して接続する場合に真を返します。

@see net/https, openssl...

• Net::HTTP
• net/https
• openssl

Net::HTTPResponse#value -> nil (36610.0)

• 2.5.0

• インスタンスメソッド

レスポンスが 2xx(成功)でなかった場合に、対応する 例外を発生させます。

...スが 2xx(成功)でなかった場合に、対応する
例外を発生させます。

@raise HTTPError レスポンスが 1xx であるか、 net/http が知らない
種類のレスポンスである場合に発生します。
@raise HTTPRetriableError レスポンスが 3xx...

...レスポンスが 2xx(成功)][ruby]{
require 'net/http'

uri = "http://www.example.com/index.html"
response = Net::HTTP.get_response(URI.parse(uri))
response.value # => nil
//}

//emlist[例 レスポンスが 2xx以外][ruby]{
require 'net/http'

uri = "http://www.example.com/invalid.html"
respo...

• Net::HTTPResponse

Net::HTTPGenericRequest#request_body_permitted? -> bool (27610.0)

• 2.5.0

• インスタンスメソッド

リクエストにエンティティボディを一緒に送ることが許されている HTTP メソッド (POST など)の場合真を返します。

...ディを一緒に送ることが許されている
HTTP メソッド (POST など)の場合真を返します。

//emlist[例][ruby]{
require 'net/http'

uri = URI.parse('http://www.example.com/index.html')
post = Net::HTTP::Post.new(uri.request_uri)
post.request_body_permitted? # => true

head...

• Net::HTTPGenericRequest

絞り込み条件を変える

Net::HTTP#request(request, data = nil) -> Net::HTTPResponse (18910.0)

• 2.5.0

• インスタンスメソッド

Net::HTTPRequest オブジェクト request をサーバに送信します。

Net::HTTPRequest オブジェクト request をサーバに送信します。

POST/PUT の時は data も与えられます
(GET/HEAD などで data を与えると
ArgumentError を発生します)。

ブロックとともに呼びだされたときは
ソケットからボディを読みこまずに Net::HTTPResponse
オブジェクトをブロックに与えます。

@param request リクエストオブジェクトを与えます。
@param data リクエストのボディを文字列で与えます。

@raise ArgumentError dataを与えるべきでないリクエス...

• ArgumentError
• Net::HTTP
• Net::HTTPRequest
• Net::HTTPResponse

Net::HTTP#request(request, data = nil) {|response| .... } -> Net::HTTPResponse (18910.0)

• 2.5.0

• インスタンスメソッド

Net::HTTPRequest オブジェクト request をサーバに送信します。

Net::HTTPRequest オブジェクト request をサーバに送信します。

POST/PUT の時は data も与えられます
(GET/HEAD などで data を与えると
ArgumentError を発生します)。

ブロックとともに呼びだされたときは
ソケットからボディを読みこまずに Net::HTTPResponse
オブジェクトをブロックに与えます。

@param request リクエストオブジェクトを与えます。
@param data リクエストのボディを文字列で与えます。

@raise ArgumentError dataを与えるべきでないリクエス...

• ArgumentError
• Net::HTTP
• Net::HTTPRequest
• Net::HTTPResponse

Net::HTTP#continue_timeout -> Integer | nil (18610.0)

• 2.5.0

• インスタンスメソッド

「100 Continue」レスポンスを待つ秒数を返します。

「100 Continue」レスポンスを待つ秒数を返します。

この秒数待ってもレスポンスが来ない場合は
リクエストボディを送信します。

デフォルトは nil (待たない)です。

@see Net::HTTP#continue_timeout=

• Net::HTTP

Net::HTTP#open_timeout -> Integer|nil (18610.0)

• 2.5.0

• インスタンスメソッド

接続時に待つ最大秒数を返します。

接続時に待つ最大秒数を返します。

この秒数たってもコネクションが
開かなければ例外 Net::OpenTimeout を発生します。

デフォルトは 60 (秒)です。

@see Net::HTTP#read_timeout, Net::HTTP#open_timeout=

• Net::HTTP
• Net::OpenTimeout

Net::HTTP#proxy_uri -> String|nil (18610.0)

• 2.5.0

• インスタンスメソッド

このメソッドは内部用なので使わないでください。

このメソッドは内部用なので使わないでください。

環境変数 http_proxy から得られるプロクシの URI を返します。

• Net::HTTP

絞り込み条件を変える

Net::HTTP#proxy_user -> String|nil (18610.0)

• 2.5.0

• インスタンスメソッド

プロクシ経由で接続し、さらにプロクシのユーザ認証を する HTTP オブジェクトなら認証のユーザ名を を返します。

プロクシ経由で接続し、さらにプロクシのユーザ認証を
する HTTP オブジェクトなら認証のユーザ名を
を返します。

そうでないなら nil を返します。

@see Net::HTTP#proxy_pass, Net::HTTP#proxy_user=, Net::HTTP.new

• Net::HTTP

Net::HTTP#put(path, data, initheader = nil) -> Net::HTTPResponse (18610.0)

• 2.5.0

• インスタンスメソッド

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

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

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

@param path 取得するエンティティのパスを文字列で指定します。
@param data 送るデータを文字列で指定します。
@param initheader リクエストの HTTP ヘッダをハッシュで指定します。

@see Net::HTTP#request_put

1.1 互換モードの場合は、レスポンスに応じて例外が発生します。

• Net::HTTP
• Net::HTTPResponse

Net::HTTP#put2(path, data, initheader = nil) -> Net::HTTPResponse (18610.0)

• 2.5.0

• インスタンスメソッド

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

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

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

ブロックとともに呼び出されたときは、
ボディをソケットから読み出す前に、
接続を維持した状態で Net::HTTPResponse
オブジェクトをブロックに渡します。

@param path 取得するエンティティのパスを文字列で指定します。
@param data 送るデータを文字列で指定します。
@param initheader リクエストの HTTP ヘッダをハッシュで指定します。

put2 は時代遅れなので使わないでくださ...

• Net::HTTP
• Net::HTTPResponse

Net::HTTP#put2(path, data, initheader = nil) {|response| .... } -> Net::HTTPResponse (18610.0)

• 2.5.0

• インスタンスメソッド

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

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

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

ブロックとともに呼び出されたときは、
ボディをソケットから読み出す前に、
接続を維持した状態で Net::HTTPResponse
オブジェクトをブロックに渡します。

@param path 取得するエンティティのパスを文字列で指定します。
@param data 送るデータを文字列で指定します。
@param initheader リクエストの HTTP ヘッダをハッシュで指定します。

put2 は時代遅れなので使わないでくださ...

• Net::HTTP
• Net::HTTPResponse

Net::HTTP#read_timeout -> Integer|nil (18610.0)

• 2.5.0

• インスタンスメソッド

読みこみ(read(2)) 一回でブロックしてよい最大秒数 を返します。

読みこみ(read(2)) 一回でブロックしてよい最大秒数
を返します。

この秒数たっても読みこめなければ例外 Net::ReadTimeout
を発生します。

nilはタイムアウトしないことを意味します。

デフォルトは 60 (秒)です。

@see Net::HTTP#open_timeout, Net::HTTP#read_timeout=

• Net::HTTP
• Net::ReadTimeout

絞り込み条件を変える

Net::HTTP#request_put(path, data, initheader = nil) -> Net::HTTPResponse (18610.0)

• 2.5.0

• インスタンスメソッド

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

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

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

ブロックとともに呼び出されたときは、
ボディをソケットから読み出す前に、
接続を維持した状態で Net::HTTPResponse
オブジェクトをブロックに渡します。

@param path 取得するエンティティのパスを文字列で指定します。
@param data 送るデータを文字列で指定します。
@param initheader リクエストの HTTP ヘッダをハッシュで指定します。

put2 は時代遅れなので使わないでくださ...

• Net::HTTP
• Net::HTTPResponse

Net::HTTP#request_put(path, data, initheader = nil) {|response| .... } -> Net::HTTPResponse (18610.0)

• 2.5.0

• インスタンスメソッド

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

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

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

ブロックとともに呼び出されたときは、
ボディをソケットから読み出す前に、
接続を維持した状態で Net::HTTPResponse
オブジェクトをブロックに渡します。

@param path 取得するエンティティのパスを文字列で指定します。
@param data 送るデータを文字列で指定します。
@param initheader リクエストの HTTP ヘッダをハッシュで指定します。

put2 は時代遅れなので使わないでくださ...

• Net::HTTP
• Net::HTTPResponse

Net::HTTP#send_request(name, path, data = nil, header = nil) -> Net::HTTPResponse (18610.0)

• 2.5.0

• インスタンスメソッド

HTTP リクエストをサーバに送り、そのレスポンスを Net::HTTPResponse のインスタンスとして返します。

HTTP リクエストをサーバに送り、そのレスポンスを
Net::HTTPResponse のインスタンスとして返します。

@param name リクエストのメソッド名を文字列で与えます。
@param path リクエストのパスを文字列で与えます。
@param data リクエストのボディを文字列で与えます。
@param header リクエストのヘッダをハッシュで与えます。

//emlist[例][ruby]{
response = http.send_request('GET', '/index.html')
puts response.body
//}

@see Net::H...

• Net::HTTP
• Net::HTTPResponse

Net::HTTPHeader#canonical_each {|name, value| .... } -> () (18610.0)

• 2.5.0

• インスタンスメソッド

ヘッダフィールドの正規化名とその値のペアを ブロックに渡し、呼びだします。

ヘッダフィールドの正規化名とその値のペアを
ブロックに渡し、呼びだします。

正規化名は name に対し
name.downcase.split(/-/).capitalize.join('-')
で求まる文字列です。

• Net::HTTPHeader

Net::HTTPHeader#chunked? -> bool (18610.0)

• 2.5.0

• インスタンスメソッド

Transfer-Encoding: ヘッダフィールドが "chunked" である 場合に真を返します。

...ヘッダフィールドが存在しなかったり、
"chunked" 以外である場合には偽を返します。

//emlist[例][ruby]{
require 'net/http'

uri = URI.parse('http://www.example.com/index.html')
req = Net::HTTP::Get.new(uri.request_uri)
req.chunked? # => false
req["Transfer-Encoding"]...

• Net::HTTPHeader

絞り込み条件を変える

Net::HTTPHeader#each_capitalized {|name, value| .... } -> () (18610.0)

• 2.5.0

• インスタンスメソッド

ヘッダフィールドの正規化名とその値のペアを ブロックに渡し、呼びだします。

ヘッダフィールドの正規化名とその値のペアを
ブロックに渡し、呼びだします。

正規化名は name に対し
name.downcase.split(/-/).capitalize.join('-')
で求まる文字列です。

• Net::HTTPHeader

Net::HTTPHeader#sub_type -> String|nil (18610.0)

• 2.5.0

• インスタンスメソッド

"text/html" における "html" のようなサブタイプを表す 文字列を返します。

...タイプを表す
文字列を返します。

Content-Type: ヘッダフィールドが存在しない場合には nil を返します。

//emlist[例][ruby]{
require 'net/http'

uri = URI.parse('http://www.example.com/index.html')
res = Net::HTTP.get_response(uri)
res.sub_type # => "html"
//}...

• Net::HTTPHeader

Net::HTTP#request_get(path, header = nil) -> Net::HTTPResponse (9610.0)

• 2.5.0

• インスタンスメソッド

サーバ上の path にあるエンティティを取得します。 Net::HTTPResponse オブジェクトを返します。

サーバ上の path にあるエンティティを取得します。
Net::HTTPResponse オブジェクトを返します。

header が nil
でなければ、リクエストを送るときにその内容を HTTP ヘッダとして
送ります。 header は { 'Accept' = > '*/*', ... } という
形のハッシュでなければいけません。

ブロックとともに呼び出されたときは、
エンティティボディをソケットから読み出す前に、
接続を維持した状態で Net::HTTPResponse
オブジェクトをブロックに渡します。
大きなサイズのボディを一度に読みだすとまずく、
小さなサイズに分けて取...

• Net::HTTP
• Net::HTTPResponse

Net::HTTP#request_get(path, header = nil) {|response| .... } -> Net::HTTPResponse (9610.0)

• 2.5.0

• インスタンスメソッド

サーバ上の path にあるエンティティを取得します。 Net::HTTPResponse オブジェクトを返します。

サーバ上の path にあるエンティティを取得します。
Net::HTTPResponse オブジェクトを返します。

header が nil
でなければ、リクエストを送るときにその内容を HTTP ヘッダとして
送ります。 header は { 'Accept' = > '*/*', ... } という
形のハッシュでなければいけません。

ブロックとともに呼び出されたときは、
エンティティボディをソケットから読み出す前に、
接続を維持した状態で Net::HTTPResponse
オブジェクトをブロックに渡します。
大きなサイズのボディを一度に読みだすとまずく、
小さなサイズに分けて取...

• Net::HTTP
• Net::HTTPResponse

Net::HTTP#request_head(path, header = nil) -> Net::HTTPResponse (9610.0)

• 2.5.0

• インスタンスメソッド

サーバ上の path にあるエンティティのヘッダのみを取得します。 Net::HTTPResponse オブジェクトを返します。

サーバ上の path にあるエンティティのヘッダのみを取得します。
Net::HTTPResponse オブジェクトを返します。

header が nil
でなければ、リクエストを送るときにその内容を HTTP ヘッダとして
送ります。 header は { 'Accept' = > '*/*', ... } という
形のハッシュでなければいけません。

ブロックとともに呼び出されたときは、
Net::HTTP#request_get と同じ動作を
しますが、そもそもヘッダしか要求していないので
body は空です。そのためこの動作はそれほど意味はありません。

@param path ヘ...

• Net::HTTP
• Net::HTTPResponse

絞り込み条件を変える

Net::HTTP#request_head(path, header = nil) {|response| .... } -> Net::HTTPResponse (9610.0)

• 2.5.0

• インスタンスメソッド

サーバ上の path にあるエンティティのヘッダのみを取得します。 Net::HTTPResponse オブジェクトを返します。

サーバ上の path にあるエンティティのヘッダのみを取得します。
Net::HTTPResponse オブジェクトを返します。

header が nil
でなければ、リクエストを送るときにその内容を HTTP ヘッダとして
送ります。 header は { 'Accept' = > '*/*', ... } という
形のハッシュでなければいけません。

ブロックとともに呼び出されたときは、
Net::HTTP#request_get と同じ動作を
しますが、そもそもヘッダしか要求していないので
body は空です。そのためこの動作はそれほど意味はありません。

@param path ヘ...

• Net::HTTP
• Net::HTTPResponse

Net::HTTP#request_post(path, data, header = nil) -> Net::HTTPResponse (9610.0)

• 2.5.0

• インスタンスメソッド

サーバ上の path にあるエンティティに対し文字列 data を POST で送ります。 返り値は Net::HTTPResponse のインスタンスです。

サーバ上の path にあるエンティティに対し文字列 data を
POST で送ります。
返り値は Net::HTTPResponse のインスタンスです。

header が nil
でなければ、リクエストを送るときにその内容を HTTP ヘッダとして
送ります。 header は { 'Accept' = > '*/*', ... } という
形のハッシュでなければいけません。

ブロックとともに呼び出されたときは、
エンティティボディをソケットから読み出す前に、
接続を維持した状態で Net::HTTPResponse
オブジェクトをブロックに渡します。

POST する場合にはヘッ...

• Net::HTTP
• Net::HTTPResponse

Net::HTTP#request_post(path, data, header = nil) {|response| .... } -> Net::HTTPResponse (9610.0)

• 2.5.0

• インスタンスメソッド

サーバ上の path にあるエンティティに対し文字列 data を POST で送ります。 返り値は Net::HTTPResponse のインスタンスです。

サーバ上の path にあるエンティティに対し文字列 data を
POST で送ります。
返り値は Net::HTTPResponse のインスタンスです。

header が nil
でなければ、リクエストを送るときにその内容を HTTP ヘッダとして
送ります。 header は { 'Accept' = > '*/*', ... } という
形のハッシュでなければいけません。

ブロックとともに呼び出されたときは、
エンティティボディをソケットから読み出す前に、
接続を維持した状態で Net::HTTPResponse
オブジェクトをブロックに渡します。

POST する場合にはヘッ...

• Net::HTTP
• Net::HTTPResponse

Net::HTTPGenericRequest#body_exist? -> bool (9310.0)

• 2.5.0

• インスタンスメソッド

このメソッドは obsolete です。

このメソッドは obsolete です。


Net::HTTPGenericRequest#response_body_permitted?
の別名です。

• Net::HTTPGenericRequest

Net::HTTPGenericRequest#response_body_permitted? -> bool (9310.0)

• 2.5.0

• インスタンスメソッド

サーバからのレスポンスにエンティティボディを含むことが許されている HTTP メソッド (GET, POST など)の場合真を返します。

...ボディを含むことが許されている
HTTP メソッド (GET, POST など)の場合真を返します。

//emlist[例][ruby]{
require 'net/http'

uri = URI.parse('http://www.example.com/index.html')
post = Net::HTTP::Post.new(uri.request_uri)
post.response_body_permitted? # => true

head...

• Net::HTTPGenericRequest

絞り込み条件を変える

Net::HTTPHeader#fetch(key, default) -> String (610.0)

• 2.5.0

• インスタンスメソッド

key ヘッダフィールドを返します。

...key が存在する][ruby]{
require 'net/http'

uri = URI.parse('http://www.example.com/index.html')
req = Net::HTTP::Get.new(uri.request_uri)
req.fetch("user-agent") # => "Ruby"
//}

//emlist[例 key のみ指定。key が存在しない][ruby]{
require 'net/http'

begin
req.fetch("content-length...

...efault を指定][ruby]{
require 'net/http'

uri = URI.parse('http://www.example.com/index.html')
req = Net::HTTP::Get.new(uri.request_uri)
req.fetch("content-length", "default") # => "default"
//}

//emlist[例 key とブロックを指定][ruby]{
require 'net/http'

uri = URI.parse('http://www.exa...

• Net::HTTPHeader