検索結果

net/http (114289.0)

• 3.3

• ライブラリ

汎用データ転送プロトコル 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...

• HTTPSession
• Net::HTTP
• Net::HTTP::Copy
• Net::HTTP::Delete
• Net::HTTP::Get
• Net::HTTP::Head
• Net::HTTP::Lock
• Net::HTTP::Mkcol
• Net::HTTP::Move
• Net::HTTP::Options
• Net::HTTP::Patch
• Net::HTTP::Post
• Net::HTTP::Propfind
• Net::HTTP::Proppatch
• Net::HTTP::Put
• Net::HTTP::Trace
• Net::HTTP::Unlock
• Net::HTTPAccepted
• Net::HTTPAlreadyReported
• Net::HTTPBadGateway
• ...

Net::HTTPExceptions#response -> Net::HTTPResponse (78694.0)

• 3.3

• インスタンスメソッド

例外の原因となったレスポンスオブジェクトを返します。

例外の原因となったレスポンスオブジェクトを返します。

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

uri = "http://www.example.com/invalid.html"
response = Net::HTTP.get_response(URI.parse(uri))
begin
response.value
rescue => e
e.response # => #<Net::HTTPNotFound 404 Not Found readbody=true>
end
//}

• Net::HTTPExceptions

Net::HTTPResponse#response -> self (78304.0)

• 3.3

• インスタンスメソッド

互換性を保つためだけに導入されたメソッドです。 使わないでください。

互換性を保つためだけに導入されたメソッドです。
使わないでください。

自分自身を返します。

• Net::HTTPResponse

Net::HTTP.get_response(host, path = nil, port = nil) -> Net::HTTPResponse (42607.0)

• 3.3

• 特異メソッド

指定した対象に 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
• Net::HTTPResponse
• URI

Net::HTTP.get_response(uri) -> Net::HTTPResponse (42607.0)

• 3.3

• 特異メソッド

指定した対象に 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
• Net::HTTPResponse
• URI

絞り込み条件を変える

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

• 3.3

• インスタンスメソッド

サーバからのレスポンスにエンティティボディを含むことが許されている 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::HTTP::Head.new(uri.request_uri)
head.r...

• Net::HTTPGenericRequest

Net::HTTP#close_on_empty_response -> bool (42322.0)

• 3.3

• インスタンスメソッド

レスポンスがボディを持っていない場合にコネクションを 閉じるかどうかを返します。

レスポンスがボディを持っていない場合にコネクションを
閉じるかどうかを返します。

デフォルトでは偽(閉じない)です。

@see Net::HTTP#close_on_empty_response=

• Net::HTTP

Net::HTTP#close_on_empty_response=(bool) (42322.0)

• 3.3

• インスタンスメソッド

レスポンスがボディを持っていない場合にコネクションを 閉じるかどうかを設定します。

レスポンスがボディを持っていない場合にコネクションを
閉じるかどうかを設定します。


@param bool レスポンスがボディを持っていない場合にコネクションを
閉じるかどうか指定します。

@see Net::HTTP#close_on_empty_response

• Net::HTTP

Net::HTTPBadResponse (42001.0)

• 3.3

• クラス

HTTP のレスポンスが不正であった場合に発生する例外です。

HTTP のレスポンスが不正であった場合に発生する例外です。

Net::HTTPResponse (42001.0)

• 3.3

• クラス

HTTP レスポンスを表現するクラスです。 Net::HTTP クラスは実際には HTTPResponse のサブクラスを返します。

HTTP レスポンスを表現するクラスです。
Net::HTTP クラスは実際には HTTPResponse のサブクラスを返します。

絞り込み条件を変える

Net::HTTPUnknownResponse (42001.0)

• 3.3

• クラス

このライブラリが知らないレスポンスを表現するクラスです。

このライブラリが知らないレスポンスを表現するクラスです。

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

• 3.3

• インスタンスメソッド

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

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

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

//emlist[例 レスポンスが 2xx(成功)...

• Net::HTTPResponse

Net::HTTPResponse#read_body {|str| .... } -> () (33127.0)

• 3.3

• インスタンスメソッド

ブロックを与えなかった場合にはエンティティボディを 文字列で返します。 ブロックを与えた場合には エンティティボディを少しずつ取得して順次ブロックに 文字列で与えます。

ブロックを与えなかった場合にはエンティティボディを
文字列で返します。
ブロックを与えた場合には
エンティティボディを少しずつ取得して順次ブロックに
文字列で与えます。

レスポンスがボディを持たない場合には 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

Net::HTTPResponse#read_body(dest=nil) -> String|nil (33127.0)

• 3.3

• インスタンスメソッド

ブロックを与えなかった場合にはエンティティボディを 文字列で返します。 ブロックを与えた場合には エンティティボディを少しずつ取得して順次ブロックに 文字列で与えます。

ブロックを与えなかった場合にはエンティティボディを
文字列で返します。
ブロックを与えた場合には
エンティティボディを少しずつ取得して順次ブロックに
文字列で与えます。

レスポンスがボディを持たない場合には 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

Net::HTTPResponse#body -> String | () | nil (33073.0)

• 3.3

• インスタンスメソッド

エンティティボディを返します。

エンティティボディを返します。

レスポンスにボディがない場合には nil を返します。

Net::HTTPResponse#read_body をブロック付きで呼んだ場合には
このメソッドはNet::ReadAdapter のインスタンスを返しますが、
これは使わないでください。

entity は obsolete です。

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

uri = "http://www.example.com/index.html"
response = Net::HTTP.get_response(URI.parse(uri))
r...

• Net::HTTPResponse

絞り込み条件を変える

Net::HTTPResponse#code -> String (33073.0)

• 3.3

• インスタンスメソッド

HTTP のリザルトコードです。例えば '302' などです。

HTTP のリザルトコードです。例えば '302' などです。

この値を見ることでレスポンスの種類を判別できますが、
レスポンスオブジェクトがどのクラスのインスタンスかを
見ることでもレスポンスの種類を判別できます。

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

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

• Net::HTTPResponse

Net::HTTPResponse#entity -> String | () | nil (33073.0)

• 3.3

• インスタンスメソッド

エンティティボディを返します。

エンティティボディを返します。

レスポンスにボディがない場合には nil を返します。

Net::HTTPResponse#read_body をブロック付きで呼んだ場合には
このメソッドはNet::ReadAdapter のインスタンスを返しますが、
これは使わないでください。

entity は obsolete です。

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

uri = "http://www.example.com/index.html"
response = Net::HTTP.get_response(URI.parse(uri))
r...

• Net::HTTPResponse

Net::HTTPResponse#http_version -> String (33073.0)

• 3.3

• インスタンスメソッド

サーバがサポートしている HTTP のバージョンを文字列で返します。

サーバがサポートしている HTTP のバージョンを文字列で返します。

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

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

• Net::HTTPResponse

Net::HTTPResponse#message -> String (33073.0)

• 3.3

• インスタンスメソッド

HTTP サーバがリザルトコードに付加して返すメッセージです。 例えば 'Not Found' などです。

HTTP サーバがリザルトコードに付加して返すメッセージです。
例えば 'Not Found' などです。

msg は obsolete です。使わないでください。

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

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

• Net::HTTPResponse

Net::HTTPResponse#msg -> String (33073.0)

• 3.3

• インスタンスメソッド

HTTP サーバがリザルトコードに付加して返すメッセージです。 例えば 'Not Found' などです。

HTTP サーバがリザルトコードに付加して返すメッセージです。
例えば 'Not Found' などです。

msg は obsolete です。使わないでください。

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

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

• Net::HTTPResponse

絞り込み条件を変える

Net::HTTPResponse.body_permitted? -> bool (33019.0)

• 3.3

• 特異メソッド

エンティティボディを含むことが許されているレスポンスクラス ならば真を、そうでなければ偽を返します。

エンティティボディを含むことが許されているレスポンスクラス
ならば真を、そうでなければ偽を返します。

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

Net::HTTPSuccess.body_permitted? # => true
Net::HTTPNotModified.body_permitted? # => false
//}

• Net::HTTPResponse

Net::HTTPResponse::CODE_CLASS_TO_OBJ -> Hash (33019.0)

• 3.3

• 定数

HTTP レスポンスステータスコードの最初の数字からレスポンスのクラス(分類)を あらわすクラスへのハッシュです。

HTTP レスポンスステータスコードの最初の数字からレスポンスのクラス(分類)を
あらわすクラスへのハッシュです。

//emlist[][ruby]{
require 'net/http'
Net::HTTPResponse::CODE_CLASS_TO_OBJ['3'] # => Net::HTTPRedirection
//}

• Net::HTTPResponse

Net::HTTPResponse::CODE_TO_OBJ -> Hash (33019.0)

• 3.3

• 定数

HTTP レスポンスステータスコードから対応するクラスへのハッシュです。

HTTP レスポンスステータスコードから対応するクラスへのハッシュです。

//emlist[][ruby]{
require 'net/http'
Net::HTTPResponse::CODE_TO_OBJ['404'] # => Net::HTTPNotFound
//}

• Net::HTTPResponse

Net::HTTPResponse#header -> self (33004.0)

• 3.3

• インスタンスメソッド

互換性を保つためだけに導入されたメソッドです。 使わないでください。

互換性を保つためだけに導入されたメソッドです。
使わないでください。

自分自身を返します。

• Net::HTTPResponse

Net::HTTPResponse#reader_header -> self (33004.0)

• 3.3

• インスタンスメソッド

互換性を保つためだけに導入されたメソッドです。 使わないでください。

互換性を保つためだけに導入されたメソッドです。
使わないでください。

自分自身を返します。

• Net::HTTPResponse

絞り込み条件を変える

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

• 3.3

• インスタンスメソッド

サーバ上の 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 (24733.0)

• 3.3

• インスタンスメソッド

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

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

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

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

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

• Net::HTTP
• Net::HTTPResponse

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

• 3.3

• インスタンスメソッド

サーバ上の 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 (24715.0)

• 3.3

• インスタンスメソッド

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

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

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

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

• Net::HTTP
• Net::HTTPResponse

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

• 3.3

• インスタンスメソッド

サーバ上の 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 (24643.0)

• 3.3

• インスタンスメソッド

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

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

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

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

@param path ヘ...

• Net::HTTP
• Net::HTTPResponse

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

• 3.3

• インスタンスメソッド

サーバ上の 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 (24607.0)

• 3.3

• インスタンスメソッド

サーバ上の 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(request, data = nil) {|response| .... } -> Net::HTTPResponse (24604.0)

• 3.3

• インスタンスメソッド

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#post2(path, data, header = nil) -> Net::HTTPResponse (24433.0)

• 3.3

• インスタンスメソッド

サーバ上の 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) -> Net::HTTPResponse (24433.0)

• 3.3

• インスタンスメソッド

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

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

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

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

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

• Net::HTTP
• Net::HTTPResponse

Net::HTTP#get2(path, header = nil) -> Net::HTTPResponse (24415.0)

• 3.3

• インスタンスメソッド

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

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

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

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

• Net::HTTP
• Net::HTTPResponse

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

• 3.3

• インスタンスメソッド

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

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

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

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

• Net::HTTP
• Net::HTTPResponse

Net::HTTP#get(path, header = nil, dest = nil) -> Net::HTTPResponse (24409.0)

• 3.3

• インスタンスメソッド

サーバ上の path にあるエンティティを取得し、 Net::HTTPResponse のインスタンスとして返します。

サーバ上の path にあるエンティティを取得し、
Net::HTTPResponse のインスタンスとして返します。

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

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

dest は時代遅れの引数です。利用しない...

• Net::HTTP
• Net::HTTPResponse

Net::HTTP#get(path, header = nil, dest = nil) {|body_segment| .... } -> Net::HTTPResponse (24409.0)

• 3.3

• インスタンスメソッド

サーバ上の path にあるエンティティを取得し、 Net::HTTPResponse のインスタンスとして返します。

サーバ上の path にあるエンティティを取得し、
Net::HTTPResponse のインスタンスとして返します。

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

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

dest は時代遅れの引数です。利用しない...

• Net::HTTP
• Net::HTTPResponse

絞り込み条件を変える

Net::HTTP#head(path, header = nil) -> Net::HTTPResponse (24373.0)

• 3.3

• インスタンスメソッド

サーバ上の path にあるエンティティのヘッダのみを取得します。 Net::HTTPResponse のインスタンスを返します。

サーバ上の path にあるエンティティのヘッダのみを取得します。
Net::HTTPResponse のインスタンスを返します。

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

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

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

//em...

• Net::HTTP
• Net::HTTPResponse

Net::HTTP#post(path, data, header = nil, dest = nil) -> Net::HTTPResponse (24355.0)

• 3.3

• インスタンスメソッド

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

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

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

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

POST する場合にはヘッダに Content-Type: を指定する必要があります。
もし header に指定しなかったならば、 Content-Type として
"application/x-www-form-urlencoded" を...

• Net::HTTP
• Net::HTTPResponse

Net::HTTP#post(path, data, header = nil, dest = nil) {|body_segment| .... } -> Net::HTTPResponse (24355.0)

• 3.3

• インスタンスメソッド

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

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

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

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

POST する場合にはヘッダに Content-Type: を指定する必要があります。
もし header に指定しなかったならば、 Content-Type として
"application/x-www-form-urlencoded" を...

• Net::HTTP
• Net::HTTPResponse

Net::HTTP#head2(path, header = nil) -> Net::HTTPResponse (24343.0)

• 3.3

• インスタンスメソッド

サーバ上の 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) -> Net::HTTPResponse (24343.0)

• 3.3

• インスタンスメソッド

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

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

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

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

@param path ヘ...

• Net::HTTP
• Net::HTTPResponse

絞り込み条件を変える

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

• 3.3

• インスタンスメソッド

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::HTTP#put2(path, data, initheader = nil) -> Net::HTTPResponse (24307.0)

• 3.3

• インスタンスメソッド

サーバ上の 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) -> Net::HTTPResponse (24307.0)

• 3.3

• インスタンスメソッド

サーバ上の 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(request, data = nil) -> Net::HTTPResponse (24304.0)

• 3.3

• インスタンスメソッド

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#copy(path, initheader = nil) -> Net::HTTPResponse (24301.0)

• 3.3

• インスタンスメソッド

サーバの path に COPY リクエストを ヘッダを initheader として送ります。

サーバの path に COPY リクエストを
ヘッダを initheader として送ります。

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

@param path リクエストを送るパスを文字列で与えます。
@param initheader リクエストのヘッダを「文字列=>文字列」の
ハッシュで与えます。

@see Net::HTTP::Copy

• Net::HTTP
• Net::HTTP::Copy
• Net::HTTPResponse

絞り込み条件を変える

Net::HTTP#delete(path, initheader = nil) -> Net::HTTPResponse (24301.0)

• 3.3

• インスタンスメソッド

サーバの path に DELETE リクエストを ヘッダを initheader として送ります。

サーバの path に DELETE リクエストを
ヘッダを initheader として送ります。

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

@param path リクエストを送るパスを文字列で与えます。
@param initheader リクエストのヘッダを「文字列=>文字列」の
ハッシュで与えます。

@see Net::HTTP::Delete

• Net::HTTP
• Net::HTTP::Delete
• Net::HTTPResponse

Net::HTTP#lock(path, body, initheader = nil) -> Net::HTTPResponse (24301.0)

• 3.3

• インスタンスメソッド

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

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

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

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

@see Net::HTTP::Lock

• Net::HTTP
• Net::HTTP::Lock
• Net::HTTPResponse

Net::HTTP#mkcol(path, body, initheader = nil) -> Net::HTTPResponse (24301.0)

• 3.3

• インスタンスメソッド

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

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

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

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

@see Net::HTTP::Mkcol

• Net::HTTP
• Net::HTTP::Mkcol
• Net::HTTPResponse

Net::HTTP#move(path, body, initheader = nil) -> Net::HTTPResponse (24301.0)

• 3.3

• インスタンスメソッド

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

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

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

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

@see Net::HTTP::Move

• Net::HTTP
• Net::HTTP::Move
• Net::HTTPResponse

Net::HTTP#options(path, initheader = nil) -> Net::HTTPResponse (24301.0)

• 3.3

• インスタンスメソッド

サーバの path に OPTIONS リクエストを ヘッダが initheader として送り、 レスポンスを Net::HTTPResponse のオブジェクト で返します。

サーバの path に OPTIONS リクエストを
ヘッダが initheader として送り、
レスポンスを Net::HTTPResponse のオブジェクト
で返します。

@param path リクエストを送るパスを文字列で与えます。
@param initheader リクエストのヘッダを「文字列=>文字列」の
ハッシュで与えます。

@see Net::HTTP::Options

• Net::HTTP
• Net::HTTP::Options
• Net::HTTPResponse

絞り込み条件を変える

Net::HTTP#patch(path, data, initheader=nil, dest=nil) -> Net::HTTPResponse (24301.0)

• 3.3

• インスタンスメソッド

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

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

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

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


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

@param path POST先のパスを文字列で指定します。...

• Net::HTTP
• Net::HTTPResponse

Net::HTTP#patch(path, data, initheader=nil, dest=nil) {|body_segment| ... } -> Net::HTTPResponse (24301.0)

• 3.3

• インスタンスメソッド

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

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

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

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


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

@param path POST先のパスを文字列で指定します。...

• Net::HTTP
• Net::HTTPResponse

Net::HTTP#propfind(path, body, initheader = {&#39;Depth&#39; => &#39;0&#39;}) -> Net::HTTPResponse (24301.0)

• 3.3

• インスタンスメソッド

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

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

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

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

@see Net::HTTP::Propfind

• Net::HTTP
• Net::HTTP::Propfind
• Net::HTTPResponse

Net::HTTP#proppatch(path, body, initheader = nil) -> Net::HTTPResponse (24301.0)

• 3.3

• インスタンスメソッド

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

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

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

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

@see Net::HTTP::Proppatch

• Net::HTTP
• Net::HTTP::Proppatch
• Net::HTTPResponse

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

• 3.3

• インスタンスメソッド

サーバ上の 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#trace(path, initheader = nil) -> Net::HTTPResponse (24301.0)

• 3.3

• インスタンスメソッド

サーバの path に TRACE リクエストを ヘッダを initheader として送ります。

サーバの path に TRACE リクエストを
ヘッダを initheader として送ります。

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

@param path リクエストを送るパスを文字列で与えます。
@param initheader リクエストのヘッダを「文字列=>文字列」の
ハッシュで与えます。

@see Net::HTTP::Trace

• Net::HTTP
• Net::HTTP::Trace
• Net::HTTPResponse

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

• 3.3

• インスタンスメソッド

サーバの 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.post_form(uri, params) -> Net::HTTPResponse (24301.0)

• 3.3

• 特異メソッド

URI で指定した対象に フォームのデータを HTTP で POST します。

URI で指定した対象に フォームのデータを HTTP で
POST します。

送るデータは params に文字列から文字列への Hash として
渡します。

@param uri POST する対象を URI で指定します。
@param params POST するデータです。

• Hash
• Net::HTTP
• URI

Net::HTTPHeader#get_fields(key) -> [String] (24037.0)

• 3.3

• インスタンスメソッド

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

Net::HTTPHeader#key?(key) -> bool (24037.0)

• 3.3

• インスタンスメソッド

key というヘッダフィールドがあれば真を返します。 key は大文字小文字を区別しません。

key というヘッダフィールドがあれば真を返します。
key は大文字小文字を区別しません。

@param key 探すヘッダフィールド名を文字列で与えます。

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

uri = URI.parse('http://www.example.com/index.html')
res = Net::HTTP.get_response(uri)
res.key?('content-type') # => true
res.key?('nonexist-header') # => false
//}

• Net::HTTPHeader

絞り込み条件を変える

Net::HTTPHeader#main_type -> String|nil (24037.0)

• 3.3

• インスタンスメソッド

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

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

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

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

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

• Net::HTTPHeader

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

• 3.3

• インスタンスメソッド

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

"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::HTTPHeader#type_params -> Hash (24037.0)

• 3.3

• インスタンスメソッド

Content-Type のパラメータを {"charset" => "iso-2022-jp"} という形の Hash で返します。

Content-Type のパラメータを {"charset" => "iso-2022-jp"}
という形の Hash で返します。

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

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

uri = URI.parse('http://www.example.com/index.html')
res = Net::HTTP.get_response(uri)
res.type_params # => {"charset"=>"UTF-8"}
//}

• Hash
• Net::HTTPHeader

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

• 3.3

• インスタンスメソッド

このメソッドは obsolete です。

このメソッドは obsolete です。


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

• Net::HTTPGenericRequest

OpenSSL::OCSP (127.0)

• 3.3

• モジュール

OCSP(Online Certificate Status Protocol)を取り扱うための モジュールです。OCSP は 2560 で定義されています。

OCSP(Online Certificate Status Protocol)を取り扱うための
モジュールです。OCSP は 2560 で定義されています。

このモジュールは OCSP のリクエストとレスポンスを取り扱う
機能を持っています。

OCSP レスポンダと通信する機能はありません。ユーザが例えば
OCSP over http などを実装する必要があります。

=== 例
OCSP レスポンダにリクエストを送ってその返答を表示する
require 'openssl'
require 'net/http'
# ...
subject # 問い合わせ対象の証明書(Ce...

絞り込み条件を変える

ruby 1.8.3 feature (37.0)

• 3.3

• 文書

ruby 1.8.3 feature *((<ruby 1.8 feature>)) *((<ruby 1.8.2 feature>))

ruby 1.8.3 feature
*((<ruby 1.8 feature>))
*((<ruby 1.8.2 feature>))

ruby 1.8.2 から ruby 1.8.3 までの変更点です。

掲載方針

*バグ修正の影響も含めて動作が変わるものを収録する。
*単にバグを直しただけのものは収録しない。
*ライブラリへの単なる定数の追加は収録しない。

以下は各変更点に付けるべきタグです。

記号について(特に重要なものは大文字(主観))

* カテゴリ
* [ruby]: ruby インタプリタの変更
* [api]: 拡張ライブラリ API
* [lib]: ...

ruby 1.9 feature (37.0)

• 3.3

• 文書

ruby 1.9 feature ruby version 1.9.0 は開発版です。 以下にあげる機能は将来削除されたり互換性のない仕様変更がなされるかもしれません。 1.9.1 以降は安定版です。 バグ修正がメインになります。

ruby 1.9 feature
ruby version 1.9.0 は開発版です。
以下にあげる機能は将来削除されたり互換性のない仕様変更がなされるかもしれません。
1.9.1 以降は安定版です。
バグ修正がメインになります。

記号について(特に重要なものは大文字(主観))

* カテゴリ
* [ruby]: ruby インタプリタの変更
* [api]: 拡張ライブラリ API
* [lib]: ライブラリ
* [parser]: 文法の変更
* [regexp]: 正規表現の機能拡張
* [marshal]: Marshal ファイルのフォーマット変更
* ...