【Django入門】Djangoアプリの設計哲学!MTVモデルをmodelsを通して学ぼう!

今回は、PythonのDjangoで使われるmodelの書き方や使い方について解説します。

modelはデータベースと深い関わりがある、Djangoを構成する重要な要素の一つです。

この記事では、

・MTVモデルとは何か
・modelの作り方

について解説します。さらに、

・フィールドを使う方法

についての解説を通して、modelの知識を深めていきましょう。

MTVモデルとは

今回学ぶmodelの前に、まずはMTVモデルと呼ばれる設計思想について学んでいきましょう。

DjangoはMTVモデルを採用しています。

MTVとは、

・Model(データベースに格納されているデータ)
・Template(テンプレートファイルによって定義されたそれぞれのページのデザイン)
・View(どのページを表示させるかを決定する処理)

の頭文字を取ったものです。

図にしてみるとこのようになります。

django_mtv

よく似た設計にMVC(Model、View、Controller)というモデルもあります。

MVCモデルの場合は、

・Model(データベースに格納されているデータ)
・View(ページをどのように見せるのかを決定する処理)
・Controller(ユーザーからの入力をModelに伝える処理)

になります。

MVCモデルを採用しているフレームワークには、Ruby on Railsがあります。

modelとは

これから学んでいくmodelは具体的にどのような役割をするのか、見ていきましょう。

modelはデータベースに格納されているデータを扱います

Djangoではデータベースを直接扱わなくても良いように、models.pyに記述されているクラスを操作することで、データベースを操作することが出来ます。

modelを使うと、データベースの管理がとても楽に、コードを最小限にしながらWebアプリケーションを作ることが出来ます。

データベースについては、こちらの記事をご覧ください。

【Django入門】Databaseの使い方
更新日 : 2018年3月8日

今回の記事ではmodelの扱い方について、解説していきます。

また、後半にはフィールドというmodelを扱う場面では必須になる概念についても解説します!

modelの作り方

ここからは実際にmodelを編集して、実際の動作を見てみましょう。

Djangoのインストール方法

まずはDjangoをインストールしましょう。

DjangoはPythonのパッケージとして提供されています。

インストール方法はこちらの記事をご覧ください。

【Django入門】あなたのパソコンにDjangoをインストール!
更新日 : 2019年1月29日

プロジェクトとアプリケーションの作成

インストールが出来たら、次はプロジェクトアプリケーションを作成していきます。

プロジェクトをまず最初に作っていきましょう。

プロジェクトを作成したいディレクトリに行き、このコマンドを実行します。

mySiteは自分の好きなプロジェクト名で構いませんが、これからの記事ではすべてmySiteというプロジェクト名を想定して解説をしていきます!

実行すると、mySiteというディレクトリが出来上がります。

このディレクトリに必要なファイルが全て含まれています。

さらに今出来上がったディレクトリ(mySite)に移動して、このコマンドを実行します。

このコマンドを実行すると、プロジェクト内にmyappというWebアプリのテンプレートができます。

myappの部分はmySiteと同じく、好きなプロジェクト名で構いませんが、これからの記事ではすべてmyappというアプリケーション名を想定して解説をしていきます!

最後に、データベースを扱う場合はこのコマンドをmySiteディレクトリで実行する必要があります。

これで、プロジェクトにデータベースの構築に必要なファイルが追加されました。

これで、準備は完了です。

models.pyの書き方

ここからは実際にmodels.pyを編集していきましょう!

models.pyはmyapp/models.pyにあります。

今回はPersonクラスに、人物の情報を追加できるデータベースを作ってみましょう。

Pythonのクラスについてはこちらのページで詳しく解説しています。

【Python入門】クラスの使い方を簡単解説で楽々マスター
更新日 : 2019年7月31日

models.pyをこのように編集しましょう。

models.pyに追加するPersonなどのクラスは、すべてdjango.db.models.Modelサブクラスとして動きます。

このmodels.pyの動作を、データベースで考えてみましょう。

データベースでの動きは、Personというテーブルを作り、last_nameとfirst_nameというフィールドを設定したことになっています。

フィールドには他にも、

・日時のフィールドであるDateTimeField
・EmailアドレスのフィールドであるEmailField

など、modelの作成がより便利になるフィールドがたくさん用意されています。

次に、作ったmodelをDjangoに知らせましょう。

mySite/settings.pyのINSTALLED_APPSに、1行追加します。

INSTALLED_APPSにはDjangoに「どの機能を使うのか」を知らせる役割があるので、今後も頻繁に出てきます。

2行目に追加されている「’myapp.apps.MyappConfig’,」について解説します。

文字の並びを見て分かるように、myappというアプリケーションの中の、apps.pyの中の、MyappConfigを、読み込んでいます。

Djangoにアプリケーションの追加が終わった所で、このコマンドを実行しましょう。

makemigrationを実行することで、Djangoにmodelの変更を知らせて、migrationファイルを作成します。

migrationファイルを反映させるためには、migrateを行わなければなりません。

これで、データベースにmodels.pyを反映させることが出来ました。

これまでの作業をまとめてみると、

1.modelを書く
2.python manage.py makemigrationsの実行
3.python manage.py migrateの実行

の流れになります。

Django shellを使った確認方法

models.pyからデータベースに追加したものを、確認してみましょう。

確認にはDjango shellを利用します。

このコマンドを実行してみましょう。

このコマンドを実行すると、コンソールが起動すると思います。

ここにデータを追加してみましょう。

1行目で先ほど作成したPersonクラスをimportしています。

last_nameとfirst_nameに入れた文字列がしっかりと反映されていることが確認できましたね。

これはデータベースとのやり取りがしっかりと出来ている証拠になります。

このようにPythonだけを使用して、データベースを操作できることにDjangoの手軽さがあります。

Django shellではRuby on Railsのようにコンソール上で動作を確認することも出来ます。

フィールドについて

ここからは先程から登場していたフィールドについて、もう少し詳しく見ていきましょう。

フィールドとは

先程はmodels.CharFieldという、文字を扱うフィールドを使いました。

フィールドは保存したいデータを表すために、Djangoに最初から用意されているデータの入れ物のようなものです。

フィールドがあることによって、複雑なデータベースの操作をとても楽に行うことができます。

models.DateTimeFieldを使ってみよう

models.CharFieldは先程使ってみましたね。

今回は、models.DateTimeFieldを使って、コンソールでcreateしたときの現在時刻と、saveしたときの現在時刻を表示してみましょう。

models.pyをこのように編集します。

createdと、savedという変数に、それぞれmodels.DateTimeFieldを追加しています。

auto_now_addと、auto_nowという引数をTrueにしています。

これはcreateした時点とsaveした時点で時刻を記録するために、有効にしなければならない引数になります。

これで、先程のようにコンソールでlast_nameとfirst_nameを指定した際に、自動的に時刻が記録されるようになりました。

まとめ

この記事ではDjangoでmodelを扱うときに必要な知識を解説してきました。

データベースの基礎知識を持つだけで、Pythonから簡単にデータベースを触れるのはDjangoならではの機能です。

これまでデータベースに高い壁を感じていた人も、とても身近なものに感じられたのではないでしょうか。

データベースを利用するとWebアプリケーションで出来ることが格段に増えます。

ぜひmodelをうまく使ったサイト構築をしてみてください。

LINEで送る
Pocket

最短でエンジニアを目指すなら侍エンジニア塾

cta_under_bnr

侍エンジニア塾は業界で初めてマンツーマンレッスンを始めたプログラミングスクールです。これまでの指導実績は16,000名を超え、未経験から数多くのエンジニアを輩出しています。

あなたの目的に合わせてカリキュラムを作成し、現役エンジニア講師が専属であなたの学習をサポートするため効率よく学習を進めることができますよ。

無理な勧誘などは一切ありません。まずは無料体験レッスンを受講ください。

無料体験レッスンの詳細はこちら

書いた人

ryo

おすすめコンテンツ

あなたにぴったりなプログラミング学習プランを無料で診断!

プログラミング学習の効率を劇的に上げる学習メソッドを解説