種類
- インスタンスメソッド (123)
- 特異メソッド (22)
- 文書 (3)
- ライブラリ (1)
- モジュール (1)
ライブラリ
-
net
/ http (146)
クラス
-
Net
:: HTTP (113) -
Net
:: HTTPGenericRequest (4) -
Net
:: HTTPRequest (1) -
Net
:: HTTPResponse (3)
モジュール
-
Net
:: HTTPHeader (24)
キーワード
-
1
. 6 . 8から1 . 8 . 0への変更点(まとめ) (1) - HTTPHeader (1)
- Proxy (1)
- [] (1)
- []= (1)
-
add
_ field (1) - address (1)
-
basic
_ auth (1) - body (1)
- body= (1)
-
body
_ stream (1) -
body
_ stream= (1) -
ca
_ file (1) -
ca
_ file= (1) -
ca
_ path (1) -
ca
_ path= (1) - cert (1)
- cert= (1)
-
cert
_ store (1) -
cert
_ store= (1) - ciphers (1)
- ciphers= (1)
-
close
_ on _ empty _ response (1) -
close
_ on _ empty _ response= (1) -
content
_ length (1) -
content
_ length= (1) -
content
_ type= (1) -
continue
_ timeout (1) -
continue
_ timeout= (1) - copy (1)
- delete (2)
- fetch (3)
- finish (1)
-
form
_ data= (1) - get (4)
- get2 (2)
-
get
_ fields (1) -
get
_ print (2) -
get
_ response (2) - head (1)
- head2 (2)
-
is
_ version _ 1 _ 1? (1) -
is
_ version _ 1 _ 2? (1) -
keep
_ alive _ timeout (1) -
keep
_ alive _ timeout= (1) - key (1)
- key= (1)
- key? (1)
-
local
_ host (1) -
local
_ host= (1) -
local
_ port (1) -
local
_ port= (1) - lock (1)
- mkcol (1)
- move (1)
- new (2)
-
open
_ timeout (1) -
open
_ timeout= (1) - patch (2)
-
peer
_ cert (1) - post (2)
- post2 (2)
-
post
_ form (1) - propfind (1)
- proppatch (1)
- proxy? (1)
-
proxy
_ address (2) -
proxy
_ address= (1) -
proxy
_ basic _ auth (1) -
proxy
_ class? (1) -
proxy
_ from _ env= (1) -
proxy
_ from _ env? (1) -
proxy
_ pass (2) -
proxy
_ pass= (1) -
proxy
_ port (2) -
proxy
_ port= (1) -
proxy
_ user (2) -
proxy
_ user= (1) - proxyaddr (1)
- proxyport (1)
- put (1)
- put2 (2)
- range (1)
- range= (2)
-
range
_ length (1) -
read
_ body (2) -
read
_ timeout (1) -
read
_ timeout= (1) - request (2)
-
request
_ get (2) -
request
_ head (2) -
request
_ post (2) -
request
_ put (2) -
ruby 1
. 6 feature (1) -
ruby 1
. 8 . 3 feature (1) -
send
_ request (1) -
set
_ content _ type (1) -
set
_ debug _ output (1) -
set
_ form _ data (1) -
set
_ range (3) -
ssl
_ timeout (1) -
ssl
_ timeout= (1) -
ssl
_ version (1) -
ssl
_ version= (1) - start (4)
- trace (1)
- unlock (1)
-
use
_ ssl= (1) -
use
_ ssl? (1) - value (1)
-
verify
_ callback (1) -
verify
_ callback= (1) -
verify
_ depth (1) -
verify
_ depth= (1) -
version
_ 1 _ 1? (1) -
version
_ 1 _ 2 (1) -
version
_ 1 _ 2? (1)
検索結果
先頭5件
- net
/ http - Net
:: HTTP . start(address , port = 80 , proxy _ addr = :ENV , proxy _ port = nil , proxy _ user=nil , proxy _ pass=nil) -> Net :: HTTP - Net
:: HTTP . start(address , port = 80 , proxy _ addr = :ENV , proxy _ port = nil , proxy _ user=nil , proxy _ pass=nil) {|http| . . . . } -> object - Net
:: HTTPHeader # fetch(key) -> String - Net
:: HTTPHeader # fetch(key) {|hash| . . . . } -> String
-
net
/ http (114163.0) -
汎用データ転送プロトコル HTTP を扱うライブラリです。 実装は 2616 に基きます。
汎用データ転送プロトコル HTTP を扱うライブラリです。
実装は 2616 に基きます。
=== 使用例
==== ウェブサーバからドキュメントを得る (GET)
//emlist[例1: GET して 表示するだけ][ruby]{
require 'net/http'
print Net::HTTP.get('www.example.com', '/index.html')
//}
//emlist[例2: URI を使う][ruby]{
require 'net/http'
require 'uri'
print Net::HTTP.get(URI.parse('http://w... -
Net
:: HTTP . start(address , port = 80 , proxy _ addr = :ENV , proxy _ port = nil , proxy _ user=nil , proxy _ pass=nil) -> Net :: HTTP (24163.0) -
新しい Net::HTTP オブジェクトを生成し、 TCP コネクション、 HTTP セッションを開始します。
新しい Net::HTTP オブジェクトを生成し、
TCP コネクション、 HTTP セッションを開始します。
ブロックを与えた場合には生成したオブジェクトをそのブロックに
渡し、ブロックが終わったときに接続を閉じます。このときは
ブロックの値を返り値とします。
ブロックを与えなかった場合には生成したオブジェクトを渡します。
利用後にはこのオブジェクトを Net::HTTP#finish してください。
proxy_addr に :ENV を指定すると環境変数 http_proxy からプロクシの URI を
取り出し利用します。環境変数 http_proxy が定義されていない場合に... -
Net
:: HTTP . start(address , port = 80 , proxy _ addr = :ENV , proxy _ port = nil , proxy _ user=nil , proxy _ pass=nil) {|http| . . . . } -> object (24163.0) -
新しい Net::HTTP オブジェクトを生成し、 TCP コネクション、 HTTP セッションを開始します。
新しい Net::HTTP オブジェクトを生成し、
TCP コネクション、 HTTP セッションを開始します。
ブロックを与えた場合には生成したオブジェクトをそのブロックに
渡し、ブロックが終わったときに接続を閉じます。このときは
ブロックの値を返り値とします。
ブロックを与えなかった場合には生成したオブジェクトを渡します。
利用後にはこのオブジェクトを Net::HTTP#finish してください。
proxy_addr に :ENV を指定すると環境変数 http_proxy からプロクシの URI を
取り出し利用します。環境変数 http_proxy が定義されていない場合に... -
Net
:: HTTPHeader # fetch(key) -> String (24145.0) -
key ヘッダフィールドを返します。
key ヘッダフィールドを返します。
たとえばキー 'content-length' に対しては '2048'
のような文字列が得られます。キーが存在しなければ nil を返します。
該当するキーが登録されてい
ない時には、引数 default が与えられていればその値を、ブロッ
クが与えられていればそのブロックを評価した値を返します。
一種類のヘッダフィールドが一つのヘッダの中に複数存在する
場合にはそれを全て ", " で連結した文字列を返します。
key は大文字小文字を区別しません。
@param key ヘッダフィール名を文字列で与えます。
@param default 該... -
Net
:: HTTPHeader # fetch(key) {|hash| . . . . } -> String (24145.0) -
key ヘッダフィールドを返します。
key ヘッダフィールドを返します。
たとえばキー 'content-length' に対しては '2048'
のような文字列が得られます。キーが存在しなければ nil を返します。
該当するキーが登録されてい
ない時には、引数 default が与えられていればその値を、ブロッ
クが与えられていればそのブロックを評価した値を返します。
一種類のヘッダフィールドが一つのヘッダの中に複数存在する
場合にはそれを全て ", " で連結した文字列を返します。
key は大文字小文字を区別しません。
@param key ヘッダフィール名を文字列で与えます。
@param default 該... -
Net
:: HTTPHeader # fetch(key , default) -> String (24145.0) -
key ヘッダフィールドを返します。
key ヘッダフィールドを返します。
たとえばキー 'content-length' に対しては '2048'
のような文字列が得られます。キーが存在しなければ nil を返します。
該当するキーが登録されてい
ない時には、引数 default が与えられていればその値を、ブロッ
クが与えられていればそのブロックを評価した値を返します。
一種類のヘッダフィールドが一つのヘッダの中に複数存在する
場合にはそれを全て ", " で連結した文字列を返します。
key は大文字小文字を区別しません。
@param key ヘッダフィール名を文字列で与えます。
@param default 該... -
Net
:: HTTP . get _ print(host , path , port = 80) -> () (24127.0) -
指定した対象から HTTP でエンティティボディを取得し、 $stdout に出力します。
指定した対象から HTTP でエンティティボディを取得し、
$stdout に出力します。
対象の指定方法は URI で指定するか、
(host, path, port) で指定するかのいずれかです。
@param uri データの取得対象を URI で指定します。
@param host 接続先のホストを文字列で指定します。
@param path データの存在するパスを文字列で指定します。
@param port 接続するポートを整数で指定します。
@see Net::HTTP.get
=== 例
//emlist[][ruby]{
require 'net/http'
requi... -
Net
:: HTTP . get _ print(uri) -> () (24127.0) -
指定した対象から HTTP でエンティティボディを取得し、 $stdout に出力します。
指定した対象から HTTP でエンティティボディを取得し、
$stdout に出力します。
対象の指定方法は URI で指定するか、
(host, path, port) で指定するかのいずれかです。
@param uri データの取得対象を URI で指定します。
@param host 接続先のホストを文字列で指定します。
@param path データの存在するパスを文字列で指定します。
@param port 接続するポートを整数で指定します。
@see Net::HTTP.get
=== 例
//emlist[][ruby]{
require 'net/http'
requi... -
Net
:: HTTPResponse # value -> nil (24127.0) -
レスポンスが 2xx(成功)でなかった場合に、対応する 例外を発生させます。
レスポンスが 2xx(成功)でなかった場合に、対応する
例外を発生させます。
@raise HTTPError レスポンスが 1xx であるか、 net/http が知らない
種類のレスポンスである場合に発生します。
@raise HTTPRetriableError レスポンスが 3xx である場合に発生します。
@raise HTTPServerException レスポンスが 4xx である場合に発生します。
@raise HTTPFatalError レスポンスが 5xx である場合に発生します。
//emlist[例 レスポンスが 2xx(成功)... -
Net
:: HTTP # get(path , header = nil , dest = nil) -> Net :: HTTPResponse (24109.0) -
サーバ上の path にあるエンティティを取得し、 Net::HTTPResponse のインスタンスとして返します。
サーバ上の path にあるエンティティを取得し、
Net::HTTPResponse のインスタンスとして返します。
header が nil
でなければ、リクエストを送るときにその内容を HTTP ヘッダとして
送ります。 header は { 'Accept' = > '*/*', ... } という
形のハッシュでなければいけません。
ブロックと一緒に呼びだされたときは
エンティティボディを少しずつ文字列として
ブロックに与えます。このとき戻り値の
Net::HTTPResponse オブジェクトは有効な body を
持ちません。
dest は時代遅れの引数です。利用しない... -
Net
:: HTTP # get(path , header = nil , dest = nil) {|body _ segment| . . . . } -> Net :: HTTPResponse (24109.0) -
サーバ上の path にあるエンティティを取得し、 Net::HTTPResponse のインスタンスとして返します。
サーバ上の path にあるエンティティを取得し、
Net::HTTPResponse のインスタンスとして返します。
header が nil
でなければ、リクエストを送るときにその内容を HTTP ヘッダとして
送ります。 header は { 'Accept' = > '*/*', ... } という
形のハッシュでなければいけません。
ブロックと一緒に呼びだされたときは
エンティティボディを少しずつ文字列として
ブロックに与えます。このとき戻り値の
Net::HTTPResponse オブジェクトは有効な body を
持ちません。
dest は時代遅れの引数です。利用しない... -
Net
:: HTTP . new(address , port = 80 , proxy _ addr = :ENV , proxy _ port = nil , proxy _ user=nil , proxy _ pass=nil) -> Net :: HTTP (24109.0) -
新しい Net::HTTP オブジェクトを生成します。
新しい Net::HTTP オブジェクトを生成します。
proxy_addr に :ENV を指定すると自動的に環境変数 http_proxy からプロクシの URI を
取り出し利用します。この場合環境変数 http_proxy が定義されていない場合には
プロクシは利用せず直接接続します。
詳しくは URI::Generic#find_proxy を参照してください。
明示的にプロクシのホスト名とポート番号を指定してプロクシを利用することもできます。
このときには proxy_addr にホスト名もしくは IP アドレスを渡します。
このときに proxy_userを指定するとプロク... -
Net
:: HTTP # post(path , data , header = nil , dest = nil) -> Net :: HTTPResponse (24091.0) -
サーバ上の path にあるエンティティに対し文字列 data を POST で送ります。
サーバ上の path にあるエンティティに対し文字列 data を
POST で送ります。
返り値は Net::HTTPResponse のインスタンスです。
ブロックと一緒に呼びだされたときはエンティティボディを少しずつ文字列として
ブロックに与えます。このとき戻り値の HTTPResponse オブジェクトは有効な body を
持ちません。
POST する場合にはヘッダに Content-Type: を指定する必要があります。
もし header に指定しなかったならば、 Content-Type として
"application/x-www-form-urlencoded" を... -
Net
:: HTTP # post(path , data , header = nil , dest = nil) {|body _ segment| . . . . } -> Net :: HTTPResponse (24091.0) -
サーバ上の path にあるエンティティに対し文字列 data を POST で送ります。
サーバ上の path にあるエンティティに対し文字列 data を
POST で送ります。
返り値は Net::HTTPResponse のインスタンスです。
ブロックと一緒に呼びだされたときはエンティティボディを少しずつ文字列として
ブロックに与えます。このとき戻り値の HTTPResponse オブジェクトは有効な body を
持ちません。
POST する場合にはヘッダに Content-Type: を指定する必要があります。
もし header に指定しなかったならば、 Content-Type として
"application/x-www-form-urlencoded" を... -
Net
:: HTTP # send _ request(name , path , data = nil , header = nil) -> Net :: HTTPResponse (24091.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 . get(host , path , port = 80) -> String (24091.0) -
指定した対象に GET リクエストを送り、そのボディを 文字列として返します。
指定した対象に GET リクエストを送り、そのボディを
文字列として返します。
対象の指定方法は URI で指定するか、
(host, path, port) で指定するかのいずれかです。
@param uri データの取得対象を URI で指定します。
@param host 接続先のホストを文字列で指定します。
@param path データの存在するパスを文字列で指定します。
@param port 接続するポートを整数で指定します。
@see Net::HTTP#get -
Net
:: HTTP . get(uri) -> String (24091.0) -
指定した対象に GET リクエストを送り、そのボディを 文字列として返します。
指定した対象に GET リクエストを送り、そのボディを
文字列として返します。
対象の指定方法は URI で指定するか、
(host, path, port) で指定するかのいずれかです。
@param uri データの取得対象を URI で指定します。
@param host 接続先のホストを文字列で指定します。
@param path データの存在するパスを文字列で指定します。
@param port 接続するポートを整数で指定します。
@see Net::HTTP#get -
Net
:: HTTP . get _ response(host , path = nil , port = nil) -> Net :: HTTPResponse (24091.0) -
指定した対象に GET リクエストを送り、そのレスポンスを Net::HTTPResponse として返します。
指定した対象に GET リクエストを送り、そのレスポンスを
Net::HTTPResponse として返します。
対象の指定方法は URI で指定するか、
(host, path, port) で指定するかのいずれかです。
@param uri データの取得対象を URI で指定します。
@param host 接続先のホストを文字列で指定します。
@param path データの存在するパスを文字列で指定します。
@param port 接続するポートを整数で指定します。
@see Net::HTTP#get -
Net
:: HTTP . get _ response(uri) -> Net :: HTTPResponse (24091.0) -
指定した対象に GET リクエストを送り、そのレスポンスを Net::HTTPResponse として返します。
指定した対象に GET リクエストを送り、そのレスポンスを
Net::HTTPResponse として返します。
対象の指定方法は URI で指定するか、
(host, path, port) で指定するかのいずれかです。
@param uri データの取得対象を URI で指定します。
@param host 接続先のホストを文字列で指定します。
@param path データの存在するパスを文字列で指定します。
@param port 接続するポートを整数で指定します。
@see Net::HTTP#get -
Net
:: HTTP # head(path , header = nil) -> Net :: HTTPResponse (24073.0) -
サーバ上の path にあるエンティティのヘッダのみを取得します。 Net::HTTPResponse のインスタンスを返します。
サーバ上の path にあるエンティティのヘッダのみを取得します。
Net::HTTPResponse のインスタンスを返します。
header が nil
でなければ、リクエストを送るときにその内容を HTTP ヘッダとして
送ります。 header は { 'Accept' = > '*/*', ... } という
形のハッシュでなければいけません。
@param path 取得するエンティティのパスを文字列で指定します。
@param header リクエストの HTTP ヘッダをハッシュで指定します。
1.1 互換モードの場合は、レスポンスに応じて例外が発生します。
//em... -
Net
:: HTTP # local _ port=(port) (24073.0) -
接続に用いるローカルポートを設定します。
接続に用いるローカルポートを設定します。
nil の場合システムが適当にローカルポートを
決めます。
デフォルトは nil です。
@param port ローカルポート(数値、もしくはサービス名文字列)
//emlist[例][ruby]{
require 'net/http'
http = Net::HTTP.new("www.example.com")
http.local_host = "192.168.0.5"
http.local_port = "53043"
http.start do |h|
p h.get("/").body
end
//}
@see Net... -
Net
:: HTTP # lock(path , body , initheader = nil) -> Net :: HTTPResponse (24073.0) -
サーバの path に LOCK リクエストを ヘッダを initheader, ボディを body として送ります。
サーバの path に LOCK リクエストを
ヘッダを initheader, ボディを body として送ります。
レスポンスを Net::HTTPResponse のオブジェクト
で返します。
@param path リクエストを送るパスを文字列で与えます。
@param body リクエストのボディを文字列で与えます。
@param initheader リクエストのヘッダを「文字列=>文字列」の
ハッシュで与えます。
@see Net::HTTP::Lock -
Net
:: HTTP # mkcol(path , body , initheader = nil) -> Net :: HTTPResponse (24073.0) -
サーバの path に MKCOL リクエストを ヘッダが initheader, ボディを body として送ります。
サーバの path に MKCOL リクエストを
ヘッダが initheader, ボディを body として送ります。
レスポンスを Net::HTTPResponse のオブジェクト
で返します。
@param path リクエストを送るパスを文字列で与えます。
@param body リクエストのボディを文字列で与えます。
@param initheader リクエストのヘッダを「文字列=>文字列」の
ハッシュで与えます。
@see Net::HTTP::Mkcol -
Net
:: HTTP # move(path , body , initheader = nil) -> Net :: HTTPResponse (24073.0) -
サーバの path に MOVE リクエストを ヘッダが initheader, ボディを body として送ります。
サーバの path に MOVE リクエストを
ヘッダが initheader, ボディを body として送ります。
レスポンスを Net::HTTPResponse のオブジェクト
で返します。
@param path リクエストを送るパスを文字列で与えます。
@param body リクエストのボディを文字列で与えます。
@param initheader リクエストのヘッダを「文字列=>文字列」の
ハッシュで与えます。
@see Net::HTTP::Move -
Net
:: HTTP # post2(path , data , header = nil) -> Net :: HTTPResponse (24073.0) -
サーバ上の path にあるエンティティに対し文字列 data を POST で送ります。 返り値は Net::HTTPResponse のインスタンスです。
サーバ上の path にあるエンティティに対し文字列 data を
POST で送ります。
返り値は Net::HTTPResponse のインスタンスです。
header が nil
でなければ、リクエストを送るときにその内容を HTTP ヘッダとして
送ります。 header は { 'Accept' = > '*/*', ... } という
形のハッシュでなければいけません。
ブロックとともに呼び出されたときは、
エンティティボディをソケットから読み出す前に、
接続を維持した状態で Net::HTTPResponse
オブジェクトをブロックに渡します。
POST する場合にはヘッ... -
Net
:: HTTP # post2(path , data , header = nil) {|response| . . . . } -> Net :: HTTPResponse (24073.0) -
サーバ上の path にあるエンティティに対し文字列 data を POST で送ります。 返り値は Net::HTTPResponse のインスタンスです。
サーバ上の path にあるエンティティに対し文字列 data を
POST で送ります。
返り値は Net::HTTPResponse のインスタンスです。
header が nil
でなければ、リクエストを送るときにその内容を HTTP ヘッダとして
送ります。 header は { 'Accept' = > '*/*', ... } という
形のハッシュでなければいけません。
ブロックとともに呼び出されたときは、
エンティティボディをソケットから読み出す前に、
接続を維持した状態で Net::HTTPResponse
オブジェクトをブロックに渡します。
POST する場合にはヘッ... -
Net
:: HTTP # propfind(path , body , initheader = {& # 39;Depth& # 39; => & # 39;0& # 39;}) -> Net :: HTTPResponse (24073.0) -
サーバの path に PROPFIND リクエストを ヘッダを initheader, ボディを body として送ります。
サーバの path に PROPFIND リクエストを
ヘッダを initheader, ボディを body として送ります。
レスポンスを Net::HTTPResponse のオブジェクト
で返します。
@param path リクエストを送るパスを文字列で与えます。
@param body リクエストのボディを文字列で与えます。
@param initheader リクエストのヘッダを「文字列=>文字列」の
ハッシュで与えます。
@see Net::HTTP::Propfind -
Net
:: HTTP # proppatch(path , body , initheader = nil) -> Net :: HTTPResponse (24073.0) -
サーバの path に PROPPATCH リクエストを ヘッダを initheader, ボディを body として送ります。
サーバの path に PROPPATCH リクエストを
ヘッダを initheader, ボディを body として送ります。
レスポンスを Net::HTTPResponse のオブジェクト
で返します。
@param path リクエストを送るパスを文字列で与えます。
@param body リクエストのボディを文字列で与えます。
@param initheader リクエストのヘッダを「文字列=>文字列」の
ハッシュで与えます。
@see Net::HTTP::Proppatch -
Net
:: HTTP # put(path , data , initheader = nil) -> Net :: HTTPResponse (24073.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 (24073.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 (24073.0) -
サーバ上の path にあるエンティティに対し文字列 data を PUT で送ります。
サーバ上の path にあるエンティティに対し文字列 data を
PUT で送ります。
返り値は Net::HTTPResponse のインスタンスです。
ブロックとともに呼び出されたときは、
ボディをソケットから読み出す前に、
接続を維持した状態で Net::HTTPResponse
オブジェクトをブロックに渡します。
@param path 取得するエンティティのパスを文字列で指定します。
@param data 送るデータを文字列で指定します。
@param initheader リクエストの HTTP ヘッダをハッシュで指定します。
put2 は時代遅れなので使わないでくださ... -
Net
:: HTTP # request(request , data = nil) -> Net :: HTTPResponse (24073.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 (24073.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 _ post(path , data , header = nil) -> Net :: HTTPResponse (24073.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 (24073.0) -
サーバ上の path にあるエンティティに対し文字列 data を POST で送ります。 返り値は Net::HTTPResponse のインスタンスです。
サーバ上の path にあるエンティティに対し文字列 data を
POST で送ります。
返り値は Net::HTTPResponse のインスタンスです。
header が nil
でなければ、リクエストを送るときにその内容を HTTP ヘッダとして
送ります。 header は { 'Accept' = > '*/*', ... } という
形のハッシュでなければいけません。
ブロックとともに呼び出されたときは、
エンティティボディをソケットから読み出す前に、
接続を維持した状態で Net::HTTPResponse
オブジェクトをブロックに渡します。
POST する場合にはヘッ... -
Net
:: HTTP # request _ put(path , data , initheader = nil) -> Net :: HTTPResponse (24073.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 (24073.0) -
サーバ上の path にあるエンティティに対し文字列 data を PUT で送ります。
サーバ上の path にあるエンティティに対し文字列 data を
PUT で送ります。
返り値は Net::HTTPResponse のインスタンスです。
ブロックとともに呼び出されたときは、
ボディをソケットから読み出す前に、
接続を維持した状態で Net::HTTPResponse
オブジェクトをブロックに渡します。
@param path 取得するエンティティのパスを文字列で指定します。
@param data 送るデータを文字列で指定します。
@param initheader リクエストの HTTP ヘッダをハッシュで指定します。
put2 は時代遅れなので使わないでくださ... -
Net
:: HTTP # unlock(path , body , initheader = nil) -> Net :: HTTPResponse (24073.0) -
サーバの path に UNLOCK リクエストを ヘッダを initheader, ボディを body として送ります。
サーバの path に UNLOCK リクエストを
ヘッダを initheader, ボディを body として送ります。
レスポンスを Net::HTTPResponse のオブジェクト
で返します。
@param path リクエストを送るパスを文字列で与えます。
@param body リクエストのボディを文字列で与えます。
@param initheader リクエストのヘッダを「文字列=>文字列」の
ハッシュで与えます。
@see Net::HTTP::Unlock -
Net
:: HTTP . Proxy(address , port = 80) -> Class (24073.0) -
Proxy 経由で http サーバに接続するためのクラスを作成し返します。
Proxy 経由で http サーバに接続するためのクラスを作成し返します。
このクラスは Net::HTTP を継承しているので Net::HTTP と全く
同じように使えます。指定されたプロクシを常に経由して http サーバ
に接続します。
address が nil のときは Net::HTTP クラスをそのまま返します。
//emlist[例1: Net::HTTP.new を使う][ruby]{
require 'net/http'
proxy_class = Net::HTTP::Proxy('proxy.example.com', 8080)
http = proxy_... -
Net
:: HTTPHeader # []=(key , val) (24073.0) -
key ヘッダフィールドに文字列 val をセットします。
key ヘッダフィールドに文字列 val をセットします。
key に元々設定されていた値は破棄されます。
key は大文字小文字を区別しません。
val に nil を与えるとそのフィールドを削除します。
@param key ヘッダフィール名を文字列で与えます。
@param val keyで指定したフィールドにセットする文字列を与えます。
//emlist[例][ruby]{
require 'net/http'
uri = URI.parse('http://www.example.com/index.html')
req = Net::HTTP::Get.new(uri.re... -
Net
:: HTTPHeader # form _ data=(params) (24073.0) -
HTMLのフォームのデータ params から ヘッダフィールドとボディを設定します。
HTMLのフォームのデータ params から
ヘッダフィールドとボディを設定します。
ヘッダフィールド Content-Type: には
'application/x-www-form-urlencoded' が設定されます。
@param params HTML のフォームデータの Hash を与えます。
@param sep データのセパレータを文字列で与えます。
//emlist[例 form_data][ruby]{
require 'net/http'
uri = URI.parse('http://www.example.com/index.html')
req = Ne... -
Net
:: HTTPHeader # range=(n) (24073.0) -
範囲を指定してエンティティを取得するためのヘッダ Range: をセットします。
範囲を指定してエンティティを取得するためのヘッダ Range: をセットします。
以下は同じことを表しています。
//emlist[例][ruby]{
req.range = 0..1023
req.range = 0...1024
req.range = 1024
req.set_range(0, 1024)
req.set_range(0..1023)
req.set_range(0...1024)
req.set_range(1024)
//}
特別な場合として、
n に負数を与えた場合にnは最初から(-n)バイトまでの範囲を表します。
r を x..-1 とした場合には、x が... -
Net
:: HTTPHeader # range=(r) (24073.0) -
範囲を指定してエンティティを取得するためのヘッダ Range: をセットします。
範囲を指定してエンティティを取得するためのヘッダ Range: をセットします。
以下は同じことを表しています。
//emlist[例][ruby]{
req.range = 0..1023
req.range = 0...1024
req.range = 1024
req.set_range(0, 1024)
req.set_range(0..1023)
req.set_range(0...1024)
req.set_range(1024)
//}
特別な場合として、
n に負数を与えた場合にnは最初から(-n)バイトまでの範囲を表します。
r を x..-1 とした場合には、x が... -
Net
:: HTTPHeader # set _ form _ data(params , sep = & # 39;&& # 39;) -> () (24073.0) -
HTMLのフォームのデータ params から ヘッダフィールドとボディを設定します。
HTMLのフォームのデータ params から
ヘッダフィールドとボディを設定します。
ヘッダフィールド Content-Type: には
'application/x-www-form-urlencoded' が設定されます。
@param params HTML のフォームデータの Hash を与えます。
@param sep データのセパレータを文字列で与えます。
//emlist[例 form_data][ruby]{
require 'net/http'
uri = URI.parse('http://www.example.com/index.html')
req = Ne... -
Net
:: HTTPHeader # set _ range(i , len) -> () (24073.0) -
範囲を指定してエンティティを取得するためのヘッダ Range: をセットします。
範囲を指定してエンティティを取得するためのヘッダ Range: をセットします。
以下は同じことを表しています。
//emlist[例][ruby]{
req.range = 0..1023
req.range = 0...1024
req.range = 1024
req.set_range(0, 1024)
req.set_range(0..1023)
req.set_range(0...1024)
req.set_range(1024)
//}
特別な場合として、
n に負数を与えた場合にnは最初から(-n)バイトまでの範囲を表します。
r を x..-1 とした場合には、x が... -
Net
:: HTTPHeader # set _ range(n) -> () (24073.0) -
範囲を指定してエンティティを取得するためのヘッダ Range: をセットします。
範囲を指定してエンティティを取得するためのヘッダ Range: をセットします。
以下は同じことを表しています。
//emlist[例][ruby]{
req.range = 0..1023
req.range = 0...1024
req.range = 1024
req.set_range(0, 1024)
req.set_range(0..1023)
req.set_range(0...1024)
req.set_range(1024)
//}
特別な場合として、
n に負数を与えた場合にnは最初から(-n)バイトまでの範囲を表します。
r を x..-1 とした場合には、x が... -
Net
:: HTTPHeader # set _ range(r) -> () (24073.0) -
範囲を指定してエンティティを取得するためのヘッダ Range: をセットします。
範囲を指定してエンティティを取得するためのヘッダ Range: をセットします。
以下は同じことを表しています。
//emlist[例][ruby]{
req.range = 0..1023
req.range = 0...1024
req.range = 1024
req.set_range(0, 1024)
req.set_range(0..1023)
req.set_range(0...1024)
req.set_range(1024)
//}
特別な場合として、
n に負数を与えた場合にnは最初から(-n)バイトまでの範囲を表します。
r を x..-1 とした場合には、x が... -
Net
:: HTTPResponse # read _ body {|str| . . . . } -> () (24073.0) -
ブロックを与えなかった場合にはエンティティボディを 文字列で返します。 ブロックを与えた場合には エンティティボディを少しずつ取得して順次ブロックに 文字列で与えます。
ブロックを与えなかった場合にはエンティティボディを
文字列で返します。
ブロックを与えた場合には
エンティティボディを少しずつ取得して順次ブロックに
文字列で与えます。
レスポンスがボディを持たない場合には nil を返します。
//emlist[例1 ブロックを与えずに一度に結果取得][ruby]{
require 'net/http'
uri = "http://www.example.com/index.html"
response = Net::HTTP.get_response(URI.parse(uri))
response.read_body[0..10] # => "<... -
Net
:: HTTPResponse # read _ body(dest=nil) -> String|nil (24073.0) -
ブロックを与えなかった場合にはエンティティボディを 文字列で返します。 ブロックを与えた場合には エンティティボディを少しずつ取得して順次ブロックに 文字列で与えます。
ブロックを与えなかった場合にはエンティティボディを
文字列で返します。
ブロックを与えた場合には
エンティティボディを少しずつ取得して順次ブロックに
文字列で与えます。
レスポンスがボディを持たない場合には nil を返します。
//emlist[例1 ブロックを与えずに一度に結果取得][ruby]{
require 'net/http'
uri = "http://www.example.com/index.html"
response = Net::HTTP.get_response(URI.parse(uri))
response.read_body[0..10] # => "<... -
Net
:: HTTP # copy(path , initheader = nil) -> Net :: HTTPResponse (24055.0) -
サーバの path に COPY リクエストを ヘッダを initheader として送ります。
サーバの path に COPY リクエストを
ヘッダを initheader として送ります。
レスポンスを Net::HTTPResponse のオブジェクト
で返します。
@param path リクエストを送るパスを文字列で与えます。
@param initheader リクエストのヘッダを「文字列=>文字列」の
ハッシュで与えます。
@see Net::HTTP::Copy -
Net
:: HTTP # delete(path , initheader = nil) -> Net :: HTTPResponse (24055.0) -
サーバの path に DELETE リクエストを ヘッダを initheader として送ります。
サーバの path に DELETE リクエストを
ヘッダを initheader として送ります。
レスポンスを Net::HTTPResponse のオブジェクト
で返します。
@param path リクエストを送るパスを文字列で与えます。
@param initheader リクエストのヘッダを「文字列=>文字列」の
ハッシュで与えます。
@see Net::HTTP::Delete -
Net
:: HTTP # get2(path , header = nil) -> Net :: HTTPResponse (24055.0) -
サーバ上の path にあるエンティティを取得します。 Net::HTTPResponse オブジェクトを返します。
サーバ上の path にあるエンティティを取得します。
Net::HTTPResponse オブジェクトを返します。
header が nil
でなければ、リクエストを送るときにその内容を HTTP ヘッダとして
送ります。 header は { 'Accept' = > '*/*', ... } という
形のハッシュでなければいけません。
ブロックとともに呼び出されたときは、
エンティティボディをソケットから読み出す前に、
接続を維持した状態で Net::HTTPResponse
オブジェクトをブロックに渡します。
大きなサイズのボディを一度に読みだすとまずく、
小さなサイズに分けて取... -
Net
:: HTTP # get2(path , header = nil) {|response| . . . . } -> Net :: HTTPResponse (24055.0) -
サーバ上の path にあるエンティティを取得します。 Net::HTTPResponse オブジェクトを返します。
サーバ上の path にあるエンティティを取得します。
Net::HTTPResponse オブジェクトを返します。
header が nil
でなければ、リクエストを送るときにその内容を HTTP ヘッダとして
送ります。 header は { 'Accept' = > '*/*', ... } という
形のハッシュでなければいけません。
ブロックとともに呼び出されたときは、
エンティティボディをソケットから読み出す前に、
接続を維持した状態で Net::HTTPResponse
オブジェクトをブロックに渡します。
大きなサイズのボディを一度に読みだすとまずく、
小さなサイズに分けて取... -
Net
:: HTTP # head2(path , header = nil) -> Net :: HTTPResponse (24055.0) -
サーバ上の path にあるエンティティのヘッダのみを取得します。 Net::HTTPResponse オブジェクトを返します。
サーバ上の path にあるエンティティのヘッダのみを取得します。
Net::HTTPResponse オブジェクトを返します。
header が nil
でなければ、リクエストを送るときにその内容を HTTP ヘッダとして
送ります。 header は { 'Accept' = > '*/*', ... } という
形のハッシュでなければいけません。
ブロックとともに呼び出されたときは、
Net::HTTP#request_get と同じ動作を
しますが、そもそもヘッダしか要求していないので
body は空です。そのためこの動作はそれほど意味はありません。
@param path ヘ... -
Net
:: HTTP # head2(path , header = nil) {|response| . . . . } -> Net :: HTTPResponse (24055.0) -
サーバ上の path にあるエンティティのヘッダのみを取得します。 Net::HTTPResponse オブジェクトを返します。
サーバ上の path にあるエンティティのヘッダのみを取得します。
Net::HTTPResponse オブジェクトを返します。
header が nil
でなければ、リクエストを送るときにその内容を HTTP ヘッダとして
送ります。 header は { 'Accept' = > '*/*', ... } という
形のハッシュでなければいけません。
ブロックとともに呼び出されたときは、
Net::HTTP#request_get と同じ動作を
しますが、そもそもヘッダしか要求していないので
body は空です。そのためこの動作はそれほど意味はありません。
@param path ヘ... -
Net
:: HTTP # local _ host=(host) (24055.0) -
接続に用いるローカルホスト名を指定します。
接続に用いるローカルホスト名を指定します。
nil の場合システムが適当にローカルホストを
決めます。
デフォルトは nil です。
@param host ホスト名、もしくはアドレスを示す文字列
//emlist[例][ruby]{
require 'net/http'
http = Net::HTTP.new("www.example.com")
http.local_host = "192.168.0.5"
http.local_port = "53043"
http.start do |h|
p h.get("/").body
end
//}
@see Net::H... -
Net
:: HTTP # options(path , initheader = nil) -> Net :: HTTPResponse (24055.0) -
サーバの path に OPTIONS リクエストを ヘッダが initheader として送り、 レスポンスを Net::HTTPResponse のオブジェクト で返します。
サーバの path に OPTIONS リクエストを
ヘッダが initheader として送り、
レスポンスを Net::HTTPResponse のオブジェクト
で返します。
@param path リクエストを送るパスを文字列で与えます。
@param initheader リクエストのヘッダを「文字列=>文字列」の
ハッシュで与えます。
@see Net::HTTP::Options -
Net
:: HTTP # patch(path , data , initheader=nil , dest=nil) -> Net :: HTTPResponse (24055.0) -
サーバ上の path にあるエンティティに対し文字列 data を PATCH リクエストで送ります。
サーバ上の path にあるエンティティに対し文字列 data を
PATCH リクエストで送ります。
返り値は Net::HTTPResponse のインスタンスです。
ブロックと一緒に呼びだされたときはエンティティボディを少しずつ文字列として
ブロックに与えます。このとき戻り値の HTTPResponse オブジェクトは有効な body を
持ちません。
Dest は時代遅れの引数です。利用しないでください。
dest を指定した場合には
ボディを少しずつ取得して順次
「dest << ボディの断片」を実行します。
@param path POST先のパスを文字列で指定します。... -
Net
:: HTTP # patch(path , data , initheader=nil , dest=nil) {|body _ segment| . . . } -> Net :: HTTPResponse (24055.0) -
サーバ上の path にあるエンティティに対し文字列 data を PATCH リクエストで送ります。
サーバ上の path にあるエンティティに対し文字列 data を
PATCH リクエストで送ります。
返り値は Net::HTTPResponse のインスタンスです。
ブロックと一緒に呼びだされたときはエンティティボディを少しずつ文字列として
ブロックに与えます。このとき戻り値の HTTPResponse オブジェクトは有効な body を
持ちません。
Dest は時代遅れの引数です。利用しないでください。
dest を指定した場合には
ボディを少しずつ取得して順次
「dest << ボディの断片」を実行します。
@param path POST先のパスを文字列で指定します。... -
Net
:: HTTP # request _ get(path , header = nil) -> Net :: HTTPResponse (24055.0) -
サーバ上の path にあるエンティティを取得します。 Net::HTTPResponse オブジェクトを返します。
サーバ上の path にあるエンティティを取得します。
Net::HTTPResponse オブジェクトを返します。
header が nil
でなければ、リクエストを送るときにその内容を HTTP ヘッダとして
送ります。 header は { 'Accept' = > '*/*', ... } という
形のハッシュでなければいけません。
ブロックとともに呼び出されたときは、
エンティティボディをソケットから読み出す前に、
接続を維持した状態で Net::HTTPResponse
オブジェクトをブロックに渡します。
大きなサイズのボディを一度に読みだすとまずく、
小さなサイズに分けて取... -
Net
:: HTTP # request _ get(path , header = nil) {|response| . . . . } -> Net :: HTTPResponse (24055.0) -
サーバ上の path にあるエンティティを取得します。 Net::HTTPResponse オブジェクトを返します。
サーバ上の path にあるエンティティを取得します。
Net::HTTPResponse オブジェクトを返します。
header が nil
でなければ、リクエストを送るときにその内容を HTTP ヘッダとして
送ります。 header は { 'Accept' = > '*/*', ... } という
形のハッシュでなければいけません。
ブロックとともに呼び出されたときは、
エンティティボディをソケットから読み出す前に、
接続を維持した状態で Net::HTTPResponse
オブジェクトをブロックに渡します。
大きなサイズのボディを一度に読みだすとまずく、
小さなサイズに分けて取... -
Net
:: HTTP # request _ head(path , header = nil) -> Net :: HTTPResponse (24055.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 (24055.0) -
サーバ上の path にあるエンティティのヘッダのみを取得します。 Net::HTTPResponse オブジェクトを返します。
サーバ上の path にあるエンティティのヘッダのみを取得します。
Net::HTTPResponse オブジェクトを返します。
header が nil
でなければ、リクエストを送るときにその内容を HTTP ヘッダとして
送ります。 header は { 'Accept' = > '*/*', ... } という
形のハッシュでなければいけません。
ブロックとともに呼び出されたときは、
Net::HTTP#request_get と同じ動作を
しますが、そもそもヘッダしか要求していないので
body は空です。そのためこの動作はそれほど意味はありません。
@param path ヘ... -
Net
:: HTTP # trace(path , initheader = nil) -> Net :: HTTPResponse (24055.0) -
サーバの path に TRACE リクエストを ヘッダを initheader として送ります。
サーバの path に TRACE リクエストを
ヘッダを initheader として送ります。
レスポンスを Net::HTTPResponse のオブジェクト
で返します。
@param path リクエストを送るパスを文字列で与えます。
@param initheader リクエストのヘッダを「文字列=>文字列」の
ハッシュで与えます。
@see Net::HTTP::Trace -
Net
:: HTTPGenericRequest # body=(body) (24055.0) -
サーバに送るリクエストのエンティティボディを文字列で設定します。
サーバに送るリクエストのエンティティボディを文字列で設定します。
@param body 設定するボディを文字列で与えます。
//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" # => "Test Post Data"
//}
@see Net::HTTPGenericRequest#body -
Net
:: HTTPHeader # [](key) -> String|nil (24055.0) -
key ヘッダフィールドを返します。
key ヘッダフィールドを返します。
たとえばキー 'content-length' に対しては '2048'
のような文字列が得られます。キーが存在しなければ nil を返します。
//emlist[例][ruby]{
require 'net/http'
uri = URI.parse('http://www.example.com/index.html')
req = Net::HTTP::Get.new(uri.request_uri)
req['user-agent'] # => Ruby
//}
一種類のヘッダフィールドが一つのヘッダの中に複数存在する
場合にはそれを全て... -
Net
:: HTTPHeader # add _ field(key , val) -> () (24055.0) -
key ヘッダフィールドに val を追加します。
key ヘッダフィールドに val を追加します。
key に元々設定されていた値は破棄されず、それに val 追加されます。
@param key ヘッダフィール名を文字列で与えます。
@param val keyで指定したフィールドに追加する文字列を与えます。
@see Net::HTTPHeader#[] , Net::HTTPHeader#[]=,
Net::HTTPHeader#get_fields
//emlist[例][ruby]{
request.add_field 'X-My-Header', 'a'
p request['X-My-Header'] ... -
Net
:: HTTPHeader # basic _ auth(account , password) -> [String] (24055.0) -
Authorization: ヘッダを BASIC 認証用にセットします。
Authorization: ヘッダを BASIC 認証用にセットします。
@param account アカウント名を文字列で与えます。
@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 dXNlcjpwYXNz"]
//}... -
Net
:: HTTPHeader # content _ type=(type) (24055.0) -
type と params から Content-Type: ヘッダフィールドの 値を設定します。
type と params から Content-Type: ヘッダフィールドの
値を設定します。
@param type メディアタイプを文字列で指定します。
@param params パラメータ属性をハッシュで指定します。
//emlist[例][ruby]{
require 'net/http'
uri = URI.parse('http://www.example.com/index.html')
req = Net::HTTP::Get.new(uri.request_uri)
req.content_type # => ni... -
Net
:: HTTPHeader # delete(key) -> [String] | nil (24055.0) -
key ヘッダフィールドを削除します。
key ヘッダフィールドを削除します。
@param key 削除するフィールド名
@return 取り除かれたフィールドの値を返します。
key ヘッダフィールドが存在しなかった場合には
nil を返します。
//emlist[例][ruby]{
require 'net/http'
uri = URI.parse('http://www.example.com/index.html')
req = Net::HTTP::Get.new(uri.request_uri)
req.content_length = 10
req.content_length... -
Net
:: HTTPHeader # get _ fields(key) -> [String] (24055.0) -
key ヘッダフィールドの値 (文字列) を配列で返します。
key ヘッダフィールドの値 (文字列) を配列で返します。
たとえばキー 'content-length' に対しては ['2048'] のような
文字列が得られます。一種類のヘッダフィールドが一つのヘッダの中
に複数存在することがありえます。
key は大文字小文字を区別しません。
@param key ヘッダフィール名を文字列で与えます。
//emlist[例][ruby]{
require 'net/http'
uri = URI.parse('http://www.example.com/index.html')
res = Net::HTTP.get_response(ur... -
Net
:: HTTPHeader # proxy _ basic _ auth(account , password) -> [String] (24055.0) -
Proxy 認証のために Proxy-Authorization: ヘッダをセットします。
Proxy 認証のために Proxy-Authorization: ヘッダをセットします。
@param account アカウント名を文字列で与えます。
@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") # => ["Ba... -
Net
:: HTTPHeader # range -> Range|nil (24055.0) -
Range: ヘッダの示す範囲を Range オブジェクトで返します。
Range: ヘッダの示す範囲を Range オブジェクトで返します。
ヘッダにない場合は nil を返します。
@raise Net::HTTPHeaderSyntaxError Range:ヘッダの中身が規格通り
でない場合に発生します。
//emlist[例 正常な値][ruby]{
require 'net/http'
uri = URI.parse('http://www.example.com/index.html')
req = Net::HTTP::Get.new(uri.request_uri)
r... -
Net
:: HTTPHeader # set _ content _ type(type , params = {}) (24055.0) -
type と params から Content-Type: ヘッダフィールドの 値を設定します。
type と params から Content-Type: ヘッダフィールドの
値を設定します。
@param type メディアタイプを文字列で指定します。
@param params パラメータ属性をハッシュで指定します。
//emlist[例][ruby]{
require 'net/http'
uri = URI.parse('http://www.example.com/index.html')
req = Net::HTTP::Get.new(uri.request_uri)
req.content_type # => ni... -
Net
:: HTTP # ca _ file=(path) (24037.0) -
信頼する CA 証明書ファイルのパスを文字列で設定します。
信頼する CA 証明書ファイルのパスを文字列で設定します。
ファイルには複数の証明書を含んでいても構いません。
詳しくは OpenSSL::SSL::SSLContext#ca_file= を見てください。
デフォルトは nil (指定なし)です。
@param path ファイルパス文字列
@see Net::HTTP#ca_file, OpenSSL::SSL::SSLContext#ca_file= -
Net
:: HTTP # ca _ path=(path) (24037.0) -
信頼する CA 証明書ファイルが存在するディレクトリを設定します。
信頼する CA 証明書ファイルが存在するディレクトリを設定します。
ファイル名はハッシュ値の文字列にしなければなりません。
詳しくは OpenSSL::SSL::SSLContext#ca_path= を見てください。
デフォルトは nil (指定なし)です。
@param path ディレクトリ名文字列
@see Net::HTTP#ca_path, OpenSSL::SSL::SSLContext#ca_path= -
Net
:: HTTP # cert=(certificate) (24037.0) -
クライアント証明書を設定します。
クライアント証明書を設定します。
デフォルトは nil (クライアント証明書による認証をしない)です。
@param certificate 証明書オブジェクト(OpenSSL::X509::Certificate)
@see Net::HTTP#cert, OpenSSL::SSL::SSLContext#cert= -
Net
:: HTTP # ciphers=(ciphers) (24037.0) -
利用可能な共通鍵暗号を設定します。
利用可能な共通鍵暗号を設定します。
OpenSSL::SSL::SSLContext#ciphers= と同じ形式で
設定します。詳しくはそちらを参照してください。
@param ciphers 利用可能にする共通鍵暗号の種類
@see Net::HTTP#ciphers -
Net
:: HTTP # close _ on _ empty _ response=(bool) (24037.0) -
レスポンスがボディを持っていない場合にコネクションを 閉じるかどうかを設定します。
レスポンスがボディを持っていない場合にコネクションを
閉じるかどうかを設定します。
@param bool レスポンスがボディを持っていない場合にコネクションを
閉じるかどうか指定します。
@see Net::HTTP#close_on_empty_response -
Net
:: HTTP # continue _ timeout=(seconds) (24037.0) -
「100 Continue」レスポンスを待つ秒数を指定します。
「100 Continue」レスポンスを待つ秒数を指定します。
この秒数待ってもレスポンスが来ない場合は
リクエストボディを送信します。
デフォルトは nil (待たない)です。
@param seconds 秒数
@see Net::HTTP#continue_timeout -
Net
:: HTTP # key=(key) (24037.0) -
クライアント証明書の秘密鍵を設定します。
クライアント証明書の秘密鍵を設定します。
OpenSSL::PKey::RSA オブジェクトか
OpenSSL::PKey::DSA オブジェクトを設定します。
デフォルトは nil (鍵なし)です。
@param key 設定する秘密鍵
@see Net::HTTP#key,
OpenSSL::SSL::SSLContext#key= -
Net
:: HTTP # open _ timeout=(seconds) (24037.0) -
接続時に待つ最大秒数を設定します。
接続時に待つ最大秒数を設定します。
この秒数たってもコネクションが
開かなければ例外 Net::OpenTimeout を発生します。
nilを設定するとタイムアウトしなくなります。
以下のコネクションを開くメソッドで有効です。
* Net::HTTP.open
* Net::HTTP#start
@param second 待つ秒数を指定します。
@see Net::HTTP#read_timeout, Net::HTTP#open_timeout -
Net
:: HTTP # proxy _ address=(address) (24037.0) -
プロクシのアドレス(ホスト名、IPアドレス)を指定します。
プロクシのアドレス(ホスト名、IPアドレス)を指定します。
Net::HTTP#start で接続する前に設定する必要があります。
@param address プロクシのホスト名、もしくはIPアドレスを表す文字列
@see Net::HTTP#proxy_address=, Net::HTTP#proxy_port, Net::HTTP.new -
Net
:: HTTP # proxy _ from _ env=(boolean) (24037.0) -
プロクシ情報を環境変数から得るかどうかを指定します。
プロクシ情報を環境変数から得るかどうかを指定します。
Net::HTTP#start で接続する前に設定する必要があります。
@param boolean プロクシ情報を環境変数から得るかどうかを指定する真偽値
@see Net::HTTP#proxy_from_env? -
Net
:: HTTP # proxy _ pass=(pass) (24037.0) -
プロクシのユーザ認証のパスワードを設定します。
プロクシのユーザ認証のパスワードを設定します。
Net::HTTP#start で接続する前に設定する必要があります。
@param pass パスワード文字列
@see Net::HTTP#proxy_pass, Net::HTTP#proxy_user, Net::HTTP.new -
Net
:: HTTP # proxy _ port=(port) (24037.0) -
プロクシのポート番号を設定します。
プロクシのポート番号を設定します。
Net::HTTP#start で接続する前に設定する必要があります。
@param port ポート番号(整数、文字列)
@see Net::HTTP#proxy_port, Net::HTTP#proxy_address, Net::HTTP.new -
Net
:: HTTP # proxy _ user=(user) (24037.0) -
プロクシのユーザ認証のユーザ名を設定します。
プロクシのユーザ認証のユーザ名を設定します。
Net::HTTP#start で接続する前に設定する必要があります。
@param user ユーザ名文字列
@see Net::HTTP#proxy_pass, Net::HTTP#proxy_user, Net::HTTP.new -
Net
:: HTTP # read _ timeout=(seconds) (24037.0) -
読みこみ(read(2)) 一回でブロックしてよい最大秒数を 設定します。
読みこみ(read(2)) 一回でブロックしてよい最大秒数を
設定します。
この秒数たっても読みこめなければ例外 Net::ReadTimeout
を発生します。
nilを設定するとタイムアウトしなくなります。
このタイムアウト秒数はサーバとやりとりするメソッドで有効です。
デフォルトは 60 (秒)です。
@param second 待つ秒数を指定します。
@see Net::HTTP#open_timeout, Net::HTTP#read_timeout -
Net
:: HTTP # ssl _ timeout=(sec) (24037.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 # ssl _ version=(ver) (24037.0) -
利用するプロトコルの種類を指定します。
利用するプロトコルの種類を指定します。
OpenSSL::SSL::SSLContext.new で指定できるものと同じです。
@param ver 利用するプロトコルの種類(文字列 or シンボル)
@see Net::HTTP#ssl_version, OpenSSL::SSL::SSLContext#ssl_version= -
Net
:: HTTP # start -> self (24037.0) -
TCP コネクションを張り、HTTP セッションを開始します。 すでにセッションが開始していたら例外 IOError を発生します。
TCP コネクションを張り、HTTP セッションを開始します。
すでにセッションが開始していたら例外 IOError を発生します。
ブロックを与えた場合には自分自身をそのブロックに
渡し、ブロックが終わったときに接続を閉じます。このときは
ブロックの値を返り値とします。
ブロックを与えなかった場合には自分自身を返します。
利用後にはこのオブジェクトを Net::HTTP#finish してください。
@raise IOError すでにセッションが開始していた場合に発生します。
@raise Net::OpenTimeout 接続がタイムアウトしたときに発生します -
Net
:: HTTP # start {|http| . . . . } -> object (24037.0) -
TCP コネクションを張り、HTTP セッションを開始します。 すでにセッションが開始していたら例外 IOError を発生します。
TCP コネクションを張り、HTTP セッションを開始します。
すでにセッションが開始していたら例外 IOError を発生します。
ブロックを与えた場合には自分自身をそのブロックに
渡し、ブロックが終わったときに接続を閉じます。このときは
ブロックの値を返り値とします。
ブロックを与えなかった場合には自分自身を返します。
利用後にはこのオブジェクトを Net::HTTP#finish してください。
@raise IOError すでにセッションが開始していた場合に発生します。
@raise Net::OpenTimeout 接続がタイムアウトしたときに発生します -
Net
:: HTTP # use _ ssl=(bool) (24037.0) -
HTTP で SSL/TLS を使うかどうかを設定します。
HTTP で SSL/TLS を使うかどうかを設定します。
HTTPS 使う場合は true を設定します。
セッションを開始する前に設定をしなければなりません。
デフォルトでは false です。
つまり SSL/TLS を有効にするには必ず use_ssl = true を呼ぶ必要があります。
@param bool SSL/TLS を利用するかどうか
@raise IOError セッション開始後に設定を変更しようとすると発生します -
Net
:: HTTP # verify _ callback=(proc) (24037.0) -
検証をフィルタするコールバックを設定します。
検証をフィルタするコールバックを設定します。
詳しくは OpenSSL::X509::Store#verify_callback= や
OpenSSL::SSL::SSLContext#verify_callback= を見てください。
@param proc 設定する Proc オブジェクト
@see Net::HTTP#verify_callback,
OpenSSL::X509::Store#verify_callback=,
OpenSSL::SSL::SSLContext#verify_callback= -
Net
:: HTTP # verify _ depth=(depth) (24037.0) -
証明書チェイン上の検証する最大の深さを設定します。
証明書チェイン上の検証する最大の深さを設定します。
デフォルトは nil で、この場合 OpenSSL のデフォルト値(9)が使われます。
@param depth 最大深さを表す整数
@see Net::HTTP#verify_depth, OpenSSL::SSL::SSLContext#verify_depth= -
Net
:: HTTP . post _ form(uri , params) -> Net :: HTTPResponse (24037.0) -
URI で指定した対象に フォームのデータを HTTP で POST します。
URI で指定した対象に フォームのデータを HTTP で
POST します。
送るデータは params に文字列から文字列への Hash として
渡します。
@param uri POST する対象を URI で指定します。
@param params POST するデータです。 -
Net
:: HTTPGenericRequest # body -> String (24037.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::HTTPGenericRequest#body= -
Net
:: HTTPGenericRequest # body _ stream -> object (24037.0) -
サーバに送るリクエストのエンティティボディを IO オブジェクトなどのストリームで設定します。 f は read(size) メソッドが定義されている必要があります。
サーバに送るリクエストのエンティティボディを
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') d... -
Net
:: HTTPGenericRequest # body _ stream=(f) (24037.0) -
サーバに送るリクエストのエンティティボディを IO オブジェクトなどのストリームで設定します。 f は read(size) メソッドが定義されている必要があります。
サーバに送るリクエストのエンティティボディを
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') d... -
Net
:: HTTPHeader # content _ length -> Integer|nil (24037.0) -
Content-Length: ヘッダフィールドの表している値を整数で返します。
Content-Length: ヘッダフィールドの表している値を整数で返します。
ヘッダが設定されていない場合には nil を返します。
@raise Net::HTTPHeaderSyntaxError フィールドの値が不正である場合に
発生します。
//emlist[例][ruby]{
require 'net/http'
uri = URI.parse('http://www.example.com/index.html')
req = Net::HTTP::Get.new(uri.request_uri)
re...