通信先をローカルだけにする
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キャッシュは保存済みメタデータの更新や鮮度計算も行いますが、このコードはブラウザキャッシュの全実装ではありません。再検証の条件と本文の役割を切り分けるため、保存と再利用を明示的に書いています。
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は本文そのものではなく、表現を比較するための検証子です。文字列を復号すれば内容が復元できると考えないでください。別の利用者向けの保存済み本文へ同じタグを当てはめないよう、検証子と保存した応答の対応を保ちます。