urllib2 モジュールは基本的な認証、暗号化認証、リダイレクション その他の介在する複雑なアクセス環境において (大抵は HTTP で) URL を開くための関数とクラスを定義します。
urllib2 モジュールでは以下の関数を定義しています:
| url[, data]) |
data は文字列で、サーバに送信する追加のデータを指定します。 HTTP リクエストは data をサポートする唯一のリクエスト形式 ですが、ここでは data は例えば urllib.urlencode() が返すような application/x-www-form-urlencoded 形式で エンコードされたバッファでなくてはなりません。
この関数は以下の 2 つのメソッドを持つファイル類似のオブジェクトを返します:
エラーが発生した場合 URLError を送出します。
| opener) |
| [handler, ...]) |
ProxyHandler, UnknownHandler, HTTPHandler, HTTPDefaultErrorHandler, HTTPRedirectHandler, FTPHandler, FileHandler
については、そのクラスの インスタンスか、そのサブクラスのインスタンスが handler に含まれていない限り、handler よりも先に連鎖します。
Python が SSL をサポートするように設定してインストールされている 場合 (socket.ssl() が存在する場合) 、 HTTPSHandler も追加されます。
Python 2.3 からは、BaseHandler サブクラスでも
handler_order メンバ変数を変更して、ハンドラリスト
内での場所を変更できるようになりました。
現在全てのハンドラの handler_oder は 500 ですが、
例外として ProxyHandler では 100 になっています。
状況に応じて、以下の例外が送出されます:
URLError のサブクラスです。この例外は Gopher ハンドラに よって送出されます。
以下のクラスが提供されています:
| url[, data[, headers]]) |
url は有効な URL を指す文字列でなくてはなりません。 data の詳細については add_data() の記述を見てください。 headers は辞書でなくてはなりません。 この辞書は add_header() を辞書のキーおよび値を引数として呼び出した時と 同じように扱われます。
| ) |
| ) |
| ) |
| ) |
| [proxies]) |
| ) |
(realm, uri) -> (user, password)
の対応付けデータベースを保持します。
| ) |
(realm, uri) -> (user, password)
の対応付けデータベースを保持します。
レルム None はその他諸々のレルムを表し、他のレルムが
該当しない場合に検索されます。
| [password_mgr]) |
| [password_mgr]) |
| [password_mgr]) |
| [password_mgr]) |
| [password_mgr]) |
| [password_mgr]) |
| ) |
| ) |
| ) |
| ) |
| ) |
| ) |
| ) |