実験・実装 · 基礎から応用へ

ETagによるHTTP再検証を試す

ローカルHTTPサーバーで200と304を比較し、本文を再利用する責務を確認する。

この記事をロゲイアに質問する確認問題3問に進むこれまでの誤答を復習する

更新日

この記事の目次
  1. 通信先をローカルだけにする
  2. 200と304の本文を比べる
  3. タグが違う条件も試す
  4. 再検証は通信をなくさない
  5. この記事をロゲイアに質問する理解を確かめる

通信先をローカルだけにする

Python 3の標準ライブラリだけで、127.0.0.1の空きポートへ小さなサーバーを立てます。外部サイトや認証情報は使いません。最初のGETで本文とETagを保存し、次のGETではIf-None-Matchにそのタグを送ります。サーバーの本文は固定し、変更がない場合の検証に絞ります。Cache-Control: no-cacheは保存禁止という意味ではなく、再利用前の検証を求める指示です。no-storeとの違いを確認してから読み進めてください。

200と304の本文を比べる

次のコードは最初に200、次に304を表示します。urllibは304をHTTPErrorとして表現するため、その応答を捕まえて状態を確認します。304に新しい本文はなく、クライアントが保持していた本文を再利用します。実際のHTTPキャッシュは保存済みメタデータの更新や鮮度計算も行いますが、このコードはブラウザキャッシュの全実装ではありません。再検証の条件と本文の役割を切り分けるため、保存と再利用を明示的に書いています。

python
from http.server import BaseHTTPRequestHandler, HTTPServer
from threading import Thread
from urllib.request import Request, urlopen
from urllib.error import HTTPError
BODY = b"revision one\n"
ETAG = '"example-v1"'
class Handler(BaseHTTPRequestHandler):
    def do_GET(self):
        same = self.headers.get("If-None-Match") == ETAG
        self.send_response(304 if same else 200)
        self.send_header("ETag", ETAG)
        self.send_header("Cache-Control", "no-cache")
        self.end_headers()
        if not same: self.wfile.write(BODY)
    def log_message(self, *args): pass
server = HTTPServer(("127.0.0.1", 0), Handler)
worker = Thread(target=server.serve_forever, daemon=True)
worker.start()
url = f"http://127.0.0.1:{server.server_port}/item"
try:
    with urlopen(url) as first:
        saved = first.read(); tag = first.headers["ETag"]
        print(first.status, saved.decode().strip(), tag)
    try:
        with urlopen(Request(url, headers={"If-None-Match": tag})):
            raise AssertionError("Expected 304 for the matching validator")
    except HTTPError as response:
        body = response.read()
        response.close()
        print(response.code, "body_bytes", len(body))
        assert response.code == 304 and body == b""
        assert saved == BODY
        print("reuse", saved.decode().strip())
finally:
    server.shutdown(); worker.join(); server.server_close()

タグが違う条件も試す

If-None-Matchへ別のタグを送れば、サーバーは200と本文を返します。ETagを常に同じ文字列にしたまま本文だけ変えると、変更を誤って見逃すことになります。タグは表現の版を区別できるように作る必要があります。この簡易サーバーは単一のタグだけを等号で比較しており、弱いタグ、タグのリスト、ワイルドカードを扱う完全なHTTP条件付き要求の実装ではありません。実用コードでこの比較部分をそのまま代用しないでください。

再検証は通信をなくさない

304は本文転送を減らせますが、要求と応答の往復は残ります。大きな本文で通信量を減らす効果と、往復待ち時間をなくす効果は違います。適切な鮮度期間なら、キャッシュが正本へ確認せず再利用できる場合もあります。認証やVaryで表現が変わる場合には、どの保存済み応答のタグを使うかが重要です。実験後はサーバーを停止し、スレッドとソケットを閉じます。外部公開用のサーバーへ変更する必要はありません。

応答ヘッダーのETagは本文そのものではなく、表現を比較するための検証子です。文字列を復号すれば内容が復元できると考えないでください。別の利用者向けの保存済み本文へ同じタグを当てはめないよう、検証子と保存した応答の対応を保ちます。

読了と問題の結果を、言語ごとにこのブラウザへ保存します。

コースの順番に沿って学ぶ

サーバーの中で起きていること · STEP 10

学習コースから次を選ぶ