こんにちは。Catchball21　技術部の森本です。

蒸し暑い日が続いていますが、体調等は崩されていないでしょうか？
僕は少し夏バテ気味なので、早く涼しくなって欲しいと祈るばかりです。

今回は前回に続いて、DjangoによるWebアプリ開発についてご紹介します。
プロジェクト・アプリ・モデルの各作成について詳しく解説していきます。

作成するWebアプリ

今回のチュートリアルでは、シンプルな掲示板を題材にしています。
完成イメージは下記のようなイメージになります。

フォームから入力し、入力した内容を下部に表示する単純なCRUDを行うWebアプリですね。

プロジェクト作成

まずはプロジェクトを作成しましょう。 Djangoをインストールするとdjango-admin.pyコマンドが併せてインストールされます。 プロジェクト作成はdjango-admin.pyを使用して、作成します。

(django_tutorial)% django-admin.py startproject myproject

上記コマンドを実行するとmyprojectという名前のディレクトリが作成されます。 以後はこのmyproject内で作業をしていくのですが、その前にプロジェクトについてDjangoの便利な機能をご紹介します。

Djangoでは1.4からproject templateという機能が追加されました。
project templateではフォルダ構成や追加した3rd Party のライブラリ等をテンプレート化し、纏めておくことができます。またそれらのテンプレートを使用してプロジェクトを作成することができます。
つまりプロジェクトを通じて得たノウハウをテンプレート化し、次回のプロジェクトでも簡単に使用することができる機能と言えます。
テンプレートはgithub等で公開されているものがあるので、それらを使用することで初心者でもDjangoのベストプラクティスを利用することができます。

project templateについては、hirokikyさんが素晴らしい紹介記事を書いてらっしゃるので、皆さんご覧になってみてください。

今回はdjango-skelというテンプレートを使用したいと思います。
先程作成したmyprojectディレクトリを削除して、下記コマンドを実行し、新たにdjango-skelテンプレートを利用するプロジェクトを作成しましょう。

(django_tutorial)% django-admin.py startproject --template=https://github.com/rdegges/django-skel/zipball/master myproject

myprojectディレクトリが作成されていれば、成功です。

myprojectディレクトリに移動し、必要なライブラリをインストールします。django-skellでは、reqsディレクトリ以下に開発環境(dev.txt)と本番環境(prod.txt)で使用するライブラリを分けて記載しています。まずは開発用のライブラリをインストールするだけで良いでしょう。

(django_tutorial)% pip install -r reqs/dev.txt

アプリ作成

プロジェクトが作成できたら、アプリを作成します。 django-skelではアプリの配置場所としてmyproject/appsが用意されている為、myproject/apps配下に作成します。

(django_tutorial)% cd myproject/apps
(django_tutorial)% python ../../manage.py startapp simpleboard

myproject/apps配下にsimpleboardという名前のディレクトリが作成されていることを確認して下さい。 またsimpleboard配下にはviewとmodelの雛形が作成されます。

(django_tutorial)% ls simpleboard
__init__.py models.py   tests.py    views.py

アプリを作成したら、Djangoに新規作成したアプリを登録する必要があります。
myproject/settings/common.pyを編集して先程作成したsimpleboardを登録しましょう。
LOCAL_APPSに下記のようにsimpleboardを追記します。

1
2
3

LOCAL_APPS = (
    'apps.simpleboard',
)

モデル作成

アプリの作成まで完了したら、いよいよモデルを作っていきましょう。
まずは今回必要となるモデルについて考えましょう。
今回作成するのはシンプルな一行掲示板の為、最低限入力した内容を保存するカラムだけがあれば問題なさそうです。 SQLで表すとは下記のような感じになるでしょうか。

1
2
3
4

CREATE TABLE "simpleboard_board" (
   "id" integer NOT NULL PRIMARY KEY,
   "entry" varchar(255) NOT NULL
);

ではモデルを作成しましょう。
Djangoではmodels.pyがモデルに対応する為、models.pyを編集します。

1
2
3
4
5
6

from django.db import models


class Board(models.Model):

  entry = models.CharFiled(max_length=255)

上記ではentryというフィールドを持ったBoardモデルを定義しています。 クラスがDBのテーブル、クラスのアトリビュートがDBのカラムに対応しています。

モデルが定義できたら、DBに反映する必要があります。 プロジェクトのトップディレクトリに戻り下記コマンドを実行して下さい。

(django_tutorial)% python manage.py syncdb
Syncing...
Creating tables ...
Creating table auth_permission
Creating table auth_group_permissions
Creating table auth_group
Creating table auth_user_groups
Creating table auth_user_user_permissions
Creating table auth_user
Creating table django_content_type
Creating table django_session
Creating table django_site
Creating table django_admin_log
Creating table south_migrationhistory
Creating table simpleboard_board

You just installed Django's auth system, which means you don't have any superusers defined.
Would you like to create one now? (yes/no): yes
Username (leave blank to use '****): admin
Email address: admin@*****
Password:
Password (again):
Superuser created successfully.
Installing custom SQL ...
Installing indexes ...
Installed 0 object(s) from 0 fixture(s)

Synced:
 > django.contrib.auth
 > django.contrib.contenttypes
 > django.contrib.sessions
 > django.contrib.sites
 > django.contrib.messages
 > django.contrib.staticfiles
 > django.contrib.humanize
 > django.contrib.admin
 > django.contrib.admindocs
 > south
 > compressor
 > apps.simpleboard
 > debug_toolbar

Not synced (use migrations):
 - djcelery
(use ./manage.py migrate to migrate these)

初めてsyncdbを実行した際は、管理者ユーザを作成するかを聞かれます。
yesと入力すると、管理者ユーザに必要な情報（ユーザ名、メールアドレス、パスワード）を聞かれるので、適当なものを入力して下さい。 作成した管理者ユーザはadmin siteへログインする際に使用します。

以上でモデルの作成は完了です。

次回はviewの作成についてご紹介する予定です。