この記事では、Pythonの`http.client`ライブラリを用いて低レベルなHTTPリクエストを送信する方法を詳しく解説します。実際のコード例、その詳細解説、さらには応用例までを網羅しています。
はじめに
`http.client`はPythonの標準ライブラリの一部であり、低レベルなHTTPリクエストを送信するためのモジュールです。多くの場合、高レベルなライブラリ（例：`requests`）が使用されますが、`http.client`で直接HTTPリクエストを制御することには、精度と柔軟性の面でのメリットがあります。
基本的な使用法
まずは、`http.client`を用いてGETリクエストを送る基本的な例から始めましょう。
# http.clientをインポート
import http.client
# HTTP接続を作成
conn = http.client.HTTPSConnection("www.google.com")
# GETリクエストを送信
conn.request("GET", "/")
# レスポンスを受け取る
response = conn.getresponse()
# レスポンスを出力
print(response.read().decode("utf-8"))
# 接続を閉じる
conn.close()
コードの解説
1. `import http.client`：http.clientモジュールをインポートします。
2. `conn = http.client.HTTPSConnection(“www.google.com”)`：`HTTPSConnection`クラスを用いて、google.comにHTTPSで接続します。
3. `conn.request(“GET”, “/”)`：`GET`メソッドでルートパス（”/”）にリクエストを送ります。
4. `response = conn.getresponse()`：レスポンスオブジェクトを取得します。
5. `print(response.read().decode(“utf-8”))`：レスポンスボディをutf-8でデコードして出力します。
6. `conn.close()`：接続を閉じます。
応用例1: POSTリクエストの送信
次に、POSTリクエストを送信する方法を見ていきましょう。
# 必要なモジュールをインポート
import http.client
import json
# HTTP接続を作成
conn = http.client.HTTPSConnection("httpbin.org")
# ヘッダーとボディを設定
headers = {'Content-Type': 'application/json'}
body = json.dumps({'key': 'value'})
# POSTリクエストを送信
conn.request("POST", "/post", body, headers)
# レスポンスを受け取る
response = conn.getresponse()
# レスポンスを出力
print(response.read().decode("utf-8"))
# 接続を閉じる
conn.close()
コードの解説
1. `headers = {‘Content-Type’: ‘application/json’}`：ヘッダー情報を設定します。今回はJSON形式でデータを送信するので、’Content-Type’は’application/json’となります。
2. `body = json.dumps({‘key’: ‘value’})`：JSON形式のボディを作成します。
3. `conn.request(“POST”, “/post”, body, headers)`：`POST`メソッドで、指定したボディとヘッダーを使ってリクエストを送ります。
応用例2: カスタムヘッダーとクエリパラメータ
さらに高度な使い方として、カスタムヘッダーとクエリパラメータを追加する方法です。
# 必要なモジュールをインポート
import http.client
import urllib.parse
# HTTP接続を作成
conn = http.client.HTTPSConnection("httpbin.org")
# カスタムヘッダーとクエリパラメータを設定
headers = {'Custom-Header': 'custom_value'}
params = urllib.parse.urlencode({'param1': 'value1'})
# GETリクエストを送信
conn.request("GET", f"/get?{params}", headers=headers)
# レスポンスを受け取る
response = conn.getresponse()
# レスポンスを出力
print(response.read().decode("utf-8"))
# 接続を閉じる
conn.close()
コードの解説
1. `headers = {‘Custom-Header’: ‘custom_value’}`：カスタムヘッダーを設定します。
2. `params = urllib.parse.urlencode({‘param1’: ‘value1’})`：クエリパラメータをURLエンコードします。
3. `conn.request(“GET”, f”/get?{params}”, headers=headers)`：GETリクエストを送信する際に、カスタムヘッダーとクエリパラメータを追加します。
まとめ
`http.client`ライブラリは、低レベルなHTTPリクエストを柔軟に制御できる強力なツールです。基本的なGETリクエストから、POSTリクエスト、さらにはカスタムヘッダーとクエリパラメータの設定まで、多岐にわたる用途に応用可能です。この記事で学んだ知識を活かして、更に高度なWeb開発を行って
みてはいかがでしょうか。
コメント