四时宝库

程序员的知识宝库

实例上手mongoose+Node数据库组件开发

一、前言

接下来我将正式讲解《基于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前沿最新技术的高质量经验文章、视频分享。

谢谢大家的支持,欢迎大家留言交流。

发表评论:

控制面板
您好,欢迎到访网站!
  查看权限
网站分类
最新留言
    友情链接