SHOEISHA iD

パスワードを忘れた場合はこちら

※旧SEメンバーシップ会員の方は、同じ登録情報（メールアドレス＆パスワード）でログインいただけます

  • 新規
    会員登録
  • 新規会員登録

ニュース

記事

デブサミ・デブスト

講座

書籍

新着記事一覧を見る

連載記事

人気記事の執筆者

WINGSプロジェクト 山田 研二

柳井 政和

藤澤 千尋

水無瀬 あずさ

中島 佑馬
イベント
イベント

CodeZine編集部では、現場で活躍するデベロッパーをスターにするためのカンファレンス「Developers Summit」や、エンジニアの生きざまをブーストするためのイベント「Developers Boost」など、さまざまなカンファレンスを企画・運営しています。

講演資料・動画まとめページ

Developers CAREER Boost 2024 講演資料まとめ

Developers X Summit 2024 講演資料まとめ

Developers Summit 2024 KANSAI 講演関連資料まとめ

Developers Summit 2024 Summer 講演資料まとめ

Developers Boost 2024 講演資料まとめ

Developers Summit 2024 講演資料まとめ

翔泳社では、「独習」「徹底入門」「スラスラわかる」「絵で見てわかる」「一年生」などの人気シリーズをはじめ、言語や開発手法、最新技術を解説した書籍を多数手がけています。プロジェクトマネジメントやチームビルティングといった管理職向けの書籍も豊富です。

ITエンジニアとしてのスキルアップ・リスキリングに、ぜひお役立てください。

書籍に関する記事を見る

'); googletag.cmd.push(function() { googletag.pubads().addEventListener('slotRenderEnded', function(e) { var ad_id = e.slot.getSlotElementId(); if (ad_id == 'div-gpt-ad-1659428980688-0') { var ad = $('#'+ad_id).find('iframe'); if ($(ad).width() == 728) { var ww = $(window).width(); ww = ww*0.90; var style = document.createElement("style"); document.head.appendChild( style ); var sheet = style.sheet; sheet.insertRule( "#div-gpt-ad-1659428980688-0 iframe {-moz-transform: scale("+ww/728+","+ww/728+");-moz-transform-origin: 0 0;-webkit-transform: scale("+ww/728+","+ww/728+");-webkit-transform-origin: 0 0;-o-transform: scale("+ww/728+","+ww/728+");-o-transform-origin: 0 0;-ms-transform: scale("+ww/728+","+ww/728+");-ms-transform-origin: 0 0;}", 0 ); sheet.insertRule( "#div-gpt-ad-1659428980688-0 div{ height:"+(90*ww/728)+"px;width:"+728+"px;}", 0 ); } else { if ($(window).width() < 340) { var ww = $(window).width(); ww = ww*0.875; var style = document.createElement("style"); document.head.appendChild( style ); var sheet = style.sheet; sheet.insertRule( "#div-gpt-ad-1659428980688-0 iframe {-moz-transform: scale("+ww/320+","+ww/320+");-moz-transform-origin: 0 0;-webkit-transform: scale("+ww/320+","+ww/320+");-webkit-transform-origin: 0 0;-o-transform: scale("+ww/320+","+ww/320+");-o-transform-origin: 0 0;-ms-transform: scale("+ww/320+","+ww/320+");-ms-transform-origin: 0 0;}", 0 ); sheet.insertRule( "#div-gpt-ad-1659428980688-0 div{ height:"+(180*ww/320)+"px;width:"+320+"px;}", 0 ); } } } }); }); } else { document.write('
'); document.write('
'); }
翔泳社 新刊紹介（AD）

PythonのWebフレームワーク「Django」のHttpRequestオブジェクトを徹底解説

  • X ポスト
  • このエントリーをはてなブックマークに追加

　PythonでWeb開発ができるフルスタックなフレームワーク「Django」について詳しく解説した『実践Django Pythonによる本格Webアプリケーション開発』から、DjangoのHttpRequestオブジェクトの役割と仕組みについて、HTTP 1.1の基礎知識から掘り下げて解説しているパートを抜粋して紹介します。

  • X ポスト
  • このエントリーをはてなブックマークに追加
本記事は『実践Django Pythonによる本格Webアプリケーション開発』の「3.4　HttpRequestとHttpResponseを使いこなす」から一部を抜粋したものです。掲載にあたって編集しています。

HttpRequestを使いこなす

　HttpRequestの踏み込んだ解説に入る前に、簡単にHTTPの基本をおさらいします。curlを用いて、Djangoのスタートページにリクエストを飛ばしてみます。

$ curl -v http://127.0.0.1:8000/
*   Trying 127.0.0.1...
* TCP_NODELAY set
* Connected to 127.0.0.1 (127.0.0.1) port 8000 (#0)
> GET / HTTP/1.1
> Host: 127.0.0.1:8000
> User-Agent: curl/7.64.1
> Accept: */*
>
< HTTP/1.1 200 OK
< Date: Tue, 16 Mar 2021 19:38:40 GMT
< Server: WSGIServer/0.2 CPython/3.9.0
< Content-Type: text/html
< X-Frame-Options: DENY
< Content-Length: 10697
< X-Content-Type-Options: nosniff
< Referrer-Policy: same-origin
<

<!doctype html>
<html lang="en-us" dir="ltr">
    (中略)
</html>
* Connection #0 to host 127.0.0.1 left intact
* Closing connection 0

　このように-vオプションをつけることで、リクエストやレスポンスの詳細が確認できます。curlが送信したHTTPのリクエストは、次のようになっています。

GET / HTTP/1.1
Host: 127.0.0.1:8000
User-Agent: curl/7.64.1
Accept: */*

<EOF>

　HTTPリクエストの1行目は、リクエストライン（Request-Line）と呼ばれます。リクエストラインは「メソッド」「リクエストURI」「HTTPバージョン」からなります。今回の場合、メソッドは「GET」、リクエストURIは「/」、プロトコルバージョンはHTTPの1.1です。リクエストラインの次にHTTPヘッダーの値が続き、空行を1行おいてメッセージボディー（Message body）があります。今回はメッセージボディーは空です。次は、Djangoのアプリケーションが返したHTTPレスポンスも確認しましょう。

HTTP/1.1 200 OK
Date: Tue, 16 Mar 2021 19:39:14 GMT
Server: WSGIServer/0.2 CPython/3.9.0
Content-Type: text/html
X-Frame-Options: DENY
Content-Length: 10697
X-Content-Type-Options: nosniff
Referrer-Policy: same-origin

<!doctype html>
<html>
    ...
</html>

　HTTPレスポンスの1行目は、ステータスライン（Status-Line）と呼ばれます。ステータスラインは「HTTPバージョン」「ステータスコード」「リーズンフレーズ（Reason-Phrase）」からなります。ステータスコードが200番台であることから、正常にレスポンスが返ってきていることが確認できます。続いてHTTPヘッダーの値が続き、空行を1行おいてメッセージボディーがあります。メッセージボディーにはHTMLが記述されています。今回はcurlでHTTPリクエストを送信しましたが、Webブラウザでアクセスした際も基本的には変わりません。流れを図にすると図1のようになります。

図1　HTTP/1.1リクエストとレスポンスの様子
図1　HTTP/1.1リクエストとレスポンスの様子

　ここまでの流れを頭に入れておけば、HttpRequestの理解はそれほど難しくありません。WSGIサーバーやDjangoアプリケーションによって、HTTPのリクエストは図2に示すようにHttpRequestオブジェクトに変換され、HttpResponseオブジェクトに書き込んだ値は図3に示すようにHTTPのレスポンスとしてクライアントに返されます。

図2　HTTPのリクエストがHttpRequestオブジェクトに変換される
図2　HTTPのリクエストがHttpRequestオブジェクトに変換される
図3　HttpResponseオブジェクトの各フィールドが、HTTPのレスポンスに対応する
図3　HttpResponseオブジェクトの各フィールドが、HTTPのレスポンスに対応する

x-www-form-urlencoded形式のデータの読み込み

　HTTPリクエストのメッセージボディーを取得する方法は複数用意されています。

  • request.body：リクエストボディー（例：b'{"message": "Hello World"'）
  • request.readメソッド：file-likeオブジェクト
  • request.POST：x-www-form-urlencoded形式のリクエストボディー（例：QueryDict({'email': ['[email protected]']})）
  • request.FILES：multipart/form-data形式のリクエストボディー（例：MultiValueDict({'user': ['shibata']})）

　メッセージボディーは、request.bodyからのバイト文字列で取得できます。しかしメッセージボディーのサイズが大きく一度にメモリに載せたくないケースでは、request.readメソッドによるfile-likeオブジェクトを取得します。またそれ以外にも特定の形式で記述されたデータをパースして取り出すことができます。例えば次のようなHTMLフォームからPOSTのリクエストを送るケースを考えてみます。

<form method="post" action="/accounts/">
    {% csrf_token %}
    <input type="text" name="username">
    <input type="text" name="email">
    <button type="submit">投稿</button>
</form>

　このHTMLフォームはusernameやemailの文字列を/accountsに送信します。実際にHTTPのリクエストは次のようになっています。

POST /accounts/ HTTP/1.1
Host: example.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 44

username=shibata&email=shibata%40example.com

　usernameとemailの情報がメッセージボディー内に記述されています。その形式はGETリクエスト時にURLに含めるクエリ文字列の形式と同じで、パラメーターは&によって区切られ、keyとvalueは、=によって区切られます。また、英数字以外はパーセントエンコードをされるため、@は%40に変わっています。このような形式をx-www-form-urlencoded形式と呼びます。HttpRequestオブジェクトのPOST属性は、このx-www-form-urlencoded形式のデータをパースし、QueryDictという辞書ライクなオブジェクトで提供してくれます。form-urlencodedの形式は、keyの重複を許容するため1つのkeyに対して複数の値をもちます。

>>> from django.http import QueryDict
>>> QueryDict("user=shibata&user=masashi&email=shibata%40example.com")
<QueryDict: {'user': ['shibata', 'masashi'], 'email': ['[email protected]']}>

multipart/form-data形式のデータの読み込み

　<form>タグのenctype属性または<button>や<input>のformenctype属性を指定するとメッセージボディーの形式が変わります。先程紹介したx-www-form-urlencoded以外にも、multipart/form-dataやtext/plainが指定できます。ここではmultipart/form-dataを指定してみましょう。

<form method="post" action="/accounts/" enctype="multipart/form-data">
    {% csrf_token %}
    <input type="text" name="username">
    <input type="image" name="icon_url">
    <button type="submit">{% trans "Post" %}</button>
</form>

　このフォームのicon_urlフィールドでは、画像ファイルを選択します。

　multipart/form-dataは、このようにHTMLフォームからファイルをアップロードする際に必要になります。メッセージボディーがどのようになっているか確認してみましょう。

POST /accounts/ HTTP/1.1
Host: example.com
Content-Type: multipart/form-data;boundary="boundary"

--boundary
Content-Disposition: form-data; name="username"

shibata
--boundary
Content-Disposition: form-data; name="icon_url"; filename="profile.png"
Content-Transfer-Encoding: binary

contents of profile.png...
--boundary--

　Content-Typeヘッダーで指定される区切り文字列によってメッセージボディーが分割されています。その中にさらにヘッダーが存在し、空行を空けて画像データの中身が記述されています。

　multipart/form-data形式のリクエストには、HttpRequestオブジェクトのFILES属性よりアクセスできます。ファイルアップロードなどを実装する際はこの内容を押さえておくといいでしょう。

conditionデコレーターを使ったETagやLast-Modifiedヘッダーの制御

　HTTPには、クライアントにレスポンス内容をキャッシュさせる仕組みがいくつかあります。もしクライアントが最後にアクセスしてから、まだサーバーのレスポンス内容に変化がないことがわかっていれば、レスポンスのメッセージボディーは空でも問題ないはずです。そこでクライアントが既に最新のコンテンツをキャッシュしていることがわかっている場合には、サーバーは304 Not Modifiedを返します。

　さて、それではどのようにしてクライアントが既に最新のコンテンツをキャッシュしているかを判断するのでしょうか。1つの方法は次のようなLast-Modifiedヘッダーによる制御です。

Last-Modified: Mon, 22 Mar 2021 01:08:18 GMT

　Last-Modifiedヘッダーの値には、HTTP-dateタイムスタンプ形式で最後にコンテンツが更新された日時を指定します。クライアント側は、コンテンツにアクセスした際のLast-Modifiedヘッダーの値を記憶し、次回以降のアクセスの際に次のようなIf-Modified-Sinceヘッダーをリクエストヘッダーに含めます。

If-Modified-Since: Mon, 22 Mar 2021 01:08:18 GMT

　するとサーバーは、現在のコンテンツの最終更新日時とIf-Modified-Sinceヘッダーの日時を比較します。もしコンテンツの最終更新日時の方が新しければ200 OKを返し、古ければ304 Not Modifiedを返します。304 Not Modifiedを返す際には、HTTPレスポンスのメッセージボディーには何も入っていません。Djangoではconditionデコレーターを用いて次のように記述できます。

from django.views.decorators.http import condition


def last_modified_func(request, snippet_id):
    try:
        snippet = Snippet.objects.get(id=snippet_id)
    except Snippet.DoesNotExist:
        return None # コンテンツが存在しなければNoneを返す。
    return snippet.updated_at


@condition(last_modified_func=last_modified_func)
def my_view(request, snippet_id):
    ...

　last_modified_funcは、ビュー関数と同じ引数を受け取って、最終更新日時を示すdatetimeオブジェクトを返す関数です。もしコンテンツがそもそも存在しなければ、Noneを返します。

　Last-Modifiedヘッダーは日時によりキャッシュを制御しますが、日時の比較ではキャッシュの有効性を表現できないこともしばしばあります。そのようなケースではリクエスト内容やコンテンツの情報から、何らかのハッシュ値を計算し、そのハッシュ値が一致するかどうかを見る方法もあります。

　それを実現するのがETagヘッダーです。大まかな流れはLast-Modifiedヘッダーのときと変わりません。サーバーは、コンテンツを返す際にHTTPのレスポンスヘッダーにETag: をセットします。クライアント側がこれを記憶し、If-None-Match: ヘッダーをつけてサーバーにコンテンツを問い合わせます。Djangoで実装する際には@condition(etag_func=...)にハッシュ値を返す関数を指定するだけです。

　またdjango.views.decorators.httpモジュールは、etagデコレーターやlast_modifiedデコレーターも提供します。これらは次のようなただのショートカット関数です。そのためconditionデコレーターが理解できていれば十分です。

def etag(etag_func):
    return condition(etag_func=etag_func)

def last_modified(last_modified_func):
    return condition(last_modified_func=last_modified_func)
実践Django

Amazon　SEshop　その他


実践Django
Pythonによる本格Webアプリケーション開発

著者：芝田将
発売日：2021年7月19日（月）
定価：3,850円（本体3,500円＋税10%）

Djangoの実践的なテストテクニック、ユーザーモデルのカスタマイズ方法、認証処理のベストプラクティスなど、Web開発において必ず知っておくべき内容を幅広く取り上げました。

 

この記事は参考になりましたか？

  • X ポスト
  • このエントリーをはてなブックマークに追加
翔泳社 新刊紹介連載記事一覧

もっと読む

この記事の著者

芝田 将（株式会社サイバーエージェント）（シバタ マサシ）

　株式会社サイバーエージェント AbemaTV 配信チーム所属。go-prompt 開発者。　共訳書『エキスパートPythonプログラミング改訂2版』。 Webサイト： https://c-bata.link

※プロフィールは、執筆時点、または直近の記事の寄稿時点での内容です

この著者の最近の執筆記事

渡部 拓也（ワタナベ タクヤ）

　翔泳社マーケティング課。MarkeZine、CodeZine、EnterpriseZine、Biz/Zine、ほかにて翔泳社の本の紹介記事や著者インタビュー、たまにそれ以外も執筆しています。

※プロフィールは、執筆時点、または直近の記事の寄稿時点での内容です

この著者の最近の執筆記事

【AD】本記事の内容は記事掲載開始時点のものです　企画・制作　株式会社翔泳社

この記事は参考になりましたか？

この記事をシェア

  • X ポスト
  • このエントリーをはてなブックマークに追加
CodeZine（コードジン）
https://codezine.jp/article/detail/14493 2021/07/27 07:00
" ); }

おすすめ

アクセスランキング

  1. 1
    「オブザーバー・パターン」　～マンガでプログラミング用語解説
  2. 2
    フロントエンドの定番ライブラリ「React 19」の新機能を紹介──React Server Componentsとその他の改善点
  3. 3
    Microsoft、オープンソースのプログラミング言語「TypeScript 5.8」をリリース NEW
  4. 4
    3/5まで書籍全文が無料公開 『Pythonで動かして学ぶ！Kaggleデータ分析入門』
  5. 5
    SNSマーケティングを支えるエンジニア──toridoriのエンジニアリングマネージャーが語るマネジメント職の大切さとは？
  1. 6
    ゲーム業界で働くプログラマ・エンジニア、8割超が現在の職場のスキル評価に満足 NEW
  2. 7
    「おもしろそうドリブン」のキャリア形成、エンジニアとして成長を加速させるポイントとは？ NEW
  3. 8
    日本IBM、自動車業界に関する調査レポート「2035年 自動車業界の将来展望」を公開 NEW
  4. 9
    マイクロソフト、VSCodeの新機能「Copilot Next Edit Suggestions」のプレビュー版公開
  5. 10
    ガートナージャパン、2025年のサイバーセキュリティにおけるトップトレンドを発表 NEW

アクセスランキング

  1. 1
    「オブザーバー・パターン」　～マンガでプログラミング用語解説
  2. 2
    フロントエンドの定番ライブラリ「React 19」の新機能を紹介──React Server Componentsとその他の改善点
  3. 3
    Microsoft、オープンソースのプログラミング言語「TypeScript 5.8」をリリース NEW
  4. 4
    3/5まで書籍全文が無料公開 『Pythonで動かして学ぶ！Kaggleデータ分析入門』
  5. 5
    SNSマーケティングを支えるエンジニア──toridoriのエンジニアリングマネージャーが語るマネジメント職の大切さとは？
  6. 6
    ゲーム業界で働くプログラマ・エンジニア、8割超が現在の職場のスキル評価に満足 NEW
  7. 7
    「おもしろそうドリブン」のキャリア形成、エンジニアとして成長を加速させるポイントとは？ NEW
  8. 8
    日本IBM、自動車業界に関する調査レポート「2035年 自動車業界の将来展望」を公開 NEW
  9. 9
    マイクロソフト、VSCodeの新機能「Copilot Next Edit Suggestions」のプレビュー版公開
  10. 10
    ガートナージャパン、2025年のサイバーセキュリティにおけるトップトレンドを発表 NEW
  1. 1
    ITエンジニア本大賞2025、技術書部門とビジネス書部門の大賞が決定！
  2. 2
    マイクロソフト、VSCodeの新機能「Copilot Next Edit Suggestions」のプレビュー版公開
  3. 3
    C# 13の新機能を理解する――暗黙的なインデックスアクセスとallows ref struct
  4. 4
    iOS・iPadOS 18.3がリリース
  5. 5
    3/5まで書籍全文が無料公開 『Pythonで動かして学ぶ！Kaggleデータ分析入門』
  6. 6
    AIや統計の数式を解説する美少女VTuber「AIcia Solid Project」生みの親が語る、継続できるアウトプット活動とは？
  7. 7
    Webはどんどん複雑になっている？ これまでのWebシステムのトレンドを振り返る
  8. 8
    Linuxディストリビューション「EndeavourOS Mercury」が一般提供開始
  9. 9
    ITエンジニア本大賞2025のプレゼン大会をレポート、最終決戦に臨んだ本に込められた想いとは
  10. 10
    開発者のOSS活動が会社から評価される世の中にしたい──日立製作所が専門組織設立に込めた情熱

イベント

CodeZine編集部では、現場で活躍するデベロッパーをスターにするためのカンファレンス「Developers Summit」や、エンジニアの生きざまをブーストするためのイベント「Developers Boost」など、さまざまなカンファレンスを企画・運営しています。

新規会員登録無料のご案内

メールバックナンバー

アクセスランキング

  1. 1
    「オブザーバー・パターン」　～マンガでプログラミング用語解説
  2. 2
    フロントエンドの定番ライブラリ「React 19」の新機能を紹介──React Server Componentsとその他の改善点
  3. 3
    Microsoft、オープンソースのプログラミング言語「TypeScript 5.8」をリリース NEW
  4. 4
    3/5まで書籍全文が無料公開 『Pythonで動かして学ぶ！Kaggleデータ分析入門』
  5. 5
    SNSマーケティングを支えるエンジニア──toridoriのエンジニアリングマネージャーが語るマネジメント職の大切さとは？
  1. 6
    ゲーム業界で働くプログラマ・エンジニア、8割超が現在の職場のスキル評価に満足 NEW
  2. 7
    「おもしろそうドリブン」のキャリア形成、エンジニアとして成長を加速させるポイントとは？ NEW
  3. 8
    日本IBM、自動車業界に関する調査レポート「2035年 自動車業界の将来展望」を公開 NEW
  4. 9
    マイクロソフト、VSCodeの新機能「Copilot Next Edit Suggestions」のプレビュー版公開
  5. 10
    ガートナージャパン、2025年のサイバーセキュリティにおけるトップトレンドを発表 NEW

アクセスランキング

  1. 1
    「オブザーバー・パターン」　～マンガでプログラミング用語解説
  2. 2
    フロントエンドの定番ライブラリ「React 19」の新機能を紹介──React Server Componentsとその他の改善点
  3. 3
    Microsoft、オープンソースのプログラミング言語「TypeScript 5.8」をリリース NEW
  4. 4
    3/5まで書籍全文が無料公開 『Pythonで動かして学ぶ！Kaggleデータ分析入門』
  5. 5
    SNSマーケティングを支えるエンジニア──toridoriのエンジニアリングマネージャーが語るマネジメント職の大切さとは？
  6. 6
    ゲーム業界で働くプログラマ・エンジニア、8割超が現在の職場のスキル評価に満足 NEW
  7. 7
    「おもしろそうドリブン」のキャリア形成、エンジニアとして成長を加速させるポイントとは？ NEW
  8. 8
    日本IBM、自動車業界に関する調査レポート「2035年 自動車業界の将来展望」を公開 NEW
  9. 9
    マイクロソフト、VSCodeの新機能「Copilot Next Edit Suggestions」のプレビュー版公開
  10. 10
    ガートナージャパン、2025年のサイバーセキュリティにおけるトップトレンドを発表 NEW
  1. 1
    ITエンジニア本大賞2025、技術書部門とビジネス書部門の大賞が決定！
  2. 2
    マイクロソフト、VSCodeの新機能「Copilot Next Edit Suggestions」のプレビュー版公開
  3. 3
    C# 13の新機能を理解する――暗黙的なインデックスアクセスとallows ref struct
  4. 4
    iOS・iPadOS 18.3がリリース
  5. 5
    3/5まで書籍全文が無料公開 『Pythonで動かして学ぶ！Kaggleデータ分析入門』
  6. 6
    AIや統計の数式を解説する美少女VTuber「AIcia Solid Project」生みの親が語る、継続できるアウトプット活動とは？
  7. 7
    Webはどんどん複雑になっている？ これまでのWebシステムのトレンドを振り返る
  8. 8
    Linuxディストリビューション「EndeavourOS Mercury」が一般提供開始
  9. 9
    ITエンジニア本大賞2025のプレゼン大会をレポート、最終決戦に臨んだ本に込められた想いとは
  10. 10
    開発者のOSS活動が会社から評価される世の中にしたい──日立製作所が専門組織設立に込めた情熱