编写Python的web框架中的Model的教程

import time, uuid

from transwarp.db import next_id
from transwarp.orm import Model, StringField, BooleanField, FloatField, TextField

class User(Model):
 __table__ = 'users'

 id = StringField(primary_key=True, default=next_id, ddl='varchar(50)')
 email = StringField(updatable=False, ddl='varchar(50)')
 password = StringField(ddl='varchar(50)')
 admin = BooleanField()
 name = StringField(ddl='varchar(50)')
 image = StringField(ddl='varchar(500)')
 created_at = FloatField(updatable=False, default=time.time)

class Blog(Model):
 __table__ = 'blogs'

 id = StringField(primary_key=True, default=next_id, ddl='varchar(50)')
 user_id = StringField(updatable=False, ddl='varchar(50)')
 user_name = StringField(ddl='varchar(50)')
 user_image = StringField(ddl='varchar(500)')
 name = StringField(ddl='varchar(50)')
 summary = StringField(ddl='varchar(200)')
 content = TextField()
 created_at = FloatField(updatable=False, default=time.time)

class Comment(Model):
 __table__ = 'comments'

 id = StringField(primary_key=True, default=next_id, ddl='varchar(50)')
 blog_id = StringField(updatable=False, ddl='varchar(50)')
 user_id = StringField(updatable=False, ddl='varchar(50)')
 user_name = StringField(ddl='varchar(50)')
 user_image = StringField(ddl='varchar(500)')
 content = TextField()
 created_at = FloatField(updatable=False, default=time.time)

在编写ORM时，给一个Field增加一个default参数可以让ORM自己填入缺省值，非常方便。并且，缺省值可以作为函数对象传入，在调用insert()时自动计算。

例如，主键id的缺省值是函数next_id，创建时间created_at的缺省值是函数time.time，可以自动设置当前日期和时间。

日期和时间用float类型存储在数据库中，而不是datetime类型，这么做的好处是不必关心数据库的时区以及时区转换问题，排序非常简单，显示的时候，只需要做一个float到str的转换，也非常容易。
初始化数据库表

如果表的数量很少，可以手写创建表的SQL脚本：

-- schema.sql

drop database if exists awesome;

create database awesome;

use awesome;

grant select, insert, update, delete on awesome.* to 'www-data'@'localhost' identified by 'www-data';

create table users (
 `id` varchar(50) not null,
 `email` varchar(50) not null,
 `password` varchar(50) not null,
 `admin` bool not null,
 `name` varchar(50) not null,
 `image` varchar(500) not null,
 `created_at` real not null,
 unique key `idx_email` (`email`),
 key `idx_created_at` (`created_at`),
 primary key (`id`)
) engine=innodb default charset=utf8;

create table blogs (
 `id` varchar(50) not null,
 `user_id` varchar(50) not null,
 `user_name` varchar(50) not null,
 `user_image` varchar(500) not null,
 `name` varchar(50) not null,
 `summary` varchar(200) not null,
 `content` mediumtext not null,
 `created_at` real not null,
 key `idx_created_at` (`created_at`),
 primary key (`id`)
) engine=innodb default charset=utf8;

create table comments (
 `id` varchar(50) not null,
 `blog_id` varchar(50) not null,
 `user_id` varchar(50) not null,
 `user_name` varchar(50) not null,
 `user_image` varchar(500) not null,
 `content` mediumtext not null,
 `created_at` real not null,
 key `idx_created_at` (`created_at`),
 primary key (`id`)
) engine=innodb default charset=utf8;

如果表的数量很多，可以从Model对象直接通过脚本自动生成SQL脚本，使用更简单。

把SQL脚本放到MySQL命令行里执行：

$ mysql -u root -p < schema.sql

我们就完成了数据库表的初始化。
编写数据访问代码

接下来，就可以真正开始编写代码操作对象了。比如，对于User对象，我们就可以做如下操作：

# test_db.py

from models import User, Blog, Comment

from transwarp import db

db.create_engine(user='www-data', password='www-data', database='awesome')

u = User(name='Test', email='test@example.com', password='1234567890', image='about:blank')

u.insert()

print 'new user id:', u.id

u1 = User.find_first('where email=?', 'test@example.com')
print 'find user\'s name:', u1.name

u1.delete()

u2 = User.find_first('where email=?', 'test@example.com')
print 'find user:', u2

可以在MySQL客户端命令行查询，看看数据是不是正常存储到MySQL里面了。