使用tornado和angularjs搭建网站

从这篇博文开始，将讲述建立一个站点的全过程。一方面自己从未做过这类事情，算是对自己的一个挑战，另一方面也给想要学这个的同胞留点参考，特别是*需要课程设计作业和毕业设计的同志们*。

首先介绍一下网站功能。这次要建立的一个网站类似于一个在线的辩论场，用户可以发起辩论，自由选择题目，邀请其他用户参加。参加辩论的用户可以自由选择自己论点，分正反双方辩论，当然也可以选择中立进行搅浑水。

关于要用到的技术。后端采用Python开发，框架选用Tornado，前端使用AngularJS配合jQuery，数据库选择PostgreSQL，操作系统当然要用Ubuntu了。

这里选择的技术完全是因为个人喜好，绝不是因为和其他方案相比有啥优劣之分。另外，因为我也使用过Python、JavaScript，但从未做过实际的项目，所以代码质量可能会比较丢人。

### 关于Tornado ###
Tornado是一个使用Python开发的web框架，按其作者说法，Tornado从另一个小巧的框架web.py借鉴了很多东西。和其他框架不同，Tornado并不是很庞大的一个框架，只是提供了一些基本的功能，带来的好处是比较灵活，和其他功能模块可以很容易结合到一块，缺点则是工作量多点。

##### Tornado在Ubuntu下的安装 ####
首先安装pip
sudo apt-get install python-pip
然后安装Tornado
sudo pip install tornado
当然，也可以使用easy_install来安装。

#### Tornado入门 ####
先来看一个简单的Tornado例子（代码来自tornado官网）
import tornado.ioloop
import tornado.web

class MainHandler(tornado.web.RequestHandler):
def get(self):
self.write("Hello, world")

application = tornado.web.Application([
(r"/", MainHandler),
])

if __name__ == "__main__":
application.listen(8888)
tornado.ioloop.IOLoop.instance().start()

用tornado开发web应用还是比较简单的，主要步骤就是如上所示，设置好(URL, Handler)的映射，至于其他功能，还有待进一步学习。

### 关于AngularJS ###
AngularJS是从大Google出来的前端框架，提供了数据绑定等功能，但是没有对DOM操作进行封装，所以和jQuery代培使用比较好。

### 关于PostgreSQL ###
PostgreSQL是一个开源的关系型数据库，功能强大，但是国内的普及度不高，自从9.2开始原声支持json之后，再加上本身又提供类似按列存储的功能，国外有些人已经开始把它当作NoSQL来用了。

这系列博文中即将建立的站点称为“嘚啵嘚”。

## 数据库表的设计 ##

"嘚啵嘚"使用的数据库是PostgreSQL，因此你要确定自己的系统中已经安装好了它。网上关于这方面的文章很多，不再说了。

#### 首先建立开发者账户，数据库 ####

create role developer with password 'developer';
alter role developer LOGIN;

create database debate;
grant all privileges on database debate to developer;

#### 接下来建立三个表，users用于存储用户信息，debates用于存储辩论自身的相关信息，arguments用于存储用户的论点（也就是发言内容）。 ####

建立用户信息表，这里我们只需要存储用户的帐号（使用email地址，需要保证唯一）、密码以及账户状态，同时要对每一个用户生成一个独立的ID，并在此ID上建立主键约束。

CREATE TABLE users
(
user_id serial NOT NULL, -- 用户ID
email character(256) NOT NULL, -- 用户邮箱地址
passwd character(128) NOT NULL, -- 用户密码
state smallint NOT NULL DEFAULT 0, -- 账户状态：0--未激活 1--已激活
CONSTRAINT users_pk_id PRIMARY KEY (user_id),
CONSTRAINT user_uk_email UNIQUE (email)
)
WITH (
OIDS=FALSE
);
ALTER TABLE users
OWNER TO developer;
COMMENT ON TABLE users
IS '用户信息表';
COMMENT ON COLUMN users.user_id IS '用户ID';
COMMENT ON COLUMN users.email IS '用户邮箱地址';
COMMENT ON COLUMN users.passwd IS '用户密码';
COMMENT ON COLUMN users.state IS '账户状态：0--未激活 1--已激活';

建立辩论表。

CREATE TABLE debates
(
debate_id serial NOT NULL, -- 辩论题目ID
originator serial NOT NULL, -- 发起人ID
create_time date NOT NULL DEFAULT now(), -- 发起时间
supportors_count integer NOT NULL DEFAULT 0, -- 支持者人数
opposers_count integer NOT NULL DEFAULT 0, -- 反对者人数
neutral_count integer NOT NULL DEFAULT 0, -- 中立者人数
topic character(1024) NOT NULL, -- 辩论主题
support_argument character(1024) NOT NULL, -- 正方观点综述
oppose_argument character(1024) NOT NULL, -- 反方观点综述
CONSTRAINT debate_pk_id PRIMARY KEY (debate_id),
CONSTRAINT debate_fk_originator FOREIGN KEY (originator)
REFERENCES users (user_id) MATCH SIMPLE
ON UPDATE NO ACTION ON DELETE NO ACTION
)
WITH (
OIDS=FALSE
);
ALTER TABLE debates
OWNER TO developer;
COMMENT ON COLUMN debates.debate_id IS '辩论题目ID';
COMMENT ON COLUMN debates.originator IS '发起人ID';
COMMENT ON COLUMN debates.create_time IS '发起时间';
COMMENT ON COLUMN debates.supportors_count IS '支持者人数';
COMMENT ON COLUMN debates.opposers_count IS '反对者人数';
COMMENT ON COLUMN debates.neutral_count IS '中立者人数';
COMMENT ON COLUMN debates.topic IS '辩论主题';
COMMENT ON COLUMN debates.support_argument IS '正方观点综述';
COMMENT ON COLUMN debates.oppose_argument IS ' 反方观点综述';

建立参加者观点表

CREATE TABLE arguments
(
argument_id serial NOT NULL, -- 论点ID
debater_id serial NOT NULL, -- 辩论者ID
debate_id serial NOT NULL, -- 所属辩论ID
type integer NOT NULL DEFAULT 2, -- 论点类型：0--反对 1--支持 2--中立
publish_date date NOT NULL DEFAULT now(), -- 发布时间
viewpoint character(1024) NOT NULL, -- 观点
CONSTRAINT argument_id PRIMARY KEY (argument_id),
CONSTRAINT argument_fk_debate FOREIGN KEY (debate_id)
REFERENCES debates (debate_id) MATCH SIMPLE
ON UPDATE NO ACTION ON DELETE NO ACTION,
CONSTRAINT argument_fk_debater FOREIGN KEY (debater_id)
REFERENCES users (user_id) MATCH SIMPLE
ON UPDATE NO ACTION ON DELETE NO ACTION
)
WITH (
OIDS=FALSE
);
ALTER TABLE arguments
OWNER TO developer;
COMMENT ON COLUMN arguments.argument_id IS '论点ID';
COMMENT ON COLUMN arguments.debater_id IS '辩论者ID';
COMMENT ON COLUMN arguments.debate_id IS '所属辩论ID';
COMMENT ON COLUMN arguments.type IS '论点类型：0--反对 1--支持 2--中立';
COMMENT ON COLUMN arguments.publish_date IS '发布时间';
COMMENT ON COLUMN arguments.viewpoint IS '观点';

其实在实际开发中，表名、数据库名、索引等最好加上前缀或者后缀来作区分，向上面这样数据库叫debates，里边有个表也叫debates其实是不太好的。

## 下面讲一下Python下操作PostgreSQL用到的模块psycopg2。 ##

### 安装psycopg2和 ###

安装过程需要安装postgresql-server-dev以及python-devel

sudo apt-get install postgresql-server-dev python-devel
sudo pip install psycopg2

##### psycopg2使用实例 #####

import psycopg2
import psycopg2.extensions
import psycopg2.extras

con = psycopg2.connect(host=‘localhost’,
post=5432,
user='developer',
password='developer',
database='debate')

cursor = con.cursor(cursor_factory=psycopg2.extras.DictCursor)

cursor.execute('select * from debates where debate_id = %s;', (debate_id,))

debate = cursor.fetchone();

con.commit()

这个模块用起来还是比较方便的，值得注意的是cursor.execute中的sql语句结尾的分号不能省略，而且第二个参数必须要是序列（List或者Tuple)

## 站点页面设计 ##
由于前端使用AngularJS，所以这次打算彻底一点，作成一个单页应用，所有前端的渲染都使用js绘制。后端除了初始页面之外，提供的都是数据。

这一个系列博客的代码都放在了Github上，地址是http://github.com/JimmyChange/debate

#### 代码主文件的设计 ####

// server.py
import tornado.ioloop
import tornado.web

import handlers

setting = [
]

application = tornado.web.Application([
(r"/", handlers.HomeHandler),
(r"/login", handlers.LoginHandler),
(r"/users/([0-9]+)", handlers.UserHandler),
(r"/debates", handlers.DebatesHandler),
(r"/debates/([0-9]*)", handlers.DebateHandler),
(r"/debates/([0-9]+)/arguments", handlers.ArgumentsHandler),
(r"/debates/([0-9]+)/arguments/([0-9]*)", handlers.ArgumentHandler),
])

if __name__ == "__main__":
application.listen(8888)
tornado.ioloop.IOLoop.instance().start()

// handlers.py
......

class DebatesHandler(BaseHandler):
def get(self):
self.write("Debates Handler")

class DebateHandler(BaseHandler):
def get(self, debate_id):
self.write(debate_id)
self.write("Debate Handler")

def post(self, debate_id):
self.write(debate_id)
self.write("Debate Handler")

def put(self, debate_id):
self.write(debate_id)
self.write("Debate Handler")

def delete(self, debate_id):
self.write(debate_id)
self.write("Debate Handler")

......

上面只是代码的一部分，列在这里是为了说明一下URL的格式。对于/collections的操作都是对于整个集合的，而对于/collection/的都是针对单个项目的。

今天就折腾这些，下午打球把他妈脚扭了，得歇着。