一、前言
接下来我将正式讲解《基于Angular2+MongoDB+Node技术实现的博客系统》需求及UI设计和项目路由规则。本项目虽小,但无论前期的项目规划设计还是后期的代码规范,我还是想立求正规化,努力做到 ”麻雀虽小,五脏俱全“ ,争取本项目源码你拿到后可直接上手真实项目开发。
二、项目需求
搭建一个简单的具有多人注册、登录、发表文章、登出功能的博客。
三、mongodb node模块基本配置
首先,node命令行工具,先定位到项目blog所在的目录下,然后给项目安装mongodb支持模块,命令如下:
cnpm install mongodb --save
PS: 加--save参数的目的是让配置文件自动写入package.json
接下来在工程的根目录中创建 settings.js 文件,用于保存该博客工程的配置信息,比如数据库的连接信息。我们将数据库命名为 blog,因为数据库服务器在本地,所以 settings.js 文件的内容如下:
module.exports = {
cookieSecret: 'myblog',
db: 'blog',
host: 'localhost',
port: 27017,
client:'http://localhost:3000' //用于设置跨域
};
其中 db 是数据库的名称,host 是数据库的地址,port是数据库的端口号,cookieSecret 用于 Cookie 加密与数据库无关,我们留作后用。client: 用于以后设置网站跨域Ajax调用,这里你只需先照搬设置即可。
接下来在根目录下新建 models 文件夹,并在 models 文件夹下新建 mongodb.js ,添加如下代码:
//引入mongoose
var mongoose = require('mongoose');
var settings = require("../settings");
//用户模型
var UserModel;
//文章模型
var PostModel;
//连接数据库
mongoose.connect('mongodb://'+settings.host+'/'+settings.db,
function(err){
if(err) {
console.err(err);
throw err;
}
});
//定义users-用户文档
var users = new mongoose.Schema({
name:String,
password:String,
email:String
});
//声明一个User模型,使用它和数据库交互
UserModel = mongoose.model('users',users);
//定义posts-文章模型
var posts = new mongoose.Schema({
name: String,
time: new mongoose.Schema({
date: Date,
year:Number,
month:String,
day:String,
minute:String
}),
title: String,
post: String
});
//声明一个Posts模型,使用它和数据库交互
PostModel = mongoose.model('posts',posts);
module.exports = {"Users":UserModel,"Posts":PostModel};
代码说明如下:
1. var mongoose = require('mongoose');
引入mongoose第三方组件,在此之前,需要先本地下载mongoose第三方包:
node命令行工具,先定位到项目blog所在的目录下,然后给项目安装mongodb支持模块,命令如下:
cnpm install mongodb --save
PS: 加"--save"参数的目的是让配置文件自动写入package.json
2. var settings = require("../settings");
导入setting配置文件,后面会配置数据库连结要用
3. var UserModel; var PostModel;
分别定义系统中将来需要用到的“ 用户模型” 和 “文章模型” ,这里的模板,你可以理解为将来用于操作数据库的ORM映射,即,将来通过他们以面向对象的方式来操作数据库。后面有对他们的创建代码。
4. mongoose.connect('mongodb://'+settings.host+'/'+settings.db,
function(err){
if(err) {
console.err(err);
throw err;
}
});
操作数据库之前,必须先连结数据库。此步操作即是连结数据库操作。语法是:
mongoose.connect(‘数据库连结字符串',callback回调函数)
数据库连结字符串格式:
"mongodb://连结数据库所在服务器IP(端口号可省)/数据库" , 本系统中实际的数据库连结字符串为:
mongodb://localhost/blog
5. var users = new mongoose.Schema({
name:String,
password:String,
email:String
});
这里我们通过new mongoose.Schema的方法定义users-用户文档,相当于为MongoDB自动创建一个文档(表)结构,三个字段分别为:name: String ;//用户名,password:String; //密码 , email:String; //Email
UserModel = mongoose.model('users',users);
这里声明一个User模型,使用它和数据库交互,相当于创建一个用户文档(用户表),名为“users",文档(表)结构为上述的users所对应的字段类型。
6.var posts = new mongoose.Schema({
name: String,
time: new mongoose.Schema({
date: Date,
year:Number,
month:String,
day:String,
minute:String
}),
title: String,
post: String
});
这里我们通过new mongoose.Schema的方法定义定义posts-文章模型,相当于为MongoDB自动创建一个文档(表)结构,三个字段分别为:name: String ;//用户名,time:内嵌一新的数据类型; , title:String; //发表的文章标题 , post: String //发表的文章内容
PS:需特别说明是:time: new mongoose.Schema({
date: Date,
year:Number,
month:String,
day:String,
minute:String
}), 这段代码给我们示例了如何自定义一复杂数据文档类型
PostModel = mongoose.model('posts',posts);
//声明一个Posts模型,使用它和数据库交互,相当于创建一个文章文档(文章表),名为“posts",文档(表)结构为上述的posts所对应的字段类型。
7.module.exports = {"Users":UserModel,"Posts":PostModel};
把 Users用户模型 和Posts文章模型 对外以接口方式导出两个实例,供外部调用!
四、为了让项目能跑起来,我们要规划好本项目路由
接下来的任务就是完成路由规划了。路由规划,或者说控制器规划是整个网站的骨架部分,因为它处于整个架构的枢纽位置,相当于各个接口之间的粘合剂,所以应该优先考虑。
根据构思的设计图,我们作以下路由规划:
/login :用户登录
/reg :用户注册
/post :发表文章
/logout :登出
要求/login和/reg只能是未登录的用户访问,而/post和/logout只能是已登录的用户访问。左侧导航列表则针对已登录和未登录的用户显示不同的内容。
具体如下,见代码注释:
修改routes/index.js如下:
module.exports = function(app) {
/*
说明:本接口用于获取博客列表的信息的。http://localhost:3000/get/post?name=zzz
1.get/:说明是get请求
2.如果传递了name参数,则说明是:请求某一个人的博文。如:http://localhost:3000/get/post?name=zzz
3.如果没传递name参数,则说明是请求所有人的博文列表,显示在首页
*/
app.get('/get/post', function(req, res) {
res.send('本接口用于获取博客列表的信息的!');
});
/*
说明:本接口用于获取用户信息的。http://localhost:3000/get/user?name=zzz
1.get:说明是get请求
2.如果传递了name参数,则说明是:请求某个用户的信息。如:http://localhost:3000/get/user?name=admin
3.如果没传递name参数,则说明是请求所有用户的信息
*/
app.get('/get/user', function(req, res) {
res.send('本接口用于获取用户信息的!');
});
/*
说明:本接口用于提交注册用户信息的。http://localhost:3000/post/reg
1.post/:说明是post请求
2.注册未成功,返回Json格式如下:{status:'failed',message:"xxxxxx!"}
3.注册成功,返回Json格式如下:{status:'success',message:"注册成功!",user:user}
*/
app.post('/post/reg', function(req, res) {
res.send('本接口用于提交注册用户信息的!');
});
/*
说明:本接口用于提交用户登录信息的。http://localhost:3000/post/login
1.post/:说明是post请求
2.登录未成功,返回Json格式如下:{status:'failed',message:"xxxxxx!"}
3.登录成功,将用户对象保存到Session
4.登录成功,返回Json格式如下:{status:'success',message:"登陆成功!",user:user}
*/
app.post('/post/login', function(req, res) {
res.send('本接口用于提交用户登录信息的!');
});
/*
说明:本接口用于提交用户的编写的博文的。http://localhost:3000/post/post
1.post/:说明是post请求
2.提交未成功,返回Json格式如下:{status:'failed',message:"出错了,原因如下:"+err}
3.提交成功,返回Json格式如下:{status:'successed',message:"保存成功!"}
*/
app.post('/post/post', function(req, res) {
res.send('本接口用于提交用户的编写的博文的!');
});
/*
说明:本接口用于用户注销。http://localhost:3000/get/logout
1.get/:说明是get请求
2.注销用户,即清除服务端的Session
*/
app.get('/get/logout', function(req, res) {
res.send('本接口用于用户注销的!');
});
};
PS: 每个路由前面加上:/get/ 或 /post/ 的目的,主要是为了将来做跨域处理时写路由正则更方便处理,同时也是为了更加高效及安全性上考虑,你也可以不要此前缀,这个不是必须的。
五、 运行测试
第一步:运行Node服务器: > node app
第二步:打开浏览器:http://localhost:3000/get/post
第三步:打开浏览器:http://localhost:3000/get/user
第四步:打开浏览器:http://localhost:3000/get/logout
PS: app.post所对应的接口,不允许直接浏览器方式访问,这里不作测试!
六、其他
1. 删除掉 routes/user.js
2. app.js再作部分优化,主要是删掉了
var index = require('./routes/index');
var users = require('./routes/users');
部分,其他也略调整了下顺序,这里就不再累述,具体见后继提供的代码!
七、总结
代码进行到这里,就先告一段落了。本章的核心代码在于【mongoose的数据库连结及模型创建配置】,还没有完,更加精彩的mongoose操作数据库代码下篇继续。另外需要说明的是,关于mongoose库的用法,我不打算一一对其API作解释,因为网上的文章很多,这里即然是原创,就尽量想写一些网上没有的,故更多的会提供实战操作代码,大家将来可以直接借鉴到你的实际项目中,如想对mongoose库更深入的了解,可以自行百度【mongoose使用详解】,这里就不再累述。
八、后述
前期文章链结见:
实战Angular2/Mongodb/Node博客系统(一)
实战Angular2/Mongodb/Node博客系统(二)
实战Angular2/Mongodb/Node博客系统(三)
实战Angular2/Mongodb/Node博客系统(四)
《基于Angular2+Mongodb+Node技术实现的多用户博客系统》正在连载中,欢迎各位继续关注~
搜索并关注“风舞烟”的简书专栏、头条号、微信公众号、 企鹅媒体平台,你可以定期收到关于简书专栏的最新动态以及IT前沿最新技术的高质量经验文章、视频分享。
谢谢大家的支持,欢迎大家留言交流。