検索結果

net/http (133147.0)

• 2.3.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...

• 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::HTTPBadGateway
• Net::HTTPBadRequest
• ...

Net::HTTP.start(address, port = 80, proxy_addr = :ENV, proxy_port = nil, proxy_user=nil, proxy_pass=nil) -> Net::HTTP (87907.0)

• 2.3.0

• 特異メソッド

新しい Net::HTTP オブジェクトを生成し、 TCP コネクション、 HTTP セッションを開始します。

新しい Net::HTTP オブジェクトを生成し、
TCP コネクション、 HTTP セッションを開始します。

ブロックを与えた場合には生成したオブジェクトをそのブロックに
渡し、ブロックが終わったときに接続を閉じます。このときは
ブロックの値を返り値とします。

ブロックを与えなかった場合には生成したオブジェクトを渡します。
利用後にはこのオブジェクトを Net::HTTP#finish してください。

proxy_addr に :ENV を指定すると環境変数 http_proxy からプロクシの URI を
取り出し利用します。環境変数 http_proxy が定義されていない場合に...

• Net::HTTP

Net::HTTP.start(address, port = 80, proxy_addr = :ENV, proxy_port = nil, proxy_user=nil, proxy_pass=nil) {|http| .... } -> object (87907.0)

• 2.3.0

• 特異メソッド

新しい Net::HTTP オブジェクトを生成し、 TCP コネクション、 HTTP セッションを開始します。

新しい Net::HTTP オブジェクトを生成し、
TCP コネクション、 HTTP セッションを開始します。

ブロックを与えた場合には生成したオブジェクトをそのブロックに
渡し、ブロックが終わったときに接続を閉じます。このときは
ブロックの値を返り値とします。

ブロックを与えなかった場合には生成したオブジェクトを渡します。
利用後にはこのオブジェクトを Net::HTTP#finish してください。

proxy_addr に :ENV を指定すると環境変数 http_proxy からプロクシの URI を
取り出し利用します。環境変数 http_proxy が定義されていない場合に...

• Net::HTTP

Net::HTTP#start {|http| .... } -> object (87676.0)

• 2.3.0

• インスタンスメソッド

TCP コネクションを張り、HTTP セッションを開始します。 すでにセッションが開始していたら例外 IOError を発生します。

TCP コネクションを張り、HTTP セッションを開始します。
すでにセッションが開始していたら例外 IOError を発生します。

ブロックを与えた場合には自分自身をそのブロックに
渡し、ブロックが終わったときに接続を閉じます。このときは
ブロックの値を返り値とします。

ブロックを与えなかった場合には自分自身を返します。
利用後にはこのオブジェクトを Net::HTTP#finish してください。

@raise IOError すでにセッションが開始していた場合に発生します。
@raise Net::OpenTimeout 接続がタイムアウトしたときに発生します

• Net::HTTP

Net::HTTP#start -> self (87376.0)

• 2.3.0

• インスタンスメソッド

TCP コネクションを張り、HTTP セッションを開始します。 すでにセッションが開始していたら例外 IOError を発生します。

TCP コネクションを張り、HTTP セッションを開始します。
すでにセッションが開始していたら例外 IOError を発生します。

ブロックを与えた場合には自分自身をそのブロックに
渡し、ブロックが終わったときに接続を閉じます。このときは
ブロックの値を返り値とします。

ブロックを与えなかった場合には自分自身を返します。
利用後にはこのオブジェクトを Net::HTTP#finish してください。

@raise IOError すでにセッションが開始していた場合に発生します。
@raise Net::OpenTimeout 接続がタイムアウトしたときに発生します

• Net::HTTP

絞り込み条件を変える

Net::HTTP#started? -> bool (42349.0)

• 2.3.0

• インスタンスメソッド

HTTP セッションが開始されていたら真を返します。

HTTP セッションが開始されていたら真を返します。

active? は時代遅れのメソッドです。

• Net::HTTP

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

• 2.3.0

• インスタンスメソッド

サーバ上の 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.Proxy(address, port = 80) -> Class (33355.0)

• 2.3.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::HTTP

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

• 2.3.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

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

• 2.3.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

絞り込み条件を変える

Net::HTTP#local_port=(port) (33199.0)

• 2.3.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

Net::HTTP#local_host=(host) (33181.0)

• 2.3.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

Net::HTTP#open_timeout=(seconds) (33091.0)

• 2.3.0

• インスタンスメソッド

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

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

この秒数たってもコネクションが
開かなければ例外 Net::OpenTimeout を発生します。
nilを設定するとタイムアウトしなくなります。

以下のコネクションを開くメソッドで有効です。

* Net::HTTP.open
* Net::HTTP#start


@param second 待つ秒数を指定します。
@see Net::HTTP#read_timeout, Net::HTTP#open_timeout

• Net::HTTP
• Net::OpenTimeout

Net::HTTP#proxy_address=(address) (33091.0)

• 2.3.0

• インスタンスメソッド

プロクシのアドレス(ホスト名、IPアドレス)を指定します。

プロクシのアドレス(ホスト名、IPアドレス)を指定します。

Net::HTTP#start で接続する前に設定する必要があります。

@param address プロクシのホスト名、もしくはIPアドレスを表す文字列

@see Net::HTTP#proxy_address=, Net::HTTP#proxy_port, Net::HTTP.new

• Net::HTTP

Net::HTTP#proxy_from_env? -> bool (33091.0)

• 2.3.0

• インスタンスメソッド

プロクシ情報を環境変数から得る場合に true を返します。

プロクシ情報を環境変数から得る場合に true を返します。

基本的に Net::HTTP.new や Net::HTTP.start の proxy_address
引数に :ENV を渡した場合に true になります。

環境変数 http_proxy が定義されていなくともこの値は true を返します。
その場合にはプロクシは利用されず直接サーバに接続します。

@see Net::HTTP#proxy_from_env=

• Net::HTTP

絞り込み条件を変える

Net::HTTP#proxy_pass=(pass) (33091.0)

• 2.3.0

• インスタンスメソッド

プロクシのユーザ認証のパスワードを設定します。

プロクシのユーザ認証のパスワードを設定します。

Net::HTTP#start で接続する前に設定する必要があります。

@param pass パスワード文字列
@see Net::HTTP#proxy_pass, Net::HTTP#proxy_user, Net::HTTP.new

• Net::HTTP

Net::HTTP#proxy_port=(port) (33091.0)

• 2.3.0

• インスタンスメソッド

プロクシのポート番号を設定します。

プロクシのポート番号を設定します。

Net::HTTP#start で接続する前に設定する必要があります。

@param port ポート番号(整数、文字列)
@see Net::HTTP#proxy_port, Net::HTTP#proxy_address, Net::HTTP.new

• Net::HTTP

Net::HTTP#proxy_user=(user) (33091.0)

• 2.3.0

• インスタンスメソッド

プロクシのユーザ認証のユーザ名を設定します。

プロクシのユーザ認証のユーザ名を設定します。

Net::HTTP#start で接続する前に設定する必要があります。

@param user ユーザ名文字列
@see Net::HTTP#proxy_pass, Net::HTTP#proxy_user, Net::HTTP.new

• Net::HTTP

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

• 2.3.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#proxy_from_env=(boolean) (33055.0)

• 2.3.0

• インスタンスメソッド

プロクシ情報を環境変数から得るかどうかを指定します。

プロクシ情報を環境変数から得るかどうかを指定します。

Net::HTTP#start で接続する前に設定する必要があります。

@param boolean プロクシ情報を環境変数から得るかどうかを指定する真偽値

@see Net::HTTP#proxy_from_env?

• Net::HTTP

絞り込み条件を変える

ruby 1.6 feature (127.0)

• 2.3.0

• 文書

ruby 1.6 feature ruby version 1.6 は安定版です。この版での変更はバグ修正がメイン になります。

ruby 1.6 feature
ruby version 1.6 は安定版です。この版での変更はバグ修正がメイン
になります。

((<stable-snapshot|URL:ftp://ftp.netlab.co.jp/pub/lang/ruby/stable-snapshot.tar.gz>)) は、日々更新される安定版の最新ソースです。

== 1.6.8 (2002-12-24) -> stable-snapshot

: 2003-01-22: errno

EAGAIN と EWOULDBLOCK が同じ値のシステムで、EWOULDBLOCK がなくなっ
ていま...