Humming Via Kitchen

TODOリスト の続き。

今回はアプリケーション作成からモデル作成ぐらいまで。

ではさっそく前回作ったプロジェクトの中にアプリケーションを作る。アプリケーション名はTODOリストなので todo とかにする。

$ ./manage.py startapp todo
$ ls -al ./todo
   0 Jun 20 02:48 __init__.py
  57 Jun 20 02:48 models.py
  26 Jun 20 02:48 views.py

出来たアプリケーションの中身はディレクトリの中に３枚のファイルだけ。 Django のポリシー的に「使うかどうか分かんないものは作らない。」らしい？こういうところ、個人的には好き。いつ使うのか分からないファイル群に翻弄されることがないからね。

このタイミングで settings.py の INSTALLED_APPS に、今作った todo なアプリを登録しておく。これをやっておかないと Django が見向きもしてくれない。

# 一番下にでも追加する。
INSTALLED_APPS = (
    ...,
    'hige.todo',
)

次はモデルの作成に入る。今回はテーブル１個で済ませてしまおうかと思ったものの、

「 JOIN とかどうやるんだよ!?」

な声が聞こえそうなので２個使ってやってみる。１つ目は todo の内容を保存するテーブル。もう１つは優先度を定義するテーブル。どうってことはないものの、まぁ楽しさは結構上がると思う。

ではさっそくアプリケーション作った時に出来た models.py を編集していく。

from django.db import models

# 日付を扱うのでインポート
import datetime

# 優先度のテーブル（モデル）
class Priority(models.Model):
    label = models.CharField(maxlength=20)

    class Meta:
        pass

    class Admin:
        pass

    def __str__(self):
        return self.label


# Todoの内容のテーブル（モデル）
class Task(models.Model):
    priority    = models.ForeignKey(Priority)
    description = models.CharField(maxlength=100)
    created_at  = models.DateTimeField(editable=False)
    updated_at  = models.DateTimeField(editable=False)
    is_active   = models.BooleanField(editable=False, default=True)

    class Meta:
        pass

    class Admin:
        pass

    def __str__(self):
        return self.description

    def save(self):
        current = datetime.datetime.now()
        self.updated_at = current
        if self.id is None:
            self.created_at = current
        super(Task, self).save()

    def delete(self):
        self.is_active = False
        self.save()

ココでちょっとした説明。カラム定義の部分は見たままなので大丈夫だと思う。 editable を False にするとフォームに関連づけされなくなる。ので、ブラウザ越しで直には触れなくなる。

Task に関しては登録日時（ created_at ）と更新日時（ updated_at ）、論理削除フラグ（ is_active ）を持たせてみた。要らないかな？と思ったものの、ここらへんは某endless氏に対応。で、登録日時、更新日時を自動で入れる為に save をオーバーライドして、 id が None なら新規登録なので登録日時も入れるようにしてある。あとは論理削除をさせる為に delete をオーバーライド。

__str__ は他の言語で言う toString で、 Django の中で頻繁に呼び出されるメソッドなので定義しておいた方が良い。表側を作る時にも結構便利だし。このほかにも get_absolute_url ってのもあって、そのオブジェクトに対してユニークになるURLを返すためのメソッドとして使われる。今回は要らないかな？って事で作ってない。必要になったらその時作ろうと思う。

で、ここで作ったモデルをデータベースに反映させる為に syncdb を叩く訳ですが、 Priority には最初からデータが入っててほしいので、自動で流し込むようにひと工夫。アプリケーション直下に sql なディレクトリを作っておいて、 model_name.db_engine.sql なファイルを作っておくと Django が自動で食べてくれる。汎用性のあるSQLなら model_name.sql でも大丈夫。今回は初期データだけなので priority.sql にして作っておく。

$ cd ./todo
$ mkdir sql
$ cd sql
$ touch priority.sql

中身はインサート文をベタで書いておく。出来上がるテーブル名にはアプリケーション名のプリフィックスが自動で付くので、それを考慮しておく。

INSERT INTO todo_priority (label) VALUES ('Low'),('Mid'),('High');

あとは syncdb を叩いてデータベースに反映する。

$ ./manage.py syncdb
Creating table todo_priority
Creating table todo_task
Installing custom SQL for todo.Priority model
Installing index for todo.Task model
Loading 'initial_data' fixtures...
No fixtures found.

最後の No fixtures found なメッセージはエラーでは無いので気にしない。 Installing custom SQL for todo.Priority model なメッセージがあればちゃんとさっきのSQLをロードしてくれているはず。

以下、今回のまとめ？

• Django は絶対必要なもの以外は作らない。
• モデルが持つ __str__ 、 get_absolute_url は特別なメソッド。
• アプリケーション直下の sql なディレクトリは意味深。
• モデル定義のもっと詳しい情報は コチラ とか 本家情報 で。

今回も進まないまま時間だけが過ぎてった。次回はテンプレートとか触れたら良いなぁ。汎用ビュー使おうかどうか迷う。

TrackBacks

まだ登録されていません。

Comments

Add Comment