はじめに
Djangoチュートリアル①（インストールとプロジェクトの作成）に続いて、アプリを作成してみる。はじめての Django アプリ作成、その1、現場で使える Django の教科書（基礎編）を参考にする。
Polls アプリケーション作成
チュートリアルにしたがって、Polls アプリを作成する。（Polls は「世論調査」を意味するらしい。どんなアプリになるのか検討がつかない。。。）
アプリは Python パス上のどこにでも置けるがここでは manage.py と同じディレクトリ（ mysite 配下）に作成する。基本的には、プロジェクトが1番外側の大きな箱で、その中に複数のアプリケーションを追加していくといった構成となる。
$ cd mysite
$ python manage.py startapp polls
# polls ディレクトリ以下のファイルが自動で作成される
mysite (<- ベースディレクトリ)
|-- manage.py
|-- config (<- 設定ディレクトリ)
| |-- __init__.py
| |-- asgi.py
| |-- settings.py
| |-- urls.py
| `-- wsgi.py
`-- polls (<- アプリケーション)
|-- __init__.py
|-- admin.py
|-- apps.py
|-- migrations
| `-- __init__.py
|-- models.py
|-- tests.py
`-- views.py
（Djangoチュートリアル①（インストールとプロジェクトの作成）で config を作成したためここでは config が存在するが、$ django-admin startproject mysite でプロジェクトを作成した場合は config ではなく mysite となる。）
ビューの作成
ビューはリクエストに応じたレスポンスを返すという役割を持つ。Web アプリケーションでは、①ブラウザがリクエストを送信、② URLconf に登録された設定に基づいて、リクエストされた URL にマッチするビューを呼び出す、③ブラウザにレスポンスを返す、といった流れになっている。（実際は DB が関わってきたりともっと複雑だが、シンプルな例だとこんな感じのはず。）
以下でビューと URLconf の設定をして単純な例を試してみる。ビューは polls/views.py に、 URLconf の設定は config/urls.py に記述する。
polls/views.py
ビュー関数の書き方には、①関数ベース、②クラスベースの大きく2通りの書き方がある。現場で使える Django の教科書（基礎編）では②クラスベースの書き方を推奨しているが、ここでははじめての Django アプリ作成、その1にしたがって①関数ベースでの書き方を採用することとする。（②クラスベースの書き方についても理解したのち書きたい。）
from django.http import HttpResponse
def index(request):
return HttpResponse("Hello, world. You're at the polls index.")
index() 関数はリクエストに対して決められた文字列（"Hello, world. You're at the polls index."）を返すシンプルな関数となっている。
polls/urls.py と config/urls.py
上記では config/urls.py に URL 設定を記述すればよいと書いたが、設定数が多くなると管理が大変になるため、アプリケーションごとに urls.py を作成することでわかりやすくする。具体的には、 Polls アプリに関する URL 設定を polls/urls.py に記述し、各アプリの URL 設定を config/urls.py で読み込む、という構造になる。アプリケーション作成時に polls/urls.py ファイルの自動作成はされないため $ touch polls/urls.py で作成し、以下コードを記述する。
from django.urls import path
from . import views
app_name = 'polls'
urlpatterns = [
path('', views.index, name='index'),
]
URLconf は urlpatterns という名前のリスト型変数に URL パターンとビュー関数の対応関係を追加することで設定できる。django.urls.path() 関数は第1引数に URL パターンを指定し、第2引数に URL パターンにマッチするビュー関数を指定することで設定ができる。name は URL パターンに名前をつけることができ、それにより URL を逆引きすることができる。また app_name はアプリケーションごとの urls.py に付けられる名前空間で、これも逆引きに使えるため設定しておいたほうがよいとのこと。（基本的に appn_name は アプリケーション名と同じにしておけばよいらしい。）
次に config/urls.py に上記で作成した polls/urls.py モジュールの記述を反映させる。具体的には、① django.urls.include の import、② urlpatterns のリストに include() の追加。
from django.contrib import admin
from django.urls import include, path
urlpatterns = [
path('polls/', include('polls.urls')),
path('admin/', admin.site.urls),
]
django.urls.include() 関数は他の URLconf を参照できる関数である。path('polls/', include('polls.urls')) により polls/ で始まる URL パターンのすべてを polls/urls.py で登録した URLconf から参照するようになっている。このように config/urls.py に全設定を記述しなくても、各アプリで設定した urls.py を include することができる。
（※ path('admin/', admin.site.urls) は管理サイトを表しているらしい。 http://localhost:8000/admin/ でアクセスすることはできるが、詳細はわかっていないため現段階では言及しない。）
これで index ビューを URLconf に紐付けができた。下記コマンドを実行して http://localhost:8000/polls/ にアクセスすると polls/views.py で定義した Hello, world. You're at the polls index. が表示されるのが確認できる。今回の場合、config/urls.py にて 'polls/' を、polls/urls.py では '' を指定していたため、 http://localhost:8000/polls/ で views.index() を呼び出すこととなる。
$ python manage.py runserver
おわりに
はじめての Django アプリ作成、その1のチュートリアルだけでは内容がよく理解できなかったので、現場で使える Django の教科書（基礎編）を読みながらチュートリアルを進めた。はじめての Django アプリ作成、その2を続けてやっていく予定。
関連記事のリンクは以下。