18.6.2 OpenerDirector オブジェクト

OpenerDirector インスタンスは以下のメソッドを持っています:

add_handler( handler)

handler は BaseHandler のインスタンスでなければなりません。以下のメソッドを使った検索が行われ、URL を取り扱うことが可能なハンドラの連鎖が追加されます (HTTP エラーは特別扱いされているので注意してください)。

protocol_open() -- ハンドラが protocol の URL を開く方法を知っているかどうかを調べます。
http_error_type() -- ハンドラが HTTP エラーコード type の処理方法を知っていることを示すシグナルです。
protocol_error() -- ハンドラが (http でない) protocol のエラーを処理する方法を知っていることを示すシグナルです。
protocol_request() -- ハンドラが protocol リクエストのプリプロセス方法を知っていることを示すシグナルです。
protocol_response() -- ハンドラが protocol リクエストのポストプロセス方法を知っていることを示すシグナルです。

open( url[, data]): 与えられた url (リクエストオブジェクトでも文字列でもかまいません) を開きます。オプションとして data を与えることができます。引数、返り値、および送出される例外は urlopen() と同じです (urlopen() の場合、標準でインストールされているグローバルな OpenerDirector の open() メソッドを呼び出します) 。

error( proto[, arg[, ...]]): 与えられたプロトコルにおけるエラーを処理します。このメソッドは与えられたプロトコルにおける登録済みのエラーハンドラを (プロトコル固有の) 引数で呼び出します。 HTTP プロトコルは特殊なケースで、特定のエラーハンドラを選び出すのに HTTP レスポンスコードを使います; ハンドラクラスの http_error_*() メソッドを参照してください。
返り値および送出される例外は urlopen() と同じものです。

OpenerDirector オブジェクトは、以下の 3 つのステージに分けて URL を開きます:

各ステージで OpenerDirector オブジェクトのメソッドがどのような順で呼び出されるかは、ハンドラインスタンスの並び方で決まります。

protocol_request() 形式のメソッドを持つ全てのハンドラに対してそのメソッドを呼び出し、リクエストのプリプロセスを行います。
protocol_open() 形式のメソッドを持つハンドラを呼び出し、リクエストを処理します。このステージは、ハンドラがNone でない値 (すなわちレスポンス) を返すか、例外 (通常は URLError) を送出した時点で終了します。例外は伝播 (propagate) できます。
実際には、上のアルゴリズムではまず default_open という名前のメソッドを呼び出します。このメソッドが全て None を返す場合、同じアルゴリズムを繰り返して、今度は protocol_open() 形式のメソッドを試します。メソッドが全て None を返すと、さらに同じアルゴリズムを繰り返して unknown_open() を呼び出します。
これらのメソッドの実装には、親となる OpenerDirector インスタンスの .open() や.error() といったメソッド呼び出しが入る場合があるので注意してください。
protocol_response() 形式のメソッドを持つ全てのハンドラに対してそのメソッドを呼び出し、リクエストのポストプロセスを行います。

ご意見やご指摘をお寄せになりたい方は、 このドキュメントについて... をご覧ください。