クラス
-
Net
:: HTTP (24) -
Net
:: HTTPGenericRequest (7) -
Net
:: HTTPResponse (1)
モジュール
-
Net
:: HTTPHeader (8)
キーワード
-
basic
_ auth (1) - body (1)
-
body
_ exist? (1) -
body
_ stream (1) -
canonical
_ each (1) - chunked? (1)
-
continue
_ timeout (1) -
each
_ capitalized (1) -
each
_ value (1) - fetch (1)
-
keep
_ alive _ timeout (1) - method (1)
-
open
_ timeout (1) - path (1)
-
proxy
_ basic _ auth (1) -
proxy
_ uri (1) -
proxy
_ user (1) - put (1)
- put2 (2)
-
read
_ timeout (1) - request (2)
-
request
_ body _ permitted? (1) -
request
_ get (2) -
request
_ head (2) -
request
_ post (2) -
request
_ put (2) -
response
_ body _ permitted? (1) -
send
_ request (1) -
set
_ debug _ output (1) -
ssl
_ timeout (1) -
sub
_ type (1) - unlock (1)
-
use
_ ssl? (1) - value (1)
検索結果
先頭5件
-
Net
:: HTTPGenericRequest # request _ body _ permitted? -> bool (27610.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
:: HTTP # request(request , data = nil) -> Net :: HTTPResponse (18910.0) -
Net::HTTPRequest オブジェクト request をサーバに送信します。
Net::HTTPRequest オブジェクト request をサーバに送信します。
POST/PUT の時は data も与えられます
(GET/HEAD などで data を与えると
ArgumentError を発生します)。
ブロックとともに呼びだされたときは
ソケットからボディを読みこまずに Net::HTTPResponse
オブジェクトをブロックに与えます。
@param request リクエストオブジェクトを与えます。
@param data リクエストのボディを文字列で与えます。
@raise ArgumentError dataを与えるべきでないリクエス... -
Net
:: HTTP # request(request , data = nil) {|response| . . . . } -> Net :: HTTPResponse (18910.0) -
Net::HTTPRequest オブジェクト request をサーバに送信します。
Net::HTTPRequest オブジェクト request をサーバに送信します。
POST/PUT の時は data も与えられます
(GET/HEAD などで data を与えると
ArgumentError を発生します)。
ブロックとともに呼びだされたときは
ソケットからボディを読みこまずに Net::HTTPResponse
オブジェクトをブロックに与えます。
@param request リクエストオブジェクトを与えます。
@param data リクエストのボディを文字列で与えます。
@raise ArgumentError dataを与えるべきでないリクエス... -
Net
:: HTTPHeader # each _ value {|value| . . . . } -> () (18910.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
:: HTTP # continue _ timeout -> Integer | nil (18610.0) -
「100 Continue」レスポンスを待つ秒数を返します。
「100 Continue」レスポンスを待つ秒数を返します。
この秒数待ってもレスポンスが来ない場合は
リクエストボディを送信します。
デフォルトは nil (待たない)です。
@see Net::HTTP#continue_timeout= -
Net
:: HTTP # keep _ alive _ timeout -> Integer (18610.0) -
以前のリクエストで使ったコネクションの再利用(keep-alive)を許可する秒数を 返します。
以前のリクエストで使ったコネクションの再利用(keep-alive)を許可する秒数を
返します。
デフォルトは2(秒)です。
@see Net::HTTP#keep_alive_timeout= -
Net
:: HTTP # open _ timeout -> Integer|nil (18610.0) -
接続時に待つ最大秒数を返します。
接続時に待つ最大秒数を返します。
この秒数たってもコネクションが
開かなければ例外 Net::OpenTimeout を発生します。
デフォルトは 60 (秒)です。
@see Net::HTTP#read_timeout, Net::HTTP#open_timeout= -
Net
:: HTTP # proxy _ uri -> String|nil (18610.0) -
このメソッドは内部用なので使わないでください。
このメソッドは内部用なので使わないでください。
環境変数 http_proxy から得られるプロクシの URI を返します。 -
Net
:: HTTP # proxy _ user -> String|nil (18610.0) -
プロクシ経由で接続し、さらにプロクシのユーザ認証を する HTTP オブジェクトなら認証のユーザ名を を返します。
プロクシ経由で接続し、さらにプロクシのユーザ認証を
する HTTP オブジェクトなら認証のユーザ名を
を返します。
そうでないなら nil を返します。
@see Net::HTTP#proxy_pass, Net::HTTP#proxy_user=, Net::HTTP.new -
Net
:: HTTP # put(path , data , initheader = nil) -> Net :: HTTPResponse (18610.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 # put2(path , data , initheader = nil) -> Net :: HTTPResponse (18610.0) -
サーバ上の path にあるエンティティに対し文字列 data を PUT で送ります。
サーバ上の path にあるエンティティに対し文字列 data を
PUT で送ります。
返り値は Net::HTTPResponse のインスタンスです。
ブロックとともに呼び出されたときは、
ボディをソケットから読み出す前に、
接続を維持した状態で Net::HTTPResponse
オブジェクトをブロックに渡します。
@param path 取得するエンティティのパスを文字列で指定します。
@param data 送るデータを文字列で指定します。
@param initheader リクエストの HTTP ヘッダをハッシュで指定します。
put2 は時代遅れなので使わないでくださ... -
Net
:: HTTP # put2(path , data , initheader = nil) {|response| . . . . } -> Net :: HTTPResponse (18610.0) -
サーバ上の path にあるエンティティに対し文字列 data を PUT で送ります。
サーバ上の path にあるエンティティに対し文字列 data を
PUT で送ります。
返り値は Net::HTTPResponse のインスタンスです。
ブロックとともに呼び出されたときは、
ボディをソケットから読み出す前に、
接続を維持した状態で Net::HTTPResponse
オブジェクトをブロックに渡します。
@param path 取得するエンティティのパスを文字列で指定します。
@param data 送るデータを文字列で指定します。
@param initheader リクエストの HTTP ヘッダをハッシュで指定します。
put2 は時代遅れなので使わないでくださ... -
Net
:: HTTP # read _ timeout -> Integer|nil (18610.0) -
読みこみ(read(2)) 一回でブロックしてよい最大秒数 を返します。
読みこみ(read(2)) 一回でブロックしてよい最大秒数
を返します。
この秒数たっても読みこめなければ例外 Net::ReadTimeout
を発生します。
nilはタイムアウトしないことを意味します。
デフォルトは 60 (秒)です。
@see Net::HTTP#open_timeout, Net::HTTP#read_timeout= -
Net
:: HTTP # request _ put(path , data , initheader = nil) -> Net :: HTTPResponse (18610.0) -
サーバ上の path にあるエンティティに対し文字列 data を PUT で送ります。
サーバ上の path にあるエンティティに対し文字列 data を
PUT で送ります。
返り値は Net::HTTPResponse のインスタンスです。
ブロックとともに呼び出されたときは、
ボディをソケットから読み出す前に、
接続を維持した状態で Net::HTTPResponse
オブジェクトをブロックに渡します。
@param path 取得するエンティティのパスを文字列で指定します。
@param data 送るデータを文字列で指定します。
@param initheader リクエストの HTTP ヘッダをハッシュで指定します。
put2 は時代遅れなので使わないでくださ... -
Net
:: HTTP # request _ put(path , data , initheader = nil) {|response| . . . . } -> Net :: HTTPResponse (18610.0) -
サーバ上の path にあるエンティティに対し文字列 data を PUT で送ります。
サーバ上の path にあるエンティティに対し文字列 data を
PUT で送ります。
返り値は Net::HTTPResponse のインスタンスです。
ブロックとともに呼び出されたときは、
ボディをソケットから読み出す前に、
接続を維持した状態で Net::HTTPResponse
オブジェクトをブロックに渡します。
@param path 取得するエンティティのパスを文字列で指定します。
@param data 送るデータを文字列で指定します。
@param initheader リクエストの HTTP ヘッダをハッシュで指定します。
put2 は時代遅れなので使わないでくださ... -
Net
:: HTTP # send _ request(name , path , data = nil , header = nil) -> Net :: HTTPResponse (18610.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 # set _ debug _ output(io) -> () (18610.0) -
デバッグ出力の出力先を指定します。 このメソッドは深刻なセキュリティホールの原因 になるため、デバッグ以外では決して使わないでください。
デバッグ出力の出力先を指定します。
このメソッドは深刻なセキュリティホールの原因
になるため、デバッグ以外では決して使わないでください。
io に nil を指定するとデバッグ出力を止めます。
@param io 出力先を指定します。このオブジェクトは
メソッド << を持っている必要があります。
//emlist[例][ruby]{
http.set_debug_output($stderr)
//} -
Net
:: HTTP # ssl _ timeout -> Integer | nil (18610.0) -
SSL/TLS のタイムアウト秒数を返します。
SSL/TLS のタイムアウト秒数を返します。
設定されていない場合は nil を返します。
@see Net::HTTP#ssl_timeout=,
OpenSSL::SSL::SSLContext#ssl_timeout -
Net
:: HTTP # unlock(path , body , initheader = nil) -> Net :: HTTPResponse (18610.0) -
サーバの path に UNLOCK リクエストを ヘッダを initheader, ボディを body として送ります。
サーバの path に UNLOCK リクエストを
ヘッダを initheader, ボディを body として送ります。
レスポンスを Net::HTTPResponse のオブジェクト
で返します。
@param path リクエストを送るパスを文字列で与えます。
@param body リクエストのボディを文字列で与えます。
@param initheader リクエストのヘッダを「文字列=>文字列」の
ハッシュで与えます。
@see Net::HTTP::Unlock -
Net
:: HTTP # use _ ssl? -> bool (18610.0) -
SSLを利用して接続する場合に真を返します。
...SSLを利用して接続する場合に真を返します。
@see net/https, openssl... -
Net
:: HTTPHeader # basic _ auth(account , password) -> [String] (18610.0) -
Authorization: ヘッダを BASIC 認証用にセットします。
...unt アカウント名を文字列で与えます。
@param password パスワードを文字列で与えます。
//emlist[例][ruby]{
require 'net/http'
uri = URI.parse('http://www.example.com/index.html')
req = Net::HTTP::Get.new(uri.request_uri)
req.basic_auth("user", "pass") # => ["Basic dXNl... -
Net
:: HTTPHeader # chunked? -> bool (18610.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 # proxy _ basic _ auth(account , password) -> [String] (18610.0) -
Proxy 認証のために Proxy-Authorization: ヘッダをセットします。
...unt アカウント名を文字列で与えます。
@param password パスワードを文字列で与えます。
//emlist[例][ruby]{
require 'net/http'
uri = URI.parse('http://www.example.com/index.html')
req = Net::HTTP::Get.new(uri.request_uri)
req.proxy_basic_auth("account", "password") # =>... -
Net
:: HTTPHeader # sub _ type -> String|nil (18610.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
:: HTTPResponse # value -> nil (18610.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
:: HTTP # request _ get(path , header = nil) -> Net :: HTTPResponse (9628.0) -
サーバ上の path にあるエンティティを取得します。 Net::HTTPResponse オブジェクトを返します。
サーバ上の path にあるエンティティを取得します。
Net::HTTPResponse オブジェクトを返します。
header が nil
でなければ、リクエストを送るときにその内容を HTTP ヘッダとして
送ります。 header は { 'Accept' = > '*/*', ... } という
形のハッシュでなければいけません。
ブロックとともに呼び出されたときは、
エンティティボディをソケットから読み出す前に、
接続を維持した状態で Net::HTTPResponse
オブジェクトをブロックに渡します。
大きなサイズのボディを一度に読みだすとまずく、
小さなサイズに分けて取... -
Net
:: HTTP # request _ get(path , header = nil) {|response| . . . . } -> Net :: HTTPResponse (9628.0) -
サーバ上の path にあるエンティティを取得します。 Net::HTTPResponse オブジェクトを返します。
サーバ上の path にあるエンティティを取得します。
Net::HTTPResponse オブジェクトを返します。
header が nil
でなければ、リクエストを送るときにその内容を HTTP ヘッダとして
送ります。 header は { 'Accept' = > '*/*', ... } という
形のハッシュでなければいけません。
ブロックとともに呼び出されたときは、
エンティティボディをソケットから読み出す前に、
接続を維持した状態で Net::HTTPResponse
オブジェクトをブロックに渡します。
大きなサイズのボディを一度に読みだすとまずく、
小さなサイズに分けて取... -
Net
:: HTTP # request _ head(path , header = nil) -> Net :: HTTPResponse (9628.0) -
サーバ上の path にあるエンティティのヘッダのみを取得します。 Net::HTTPResponse オブジェクトを返します。
サーバ上の path にあるエンティティのヘッダのみを取得します。
Net::HTTPResponse オブジェクトを返します。
header が nil
でなければ、リクエストを送るときにその内容を HTTP ヘッダとして
送ります。 header は { 'Accept' = > '*/*', ... } という
形のハッシュでなければいけません。
ブロックとともに呼び出されたときは、
Net::HTTP#request_get と同じ動作を
しますが、そもそもヘッダしか要求していないので
body は空です。そのためこの動作はそれほど意味はありません。
@param path ヘ... -
Net
:: HTTP # request _ head(path , header = nil) {|response| . . . . } -> Net :: HTTPResponse (9628.0) -
サーバ上の path にあるエンティティのヘッダのみを取得します。 Net::HTTPResponse オブジェクトを返します。
サーバ上の path にあるエンティティのヘッダのみを取得します。
Net::HTTPResponse オブジェクトを返します。
header が nil
でなければ、リクエストを送るときにその内容を HTTP ヘッダとして
送ります。 header は { 'Accept' = > '*/*', ... } という
形のハッシュでなければいけません。
ブロックとともに呼び出されたときは、
Net::HTTP#request_get と同じ動作を
しますが、そもそもヘッダしか要求していないので
body は空です。そのためこの動作はそれほど意味はありません。
@param path ヘ... -
Net
:: HTTP # request _ post(path , data , header = nil) -> Net :: HTTPResponse (9628.0) -
サーバ上の path にあるエンティティに対し文字列 data を POST で送ります。 返り値は Net::HTTPResponse のインスタンスです。
サーバ上の path にあるエンティティに対し文字列 data を
POST で送ります。
返り値は Net::HTTPResponse のインスタンスです。
header が nil
でなければ、リクエストを送るときにその内容を HTTP ヘッダとして
送ります。 header は { 'Accept' = > '*/*', ... } という
形のハッシュでなければいけません。
ブロックとともに呼び出されたときは、
エンティティボディをソケットから読み出す前に、
接続を維持した状態で Net::HTTPResponse
オブジェクトをブロックに渡します。
POST する場合にはヘッ... -
Net
:: HTTP # request _ post(path , data , header = nil) {|response| . . . . } -> Net :: HTTPResponse (9628.0) -
サーバ上の path にあるエンティティに対し文字列 data を POST で送ります。 返り値は Net::HTTPResponse のインスタンスです。
サーバ上の path にあるエンティティに対し文字列 data を
POST で送ります。
返り値は Net::HTTPResponse のインスタンスです。
header が nil
でなければ、リクエストを送るときにその内容を HTTP ヘッダとして
送ります。 header は { 'Accept' = > '*/*', ... } という
形のハッシュでなければいけません。
ブロックとともに呼び出されたときは、
エンティティボディをソケットから読み出す前に、
接続を維持した状態で Net::HTTPResponse
オブジェクトをブロックに渡します。
POST する場合にはヘッ... -
Net
:: HTTPGenericRequest # body -> String (9310.0) -
サーバに送るリクエストのエンティティボディを返します。
...サーバに送るリクエストのエンティティボディを返します。
//emlist[例][ruby]{
require 'net/http'
uri = URI.parse('http://www.example.com/index.html')
req = Net::HTTP::Post.new(uri.request_uri)
req.body = "Test Post Data"
req.body # => "Test Post Data"
//}
@see Net::HTTPGe... -
Net
:: HTTPGenericRequest # body _ exist? -> bool (9310.0) -
このメソッドは obsolete です。
このメソッドは obsolete です。
Net::HTTPGenericRequest#response_body_permitted?
の別名です。 -
Net
:: HTTPGenericRequest # body _ stream -> object (9310.0) -
サーバに送るリクエストのエンティティボディを IO オブジェクトなどのストリームで設定します。 f は read(size) メソッドが定義されている必要があります。
...。
@param f エンティティボディのデータを得るストリームオブジェクトを与えます。
//emlist[例][ruby]{
require 'net/http'
uri = URI.parse('http://www.example.com/index.html')
post = Net::HTTP::Post.new(uri.request_uri)
File.open("/path/to/test", 'rb') do |f|
# 大... -
Net
:: HTTPGenericRequest # method -> String (9310.0) -
リクエストの HTTP メソッドを文字列で返します。
...リクエストの HTTP メソッドを文字列で返します。
//emlist[例][ruby]{
require 'net/http'
uri = URI.parse('http://www.example.com/index.html')
req = Net::HTTP::Post.new(uri.request_uri)
req.method # => "POST"
req = Net::HTTP::Get.new(uri.request_uri)
req.method # => "GET"
//}... -
Net
:: HTTPGenericRequest # path -> String (9310.0) -
リクエストする path を文字列で返します。
...リクエストする path を文字列で返します。
//emlist[例][ruby]{
require 'net/http'
uri = URI.parse('http://www.example.com/index.html')
req = Net::HTTP::Get.new(uri.request_uri)
req.path # => "/index.html"
//}... -
Net
:: HTTPGenericRequest # response _ body _ permitted? -> bool (9310.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
:: HTTPHeader # canonical _ each {|name , value| . . . . } -> () (610.0) -
ヘッダフィールドの正規化名とその値のペアを ブロックに渡し、呼びだします。
ヘッダフィールドの正規化名とその値のペアを
ブロックに渡し、呼びだします。
正規化名は name に対し
name.downcase.split(/-/).capitalize.join('-')
で求まる文字列です。 -
Net
:: HTTPHeader # each _ capitalized {|name , value| . . . . } -> () (610.0) -
ヘッダフィールドの正規化名とその値のペアを ブロックに渡し、呼びだします。
ヘッダフィールドの正規化名とその値のペアを
ブロックに渡し、呼びだします。
正規化名は name に対し
name.downcase.split(/-/).capitalize.join('-')
で求まる文字列です。 -
Net
:: HTTPHeader # fetch(key , default) -> String (610.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...