从这篇博文开始,将讲述建立一个站点的全过程。一方面自己从未做过这类事情,算是对自己的一个挑战,另一方面也给想要学这个的同胞留点参考,特别是*需要课程设计作业和毕业设计的同志们*。
首先介绍一下网站功能。这次要建立的一个网站类似于一个在线的辩论场,用户可以发起辩论,自由选择题目,邀请其他用户参加。参加辩论的用户可以自由选择自己论点,分正反双方辩论,当然也可以选择中立进行搅浑水。
关于要用到的技术。后端采用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/的都是针对单个项目的。
今天就折腾这些,下午打球把他妈脚扭了,得歇着。