【Django】ビュー（views.py）：初心者向けに５ステップで解説

Djangoにおけるビュー（views.py）は、ユーザーからのリクエストを受け取り、それに基づいたレスポンスを生成するコンポーネントです。言い換えると、ユーザーとアプリケーションの間のインターフェースの役割を果たすのがビューです。

この記事では、Djangoのビュー（views.py）について、初心者でも理解できるように詳しく解説します。

Pythonエンジニア/Djangoを利用したWeb開発者を目指す方であれば知らないと恥ずかしい超・基本知識の１つ。是非最後までご覧ください。

Djangoのビュー（view）とは？

Djangoにおけるビューは、ユーザーからのリクエストを受け取り、それに基づいたレスポンスを生成するコンポーネントです。つまり、ユーザーとアプリケーションの間のインターフェースの役割を果たします。

ビューは基本的にPythonの関数またはクラスとして定義されます。その役割はユーザーからのHTTPリクエストを受け取り、HTTPレスポンスを返すことです。

参考　HTTPリクエスト/HTTPレスポンスとは？

このレスポンスは通常、HTML形式のWebページですが、JSON形式のデータや、リダイレクト、404エラーなど、他の任意の形式のレスポンスも可能です。

ビューの基本的な作成方法は2つ。１つは関数ベースのビュー、もう１つはクラスベースのビューです。

以下に、関数ベースのビューとクラスベースのビューの特徴と違いを表形式で整理しました。

	関数ベースビュー	クラスベースビュー
定義方法	Pythonの関数として定義	Pythonのクラスとして定義
適用範囲	小規模なアプリケーションや単純なビュー	大規模なアプリケーションや複雑なビュー
特徴	シンプルで直感的な構造	再利用性と拡張性が高い
メソッド	HTTPメソッド（GET, POSTなど）ごとに条件分岐が必要	HTTPメソッドごとに異なるメソッド（get(), post()など）を定義できる
ミックスイン	使用不可	使用可能（複数のビヘイビアを組み合わせることが可能）
例	def hello_world(request): return HttpResponse("Hello, World!")	class HelloWorldView(TemplateView): template_name = "hello_world.html"

関数ベースのビューはそのシンプルさから理解しやすく、小規模なアプリケーションや単純なビューの作成に適しています。一方、クラスベースのビューは再利用性と拡張性が高く、大規模なアプリケーションや複雑なビューの作成に適しているのが特徴。

関数ベースビューの作成

関数ベースのビューは、Pythonの関数として定義され、１つのHTTPリクエストに対して１つのHTTPレスポンスを返します。

早速、具体的なコードを見てみましょう。以下は、最も基本的な関数ベースのビューの例です。

from django.http import HttpResponse

def hello_world(request):
    return HttpResponse("Hello, World!")

参考　import文 / def文

このコードは、hello_worldという名前のビューを定義。このビューは、HTTPリクエストを受け取り、"Hello, World!"というテキストを含むHTTPレスポンスを返します。

関数ベースのビューは、そのシンプルさから、小規模なアプリケーションや単純なビューの作成に適しています。しかし、大規模なアプリケーションや複雑なビューを作成する場合には、クラスベースのビューを使用することが推奨されます。

クラスベースビューの作成

関数ベースのビューがシンプルで直感的な一方で、クラスベースのビューはその再利用性と拡張性から、より大規模なアプリケーションや複雑なビューの作成に適しています。

早速、こちらも具体的なコードを見てみましょう。以下は、最も基本的なクラスベースのビューの例です。

from django.views.generic import TemplateView

class HelloWorldView(TemplateView):
    template_name = "hello_world.html"

参考　class文 / 変数の基本

このコードは、HelloWorldViewという名前のビューを定義。このビューは、TemplateViewというDjangoが提供するビューの親クラスを継承しており、hello_world.htmlというテンプレートを使用してHTTPレスポンスを生成します。

	関数ベースビュー	クラスベースビュー
定義方法	Pythonの関数として定義	Pythonのクラスとして定義
適用範囲	小規模なアプリケーションや単純なビュー	大規模なアプリケーションや複雑なビュー
特徴	シンプルで直感的な構造	再利用性と拡張性が高い
メソッド	HTTPメソッド（GET, POSTなど）ごとに条件分岐が必要	HTTPメソッドごとに異なるメソッド（get(), post()など）を定義できる
ミックスイン	使用不可	使用可能（複数のビヘイビアを組み合わせることが可能）
例	def hello_world(request): return HttpResponse("Hello, World!")	class HelloWorldView(TemplateView): template_name = "hello_world.html"

以上が、クラスベースのビューの基本的な作成方法とその使用方法です。次の章では、クラスベースのビューをさらに拡張する方法について解説します。

クラスベースビューの拡張（汎用ビューの活用）

クラスベースのビューは、その再利用性と拡張性から、より大規模なアプリケーションや複雑なビューの作成に適しています。

たとえば、Djangoには、データベースからオブジェクトを取得して表示するためのListView、新しいオブジェクトを作成するためのCreateView、既存のオブジェクトを更新するためのUpdateView、オブジェクトを削除するためのDeleteViewなど、多くの汎用ビューがあります。

Django：ListView

ListViewは、あるモデルのオブジェクトのリストを表示するためのビューです。デフォルトでは、これは全てのオブジェクトを取得しますが、get_querysetメソッドをオーバーライドすることでカスタマイズできます。

from django.views.generic import ListView
from .models import Book

class BookListView(ListView):
    model = Book
    template_name = 'books/book_list.html'  # <app>/<model>_<viewtype>.html

Django：DetailView

DetailViewは、単一のオブジェクトの詳細を表示するためのビューです。

from django.views.generic import DetailView
from .models import Book

class BookDetailView(DetailView):
    model = Book
    template_name = 'books/book_detail.html'  # <app>/<model>_<viewtype>.html

Django：CreateView

CreateViewは、新たなオブジェクトを作成するためのビューです。

from django.views.generic.edit import CreateView
from .models import Book

class BookCreateView(CreateView):
    model = Book
    fields = ['name', 'author', 'price']  # ここにモデルのフィールドを記述
    template_name = 'books/book_form.html'  # <app>/<model>_<viewtype>.html

Django：UpdateView

UpdateViewは、既存のオブジェクトを更新するためのビューです。

from django.views.generic.edit import UpdateView
from .models import Book

class BookUpdateView(UpdateView):
    model = Book
    fields = ['name', 'author', 'price']
    template_name = 'books/book_form.html'  # <app>/<model>_<viewtype>.html

Django：DeleteView

DeleteViewは、既存のオブジェクトを削除するためのビューです。

from django.views.generic.edit import DeleteView
from .models import Book

class BookDeleteView(DeleteView):
    model = Book
    template_name = 'books/book_confirm_delete.html'  # <app>/<model>_<viewtype>.html
    success_url = '/'  # 削除後にリダイレクトするURL

以上が、Djangoの汎用ビューの基本的な活用方法とその使用方法です。このように、汎用ビューを使用すると、一般的なWeb開発タスクを簡単に行うことができます。

ビューのテスト

Djangoビューのテストは、アプリケーションの品質を確保するために重要なステップです。テストを行うことで、ビューが期待通りに動作することを確認し、エラーやバグを早期に発見することが可能に。

Djangoはビューのテストを支援するための強力なツールを提供しており、それはdjango.testモジュールのTestCaseクラスという形で用意されています。

我々はこのクラスをうまく使用することで、簡単にビューのテストを行うことができます。

ステップ1：テストケースの作成

まず、django.test.TestCaseを継承したクラスを作成します。このクラス内にテストメソッドを定義します。

from django.test import TestCase

class MyViewTest(TestCase):
    ...

ステップ2：テストメソッドの定義

次に、テストケースクラス内にテストメソッドを定義します。テストメソッドの名前はtest_で始まる必要があります。

def test_my_view(self):
    ...

ステップ3：ビューのテスト

最後に、TestCaseクラスのclient属性を使用して、ビューにリクエストを送信し、レスポンスを検証します。

response = self.client.get('/my-view-url/')
self.assertEqual(response.status_code, 200)

このコードは、/my-view-url/にGETリクエストを送信し、レスポンスのステータスコードが200（成功）であることを確認しています。

Django：ビュー（views.py）のまとめ

Pythonをはじめとするプログラミングスキルを武器に、時間と場所に捉われない自由な生き方を目指してみませんか？今すぐ行動したい方は以下の記事をチェック！

読者料典　Python入門：学習カリキュラム　←こちらから！