Python ライブラリリファレンス

Previous: 18.6.22 例 Up: 18. インターネットプロトコルとその支援 Next: 18.7.1 HTTPConnection オブジェクト

---

18.7 httplib -- HTTP プロトコルクライアント

このモジュールでは HTTP および HTTPS プロトコルのクライアント側 を実装しているクラスを定義しています。通常、このモジュールは直接 使いません -- urllib モジュールが HTTP や HTTPS を使った URL を扱う上でこのモジュールを使います。 注意: HTTPS のサポートは、SSL をサポートするように socket モジュールをコンパイルした場合にのみ利用できます。

このモジュールでは以下のクラスを提供しています:

クラス HTTPConnection(

host[, port])

HTTPConnection インスタンスは、HTTP サーバとの一回の トランザクションを表現します。インスタンスの生成はホスト名と オプションのポート番号を与えて行います。ポート番号を指定しなかった 場合、ホスト名文字列が host:port の形式であれば、ホスト名からポート番号を導き、そうでない 場合には標準の HTTP ポート番号 (80) を使います。例えば、 以下の呼び出しは全て同じサーバの同じポートに接続するインスタンス を生成します:

>>> h1 = httplib.HTTPConnection('www.cwi.nl')
>>> h2 = httplib.HTTPConnection('www.cwi.nl:80')
>>> h3 = httplib.HTTPConnection('www.cwi.nl', 80)

クラス HTTPSConnection(

host[, port, key_file, cert_file])

HTTPConnection のサブクラスで、セキュアなサーバと 通信するために SSL を使います。標準のポート番号は 443 です。 key_fileには、秘密鍵を格納したPEM形式ファイルのファイル名を指定します。cert_fileには、PEM形式の証明書チェーンファイルを指定します。

警告: この関数は証明書の検査を行いません！

必要に応じて以下の例外が送出されます:

exception HTTPException

このモジュールにおける他の例外クラスの基底クラスです。 Exception のサブクラスです。

exception NotConnected

HTTPException サブクラスです。

exception InvalidURL

HTTPException のサブクラスです。ポート番号を指定した ものの、その値が数字でなかったり空のオブジェクトであった場合に送出されます。

exception UnknownProtocol

HTTPException のサブクラスです。

exception UnknownTransferEncoding

HTTPException のサブクラスです。

exception IllegalKeywordArgument

HTTPException のサブクラスです。

exception UnimplementedFileMode

HTTPException のサブクラスです。

exception IncompleteRead

HTTPException のサブクラスです。

exception ImproperConnectionState

HTTPException のサブクラスです。

exception CannotSendRequest

ImproperConnectionState のサブクラスです。

exception CannotSendHeader

ImproperConnectionState のサブクラスです。

exception ResponseNotReady

ImproperConnectionState のサブクラスです。

exception BadStatusLine

HTTPException のサブクラスです。 サーバが理解できない HTTP 状態コードで応答した場合に送出されます。

このモジュールで定義されている定数は以下の通りです:

HTTP_PORT

HTTP プロトコルの標準のポート (通常は 80) です。

HTTPS_PORT

HTTPS プロトコルの標準のポート (通常は 443) です。

また、整数の状態コードについて以下の定数が定義されています:

responses

このディクショナリは、HTTP 1.1ステータスコードをW3Cの名前にマップしたものです。

たとえば httplib.responses[httplib.NOT_FOUND] は 'Not Found' となります。 バージョン 2.5 で 新たに追加 された仕様です。

---

Python ライブラリリファレンス

Previous: 18.6.22 例 Up: 18. インターネットプロトコルとその支援 Next: 18.7.1 HTTPConnection オブジェクト

---

リリース 2.5 ，19th September, 2006 更新