Node.js博客搭建超详细教程

Node.js 博客搭建

一. 学习需求

Node 的安装运行

会安装node,搭建node环境

会运行node。

基础模块的使用

Buffer:二进制数据处理模块

Event:事件模块

fs:文件系统模块

Net:网络模块

Http:http模块

...

NPM(node包管理工具)

第三方node模块(包)的管理工具,可以使用该下载工具安装第三方模块。,当然也可以创建上传自己的模块。

参考

假定已经理解并掌握了入门教程的所有内容。在易出错的地方将进行简要的说明。

其它

这是最不起眼,但也是最必不可少的——你得准备一个博客的静态文件。

博客的后台界面,登录注册界面,文章展示界面,首页等。


二. 项目需求分析

一个博客应当具备哪些功能?

前台展示

  • 点击下一页,可以点击分类导航。
  • 可以点击进入到具体博文页面
  • 下方允许评论。显示发表时间。允许留言分页。
  • 右侧有登录注册界面。

后台管理

  • 管理员账号:登陆后看到页面不一样,有后台页面。
  • 允许添加新的分类。从后台添加新的文章。
  • 编辑允许markdown写法。
  • 评论管理。

三. 项目创建,安装及初始化

技术框架

本项目采用了以下核心技术:

  • Node版本:6.9.1——基础核心的开发语言

(安装后查看版本:cmd窗口:node -v)

(查看方式:cmd窗口:node -v

  • Express

一个简洁灵活的node.js WEB应用框架,提供一系列强大的特性帮助我们创建web应用。

  • Mongodb

用于保存产生的数据

还有一系列第三方模块和中间件:

  • bodyParser,解析post请求数据
  • cookies:读写cookie
  • swig:模板解析引擎
  • mongoose:操作Mongodb数据
  • markdown:语法解析生成模块

...

初始化

在W ebStorm创建一个新的空工程,指定文件夹。

打开左下角的Terminal输入:

npm init

回车。然后让你输入name:(code),输入项目名称,然后后面都可以不填,最后在Is it OK?处写上yes。

完成这一步操作之后,系统就会在当前文件夹创建一个package.json的项目文件。

项目文件下面拥有刚才你所基本的信息。后期需要更改的话可直接在这里修改。

第三方插件的安装

  • 以Express为例

在命令行输入:

npm install --save express

耐心等待一段时间,安装完成后,json文件夹追加了一些新的内容:

json { //之前内容........ "author": "", "license": "ISC", "dependencies": { "express": "^4.14.0" }

表示安装成功。

同理,使用npm install --save xxx的方法安装下载以下模块:

  • body-parser
  • cookies
  • markdown
  • mongoose
  • swig

所以安装完之后的package.json文件是这样的。

{
  "name": "blog",
  "version": "1.0.0",
  "description": "this is my first blog.",
  "main": "index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "author": "",
  "license": "ISC",
  "dependencies": {
    "body-parser": "^1.15.2",
    "cookies": "^0.6.2",
    "express": "^4.14.0",
    "markdown": "^0.5.0",
    "mongoose": "^4.7.5",
    "swig": "^1.4.2"
  }
}

在这个json中,就能通过依赖模块(dependencies)看到各个第三方模块的版本信息

切记:依赖模块安装,要联网!

安装完成之后

第二个文件夹放的是你的第三方模块。

此外还需要别的文件,完整的结构是这样的——

接下来就把缺失的文件目录自己建立起来。

完成着一系列操作之后,就把app.js作为应用程序的启动(入口页面)。

创建应用

以下代码创建应用,监听端口

// 加载express
var express=require('express');
//创建app应用,相当于=>Node.js Http.createServer();
var app=express();
//监听http请求
app.listen(9001);

运行(ctrl+shift+c)之后就可以通过浏览器访问了。

用户访问:

  • 用户通过URL访问web应用,比如http://localhost:9001/

这时候会发现浏览器呈现的内容是这样的。

  • web后端根据用户访问的url处理不同的业务逻辑。

  • 路由绑定——

在Express框架下,可以通过app.get()app.post()等方式,把一个url路径和(1-n)个函数进行绑定。当满足对应的规则时,对应的函数将会被执行,该函数有三个参数——

javascript app.get('/',function(req,res,next){ // do sth. }); // req:request对象,保存客户请求相关的一些数据——http.request // res:response对象,服务端输出对象,停工了一些服务端相关的输出方法——http.response // next:方法,用于执行下一个和路径相匹配的函数(行为)。

  • 内容输出

通过res.send(string)发送内容到客户端。

app.get('/',function(req,res,next){
    res.send('<h1>欢迎光临我的博客!</h1>');
});

运行。这时候网页就打印出了h1标题的内容。

注意,js文件编码如果不为UTF-8,网页文件显示中文会受到影响。


三. 模板引擎的配置和使用

使用模板

现在,我想向后端发送的内容可不是一个h1标题那么简单。还包括整个博客页面的html内容,如果还是用上面的方法,麻���就大了。

怎么办呢?关键步骤在于html和js页面相分离(类似结构和行为层的分离)。

模板的使用在于后端逻辑和前端表现的分离(前后端分离)。

模板配置

基本配置如下

// 定义模板引擎,使用swig.renderFile方法解析后缀为html的文件
var swig=require('swig');
app.engine('html',swig.renderFile);

// 设置模板存放目录
app.set('views','./views');
// 注册模板引擎
app.set('view engine','html');

swig.setDefaults({cache:false});

配置模板的基本流程是:

请求swig模块=>定义模板引擎=>注册模板引擎=>设置调试方法

我们可以使用var swig=require('swig');定义了swig方法。

以下进行逐行解析——

定义模板引擎

app.engine('html',swig.renderFile);

第一个参数:模板引擎的名称,同时也是模板引擎的后缀,你可以定义打开的是任何文件格式,比如json,甚至tdl等。
第二个参数表示用于解析处理模板内容的方法。
第三个参数:使用swig.renderFile方法解析后缀为html的文件。

设置模板目录

现在就用express组件提供的set方法标设置模板目录:

app.set('views','./views');

定义目录时也有两个参数,注意,第一个参数必须views!第二个参数可以是我们所给出的路径。因为之前已经定义了模板文件夹为views。所以,使用对应的路径名为./views

注册模板引擎

app.set('view engine','html');

还是使用express提供了set方法。
第一个参数必须是字符串'view engine'
第二个参数和app.engine方法定义的模板引擎名称(第一个参数)必须是一致的(都是“html”)。

重回app.get

现在我们回到app.get()方法里面,使用res.render()方法重新渲染指定内容

app.get('/',function(req,res,next){

    /*    * 读取指定目录下的指定文件,解析并返回给客户端    * 第一个参数:模板文件,相对于views目录,views/index.html    * */

    res.render('index');
});

这时候,我们定义了返回值渲染index文件,就需要在views文件夹下新创建一个index.html

<!DOCTYPE html>
<html>
<head lang="en">
    <meta charset="UTF-8">
    <title></title>
</head>
<body>
    <h1>欢迎来到我的第一个博客!<h1>
</body>
</html>

render方法还可以接受第二个参数,用于传递模板使用的第二个数据。

好了。这时候再刷新页面,就出现了index的内容。

调试方法

我们在不停止服务器的情况下,重新修改index的文件内容,发现并没有刷新。

什么问题呢?出于性能上考虑,node把第一次读取的index放到了内容中,下次访问时,就是缓存中的内容了,而不是真正的index文件。因此需要重启。

开发过程中,为了减少麻烦,需要取消模板缓存。

swig.setDefaults({cache:false});

当然,当项目上线时,可以把这一段删除掉。


四. 静态文件托管

在写模板文件时,经常引入一些外链的css,js和图片等等。

css怎么引入?

如果我们直接在首页的head区域这么写:

<link rel="stylesheet" type="text/css" href="css.css"/>

再刷新,发现对css.css的引用失败了。

问题不在于css.css是否存在,而在于请求失败。因为外链文件本质也是一个请求,但是在app.js中还没有对应设置。

如果这么写:

app.get('/css.css', function (req,res,next) {
    res.send('body {background: red;}');
});

发现没有效果。

打开http://localhost:9001/css.css发现内容是这样的:

搞笑了。默认发送的是一个html。因此需要设定一个header

app.get('/css.css', function (req,res,next) {
    res.setHeader('content-type','text/css');
    res.send('body {background: red;}');
});

ctrl+F5,就解析了红色背景了。

同样的,静态文件需要完全分离,因此这种方法也是不行的。

静态文件托管目录

最好的方法是,把所有的静态文件都放在一个public的目录下,划分并存放好。

然后在开头就通过以下方法,把public目录下的所有静态文件都渲染了:

app.use('/public',express.static(__dirname+'/public'));

以上方法表示:当遇到public文件下的文件,都调用第二个参数里的方法(注意是两个下划线)。

当用户访问的url以public开始,那么直接返回对应__dirname+'public'下的文件。因此我们的css应该放到public下。

引用方式为:

<link rel="stylesheet" type="text/css" href="../public/css.css"/>

然后到public文件下创建一个css.css,设置body背景为红色。原来的app.get方法就不要了。

至此,静态文件什么的都可以用到了

小结

在以上的内容中,我们实现了初始化项目,可以调用html和css文件。基本过程逻辑是:

用户发送http请求(url)=>解析路由=>找到匹配的规则=>指定绑定函数,返回对应内容到用户。

访问的是public:静态——直接读取指定目录下的文件,返回给用户。

=>动态=>处理业务逻辑

那么整个基本雏形就搭建起来了。


五. 分模块开发与实现

把整个网站放到一个app.js中,是不利于管理和维护的。实际开发中,是按照不同的功能,管理代码。

根据功能划分路由(routers)

根据本项目的业务逻辑,分为三个模块就够了。

  • 前台模块
  • 后台管理模块
  • API模块:通过ajax调用的接口。

或者,使用app.use(路由设置)划分:

  • app.use('/admin',require('./routers/admin'));

解释:当用户访问的是admin文件下的内容,这调用router文件夹下admin.js文件。下同。

  • app.use('/api',require('./routers/api'));后台

  • app.use('/',require('./routers/main'));前台

好了。重写下以前的代码,去掉多余的部分。

// 加载express
var express=require('express');
//创建app应用,相当于=>Node.js Http.createServer();
var app=express();

// 设置静态文件托管
app.use('/public',express.static(__dirname+'/public'))

// 定义模板引擎,使用swig.renderFile方法解析后缀为html的文件
var swig=require('swig');
app.engine('html',swig.renderFile);

// 设置模板存放目录
app.set('views','./views');
// 注册模板引擎
app.set('view engine','html');
// 调试优化
swig.setDefaults({cache:false});

//app.use('/admin',require('./routers/admin'));
//app.use('/api',require('./routers/api'));
//app.use('/',require('./routers/main'));


//监听http请求
app.listen(9001);

routers创建一个admin.js,同理再创建一个api.js,一个main.js

怎么访问不同文件夹下的文件?

比如,我想访问一个如http://localhost:9001/admin/user这样的地址,这样按理来说就应该调用admin.js(分路由)。

所以编辑admin.js

var express=require('express');

// 创建一个路由对象,此对象将会监听admin文件下的url
var router=express.Router();

router.get('/user',function(req,res,next){
    res.send('user');
});

module.exports=router;//把router的结果作为模块的输出返回出去!

注意,在分路由中,不需要写明路径,就当它是在admin文件下的相对路径就可以了。

储存,然后回到app.js,应用app.use('/admin',require('./routers/admin'));

再打开页面,就看到结果了。

同理,api.js也如法炮制。

var express=require('express');

// 创建一个路由对象,此对象将会监听api文件夹下的url
var router=express.Router();

router.get('/user',function(req,res,next){
    res.send('api-user');
});

module.exports=router;//把router的结果作为模块的输出返回出去!

再应用app.use('api/',require('./routers/api'))。重启服务器,结果如下

首页也如法炮制

路由的细分

前台路由涉及了相当多的内容,因此再细化分多若干个路由也是不错的选择。

每个内容包括基本的分类和增删改

  • main模块

/——首页

/view——内容页

  • api模块

/——首页

/login——用户登陆

/register——用户注册

/comment——评论获取

/comment/post——评论提交

  • admin模块

/——首页

  • 用户管理

    /user——用户列表

  • 分类管理

    /category——分类目录

    /category/add——分类添加

    /category/edit——分类编辑

    /category/delete——分类删除

  • 文章管理

    /article——内容列表

    /article/add——添加文章

    /article/edit——文章修改

    /article/delete——文章删除

  • 评论管理

    /comment——评论列表

    /comment/delete——评论删除

开发流程

功能开发顺序

用户——栏目——内容——评论

一切操作依赖于用户,所以先需要用户。

栏目也分为前后台,优先做后台。

内容和评论相互关联。

编码顺序

  • 通过Schema定义设计数据储存结构
  • 功能逻辑
  • 页面展示

六. 数据库连接,表结构

比如用户,在SCHEMA文件夹下新建一个users.js

如何定义一个模块呢?这里用到mongoose模块

var mongoose=require('mongoose');//引入模块

除了在users.js请求mongoose模块以外,在app.js也需要引入mongoose。

// 加载express
var express=require('express')

//创建app应用,相当于=>Node.js Http.createServer();
var app=express();

// 加载数据库模块
var mongoose=require('mongoose');

// 设置静态文件托管
app.use('/public',express.static(__dirname+'/public'))

// 定义模板引擎,使用swig.renderFile方法解析后缀为html的文件
var swig=require('swig');
app.engine('html',swig.renderFile);

// 设置模板存放目录
app.set('views','./views');
// 注册模板引擎
app.set('view engine','html');
// 调试优化
swig.setDefaults({cache:false});

/** 根据不同的内容划分路由器* */
app.use('/admin',require('./routers/admin'));
app.use('/api',require('./routers/api'));
app.use('/',require('./routers/main'));



//监听http请求
mongoose.connect();
app.listen(9001);

建立连接数据库(每次运行都需要这样)

mongoose使用需要安装mongodb数据库。

mongodb安装比较简单,在官网上下载了,制定好路径就可以了。

找到mongodb的bin文件夹。启动mongod.exe——通过命令行

命令行依次输入:

f:
cd Program Files\MongoDB\Server\3.2\bin

总之就是根据自己安装的的路径名来找到mongod.exe就行了。

开启数据库前需要指定参数,比如数据库的路径。我之前已经在项目文件夹下创建一个db文件夹,然后作为数据库的路径就可以了。

除此之外还得指定一个端口。比如27018

mongod --dbpath=G:\node\db --port=27018

然后回车

信息显示:等待链接27018,证明开启成功

下次每次关机后开启服务器,都需要做如上操作。

接下来要开启mongo.exe。

命令行比较原始,还是可以使用一些可视化的工具进行连接。在这里我用的是robomongo。

直接在国外网站上下载即可,下载不通可能需要科学上下网。

名字随便写就行了,端口写27018

点击链接。

回到命令行。发现新出现以下信息:

表示正式建立连接。

数据保存

链接已经建立起来。但里面空空如也。

接下来使用mongoose操作数据库。

可以上这里去看看文档。文档上首页就给出了mongoose.connect()方法。

var mongoose = require('mongoose');
mongoose.connect('mongodb://localhost/test');

var Cat = mongoose.model('Cat', { name: String });

var kitty = new Cat({ name: 'Zildjian' });
kitty.save(function (err) {
  if (err) {
    console.log(err);
  } else {
    console.log('meow');
  }
});

connect方法接收的第一个参数,就是这个'mongodb://localhost:27018'。第二个参数是回调函数。

数据库链接失败的话,是不应该开启监听的,所以要把listen放到connect方法里面。

mongoose.connect('mongodb://localhost:27018/blog',function(err){
    if(err){
        console.log('数据库连接错误!');
    }else{
        console.log('数据库连接成功!');
        app.listen(9001);
    }
});

运行,console显示,数据库链接成功。

注意,如果出现错误,还是得看看编码格式,必须为UTF-8。

回到users.js的编辑上来,继续看mongoose文档。

var mongoose = require('mongoose');
var Schema = mongoose.Schema;

var blogSchema = new Schema({
  title:  String,
  author: String,
  body:   String,
  comments: [{ body: String, date: Date }],
  date: { type: Date, default: Date.now },
  hidden: Boolean,
  meta: {
    votes: Number,
    favs:  Number
  }
});

通过mongoose.Schema构造函数,生成一个Schema对象。

new出的Schema对象包含很多内容,传入的对象代表数据库中的一个表。每个属性代表表中的每一个字段,每个值代表该字段存储的数据类型。

在这里,users.js需要暴露的内容就是用户名和密码。

// 加载数据库模块
var mongoose=require('mongoose');

// 返回用户的表结构
module.exports= new mongoose.Schema({

    // 用户名
    username: String,
    // 密码
    password: String

});

然后在通过模型类来操作表结构。在项目的models文件夹下创建一个User.js

var mongoose=require('mongoose');

var usersSchema=require('../schemas/users');

module.exports=mongoose.model('User',usersSchema);

这样就完成了一个模型类的创建。

模型怎么用?还是看看文档给出的使用方法。

// 创建一个表结构对象
var schema = new mongoose.Schema({ name: 'string', size: 'string' });
// 根据表结构对象创建一个模型类
var Tank = mongoose.model('Tank', schema);

构造函数如何使用:

var Tank = mongoose.model('Tank', yourSchema);

var small = new Tank({ size: 'small' });
small.save(function (err) {
  if (err) return handleError(err);
  // saved!
})

// or

Tank.create({ size: 'small' }, function (err, small) {
  if (err) return handleError(err);
  // saved!
})

七. 用户注册的前端逻辑

引入首页

用户注册首先得加载一个首页。

在views下面新建一个main文件夹,然后把你之前写好的index.html放进去。

所以回到main.js中。渲染你已经写好的博客首页。

var express=require('express');

// 创建一个路由对象,此对象将会监听前台文件夹下的url
var router=express.Router();

router.get('/',function(req,res,next){
    res.render('main/index');
});

module.exports=router;//把router的结果作为模块的输出返回出去!

保存,然后重启app.js,就能在localhost:9001看到首页了。

当然这个首页很丑,你可以自己写一个。

原来的路径全部按照项目文件夹的结构进行修改。

逻辑

注册登录一共有三个状态。

一开始就是注册,如果已有账号就点击登录,出现登录弹窗。

如果已经登录,则显示已经登录状态。并有注销按钮。

            <div class="banner-wrap">
                <div class="login" id="register">
                <h3>注册</h3>
                <span>用户:<input name="username" type="text"/></span><br/>
                <span>密码:<input name="password" type="text"/></span><br/>
                <span>确认:<input name="repassword" type="text"/></span><br/>
                <span><input class="submit" type="button" value="提交"/></span>
                <span>已有账号?马上<a href="javascript:;">登录</a></span>
            </div>

            <div class="login" id="login" style="display:none;">
                <h3>登录</h3>
                <span>用户:<input type="text"/></span><br/>
                <span>密码:<input type="text"/></span><br/>
                <span><input type="button" value="提交"/></span>
                <span>没有账号?马上<a href="javascript:;">注册</a></span>
            </div>

jquery可以这么写:

$(function(){
    // 登录注册的切换
    $('#register a').click(function(){
        $('#login').show();
        $('#register').hide();
    });

    $('#login a').click(function(){
        $('#login').hide();
        $('#register').show();
    });
});

当点击注册按钮,应该允许ajax提交数据。地址应该是api下的user文件夹的register,该register文件暂时没有创建,所以不理他照写即可。

// 点击注册按钮,通过ajax提交数据
    $('#register .submit').click(function(){
        // 通过ajax提交交
        $.ajax({
            type:'post',
            url:'/api/user/register',
            data:{
                username:$('#register').find('[name="username"]').val(),
                password:$('#register').find('[name="password"]').val(),
                repassword:$('#register').find('[name="repassword"]').val()
            },
            dataType:'json',
            success:function(data){
                console.log(data);
            }
        });
    });

允许网站,输入用户名密码点击注册。

虽然报错,但是在chrome的network下的header可以看到之前提交的信息。

挺好,挺好。


八. body-paser的使用:后端的基本验证

后端怎么响应前台的ajax请求?

首先,找到API的模块,增加一个路由,回到api.js——当收到前端ajax的post请求时,路由打印出一个register字符串。

var express=require('express');

// 创建一个路由对象,此对象将会监听api文件夹下的url
var router=express.Router();

router.post('/user/register',function(req,res,next){
    console.log('register');
});

module.exports=router;//把router的结果作为模块的输出返回出去!

这时候,就不会显示404了。说明路由处理成功。

如何获取前端post的数据?

这就需要用到新的第三方模块——body-parser

相关文档地址:https://github.com/expressjs/body-parser

bodyParser.urlencoded(options)

Returns middleware that only parses urlencoded bodies. This parser accepts only UTF-8 encoding of the body and supports automatic inflation of gzip and deflate encodings.

A new body object containing the parsed data is populated on the request object after the middleware (i.e. req.body). This object will contain key-value pairs, where the value can be a string or array (when extended is false), or any type (when extended is true).

var bodyParser=require('body-parser');

app.use(bodyParser.urlencoded(extended:true));

在app.js中,加入body-parser。然后通过app.use()方法调用。此时的app.js是这样的:

// 加载express
var express=require('express');

//创建app应用,相当于=>Node.js Http.createServer();
var app=express();

// 加载数据库模块
var mongoose=require('mongoose');

// 加载body-parser,用以处理post提交过来的数据
var bodyParser=require('body-parser');

// 设置静态文件托管
app.use('/public',express.static(__dirname+'/public'))

// 定义模板引擎,使用swig.renderFile方法解析后缀为html的文件
var swig=require('swig');


app.engine('html',swig.renderFile);

// 设置模板存放目录
app.set('views','./views');
// 注册模板引擎
app.set('view engine','html');
// 调试优化
swig.setDefaults({cache:false});

// bodyParser设置
app.use(bodyParser.urlencoded({extended:true}));


/* * 根据不同的内容划分路由器 * */
app.use('/admin',require('./routers/admin'));
app.use('/api',require('./routers/api'));
app.use('/',require('./routers/main'));



//监听http请求
mongoose.connect('mongodb://localhost:27018/blog',function(err){
    if(err){
        console.log('数据库连接错误!');
    }else{
        console.log('数据库连接成功!');
        app.listen(9001);
    }
});

配置好之后,回到api.js,就能在router.post方法中,通过req.body得到提交过来的数据。

router.post('/user/register',function(req,res,next){
    console.log(req.body);
});

重启app.js,然后网页再次提交数据。

出现console信息:

后端的表单验证

拿到数据之后,就是进行基本的表单验证。比如

  • 用户名是否符合规范(空?)
  • 是否被注册
  • 密码是否符合规范
  • 重复密码是否一致

其中,检测用户名是否被注册需要用到数据库查询。

所以按照这个逻辑,重新归下类:

// 基本验证=>用户不得为空(错误代码1),密码不得为空(错误代码2),两次输入必须一致(错误代码3)
// 数据库查询=>用户是否被注册。

返回格式的初始化

我们要对用户的请求进行响应。对于返回的内容,应该做一个初始化,指定返回信息和错误代码

// 统一返回格式
var responseData=null;

router.use(function(req,res,next){
    responseData={
        code:0,
        message:''
    }
    
    next();
});

写出判断逻辑,通过res.json返回给前端

res.json方法就是把响应的数据转化为一个json字符串。再直接return出去。后面代码不再执行。

router.post('/user/register',function(req,res,next){
    var username=req.body.username;
    var password=req.body.password;
    var repassword=req.body.repassword;

    //用户名是否为空
    if(username==''){
        responseData.code=1;
        responseData.message='用户名不得为空!';
        res.json(responseData);
        return;
    }

    if(password==''){
        responseData.code=2;
        responseData.message='密码不得为空!';
        res.json(responseData);
        return;
    }

    if(repassword!==password){
        responseData.code=3;
        responseData.message='两次密码不一致!';
        res.json(responseData);
        return;
    }
    
    responseData.message='注册成功!';
    res.json(responseData);
});

基本运行就成功了。

基于数据库的查重验证

之前已经完成了简单的验证,基于数据库怎么验证呢?

首先得请求模型中的user.js。

var User=require('../model/User');

这个对象有非常多的方法,再看看mongoose文档:http://mongoosejs.com/docs/api.html#model-js

其中

// #方法表示必须new出一个具体对象才能使用
Model#save([options], [options.safe], [options.validateBeforeSave], [fn])

在这里,我们实际上就使用这个方法就够了。

Model.findOne([conditions], [projection], [options], [callback])

在router.post方法内追加:

// 用户名是否被注册?
    User.findOne({
        username:username
    }).then(function(userInfo){
        console.log(userInfo);
    });

重启运行发现返回的是一个null——如果存在,表示数据库有该记录。如果为null,则保存到数据库中。

所以完整的验证方法是:

router.post('/user/register',function(req,res,next){
    var username=req.body.username;
    var password=req.body.password;
    var repassword=req.body.repassword;

    //基本验证
    if(username==''){
        responseData.code=1;
        responseData.message='用户名不得为空!';
        res.json(responseData);
        return;
    }

    if(password==''){
        responseData.code=2;
        responseData.message='密码不得为空!';
        res.json(responseData);
        return;
    }

    if(repassword!==password){
        responseData.code=3;
        responseData.message='两次密码不一致!';
        res.json(responseData);
        return;
    }

    // 用户名是否被注册?
    User.findOne({
        username:username
    }).then(function(userInfo){
        if(userInfo){
            responseData.code=4;
            responseData.message='该用户名已被注册!';
            res.json(responseData);
            return;
        }else{//保存用户名信息到数据库中
            var user=new User({
                username:username,
                password:password,
            });
            return user.save();
        }
    }).then(function(newUserInfo){
        console.log(newUserInfo);
        responseData.message='注册成功!';
        res.json(responseData);
    });

});

再查看console内容

如果你再次输入该用户名。会发现后台console信息为undefined,网页控制台显示该用户名已被注册。

回到久违的Robomongo,可以看到数据库中多了一条注册用户的内容。

里面确确实实存在了一条记录。

在实际工作中,应该以加密的形式存储内容。在这里就不加密了。

前端对后台返回数据的处理

现在后端的基本验证就结束了。前端收到数据后应当如何使用?

回到index.js

我要做两件事:

  • 把信息通过alert的形式展现出来。
  • 如果注册成功,在用户名处(#loginInfo)展现用户名信息。这里我把它加到导航栏最右边。

暂时就这样写吧:

$(function(){
    // 登录注册的切换
    $('#register a').click(function(){
        $('#login').show();
        $('#register').hide();
    });

    $('#login a').click(function(){
        $('#login').hide();
        $('#register').show();
    });

    // 点击注册按钮,通过ajax提交数据
    $('#register .submit').click(function(){
        // 通过ajax移交
        $.ajax({
            type:'post',
            url:'/api/user/register',
            data:{
                username:$('#register').find('[name="username"]').val(),
                password:$('#register').find('[name="password"]').val(),
                repassword:$('#register').find('[name="repassword"]').val()
            },
            dataType:'json',
            success:function(data){
                alert(data.message);
                if(!data.code){
                    // 注册成功
                    $('#register').hide();
                    $('#login').show();
                }
            }
        });
    });
});

九. 用户登录逻辑

用户登录的逻辑类似,当用户点击登录按钮,同样发送ajax请求到后端。后端再进行验证。

基本设置

所以在index.js中,ajax方法也如法炮制:

// 点击登录按钮,通过ajax提交数据
    $('#login .submit').click(function(){
        // 通过ajax提交
        $.ajax({
            type:'post',
            url:'/api/user/login',
            data:{
                username:$('#login').find('[name="username"]').val(),
                password:$('#login').find('[name="password"]').val(),
            },
            dataType:'json',
            success:function(data){
                console.log(data);
            }
        });
    });

回到后端api.js,新增一个路由:

// 登录验证
router.post('/user/login',function(res,req,next){
    var username=req.body.username;
    var password=req.body.password;

    if(username==''||password==''){
        responseData.code=1;
        responseData.message='用户名和密码不得为空!';
        res.json(responseData);
        return;
    }


});

数据库查询:用户名是否存在

同样也是用到findOne方法。

router.post('/user/login',function(req,res,next){
    //console.log(req.body);
    var username=req.body.username;
    var password=req.body.password;
    
    if(username==''||password==''){
        responseData.code=1;
        responseData.message='用户名和密码不得为空!';
        res.json(responseData);
        return;
    }

    // 查询用户名和对应密码是否存在,如果存在则登录成功
    User.findOne({
        username:username,
        password:password
    }).then(function(userInfo){
        if(!userInfo){
            responseData.code=2;
            responseData.message='用户名或密码错误!';
            res.json(responseData);
            return;
        }else{
            responseData.message='登录成功!';
            res.json(responseData);
            return;
        }
    });

});

获取登录信息

之前登陆以后在#userInfo里面显示内容。

现在我们来重新设置以下前端应该提示的东西:

  • 提示用户名,如果是admin,则提示管理员,并增加管理按钮
  • 注销按钮

这一切都是在导航栏面板上完成。

后端需要把用户名返回出来。在后端的userInfo参数里,已经包含了username的信息。所以把它也加到responseData中去。

<nav class="navbar">
                <ul>
                    <li><a href="index.html">首页</a></li>
                    <li><a href="article.html">文章</a></li>
                    <li><a href="portfolio.html">作品</a></li>
                    <li><a href="about.html">关于</a></li>
                    <li>
                        <a id="loginInfo">
                            <span>未登录</span>
                        </a>
                    </li>
                    <li><a  id="logout" href="javascript:;">
                        注销
                    </a></li>
                </ul>
            </nav>

导航的结构大致如是,然后有一个注销按钮,display为none。

于是index.js可以这么写:

// 点击登录按钮,通过ajax提交数据
    $('#login .submit').click(function(){
        // 通过ajax提交
        $.ajax({
            type:'post',
            url:'/api/user/login',
            data:{
                username:$('#login').find('[name="username"]').val(),
                password:$('#login').find('[name="password"]').val(),
            },
            dataType:'json',
            success:function(data){
                alert(data.message);
                if(!data.code){
                    $('#login').slideUp(1000,function(){
                        $('#loginInfo span').text('你好,'+data.userInfo)
                        $('#logout').show();
                    });
                }
            }
        });
    });

这一套简单的逻辑也完成了。


十. cookie设置

当你登陆成功之后再刷新页面,发现并不是登录状态。这很蛋疼。

记录登录状态应该反馈给浏览器。

cookie模块的调用

在app.js中引入cookie模块——

var Cookies=require('cookies');

app.use(function(req,res){
  req.cookies=new Cookies(req,res);
  next();
});

回到api.js,在登陆成功之后,还得做一件事情,就是把cookies发送给前端。

        }else{
            responseData.message='登录成功!';
            responseData.userInfo=userInfo.username;
          
            //每当用户访问站点,将保存用户信息。
            req.cookies.set('userInfo',JSON.stringify({
                    _id:userInfo._id,
                    username:userInfo.username
                });
            );//把id和用户名作为一个对象存到一个名字为“userInfo”的对象里面。
          
            res.json(responseData);
            return;
        }

重启服务器,登录。在network上看cookie信息

再刷新浏览器,查看headers

也多了一个userInfo,证明可用。

处理cookies信息

 //设置cookie
app.use(function(req,res,next){
    req.cookies=new Cookies(req,res);

    // 解析cookie信息把它由字符串转化为对象
    if(req.cookies.get('userInfo')){
        try {
            req.userInfo=JSON.parse(req.cookies.get('userInfo'));;
        }catch(e){}
    }
    next();
});

调用模板去使用这些数据。

回到main.js

var express=require('express');

var router=express.Router();

router.get('/',function(req,res,next){
    res.render('main/index',{
        userInfo:req.userInfo
    });
});

module.exports=router;

然后就在index.html中写模板。

模板语法

模板语法是根据从后端返回的信息在html里写逻辑的方法。

所有逻辑内容都在{%%}里面

简单的应用就是if else

{% if userInfo._id %}
<div id="div1"></div>
{% else %}
<div id="div2"></div>
{% endif %}

如果后端返回的内容存在,则渲染div1,否则渲染div2,这个语句到div2就结束。

所以,现在我们的渲染逻辑是:

  • 如userInfo._id存在,则直接渲染导航栏里的个人信息
  • 否则,渲染登录注册页面。
  • 博客下面的内容也是如此。最好让登录的人才看得见。

如果我需要显示userInfo里的username,需要双大括号{{userInfo.username}}

登录后的逻辑

这样一来,登陆后的效果就没必要了。直接重载页面。

if(!data.code){
   window.location.reload();
}

然后顺便把注销按钮也做了。

注销无非是把cookie设置为空,然后前端所做的事情就是一个一个ajax请求,一个跳转。

index.js

// 注销模块
    $('#logout').click(function(){
        $.ajax({
            type:'get',
            url:'/api/user/logout',
            success:function(data){
                if(!data.code){
                    window.location.reload();
                }
            }
        });
    });

在api.js写一个退出的方法

// 退出方法
router.get('/user/logout',function(req,res){
    req.cookies.set('userInfo',JSON.stringify({
        _id:null,
        username:null
    }));
    res.json(responseData);
    return;
});

十一. 区分管理员和普通用户

创建管理员

管理员用户表面上看起来也是用户,但是在数据库结构是独立的一个字段,

打开users.js,新增一个字段

var mongoose=require('mongoose');

// 用户的表结构
module.exports= new mongoose.Schema({

    username: String,
    password: String,

    // 是否管理员
    isAdmin:{
        type:Boolean,
        default:false
    }

});

为了记录方便,我直接在RoboMongo中设置。

添加的账号这么写:

保存。

那么这个管理员权限的账户就创建成功了。

cookie设置

注意,管理员的账户最好不要记录在cookie中。

回到app.js,重写cookie代码

//请求User模型
var User=require('./models/User');

 //设置cookie
app.use(function(req,res,next){
    req.cookies=new Cookies(req,res);

    // 解析cookie信息
    if(req.cookies.get('userInfo')){
        try {
            req.userInfo=JSON.parse(req.cookies.get('userInfo'));

            // 获取当前用户登录的类型,是否管理员
            User.findById(req.userInfo._id).then(function(userInfo){
                req.userInfo.isAdmin=Boolean(userInfo.isAdmin);

                next();
            });
        }catch(e){
            next();
        }
    }else{
        next();
    }

});

总体思路是,根据isAdmin判断是否为真,

管理员显示判断

之前html显示的的判断是:{{userInfo.username}}

现在把欢迎信息改写成“管理员”,并提示“进入后台按钮”

<li>
    <a  id="loginInfo">
    {% if userInfo.isAdmin %}
    <span id="admin" style="cursor:pointer;">管理员你好,进入管理</span>
    {% else %}
    <span>{{userInfo.username}}</span>
    {% endif %}
     </a>
</li>

很棒吧!


十二. 后台管理功能及界面

打开网站,登录管理员用户,之前已经做出了进入管理链接。

基本逻辑

我们要求打开的网址是:http://localhost:9001/admin。后台管理是基于admin.js上进行的。

先对admin.js做如下测试:

var express=require('express');


var router=express.Router();

router.use(function(req,res,next){
    if(!req.userInfo.isAdmin){
        // 如果当前用户不是管理员
        res.send('不是管理员!');
        return;
    }else{
        next();
    }
});

router.get('/',function(res,req,next){
   res.send('管理首页');
});

module.exports=router;

当登录用户不是管理员。直接显示“不是管理员”

后台界面的前端实现

后台意味着你要写一个后台界面。这个index页面放在view>admin文件夹下。所以router应该是:

router.get('/',function(req,res,next){
   res.render('admin/index');
});

所以你还得在admin文件夹写一个index.html

后台管理基于以下结构:

  • 首页
  • 设置
  • 分类管理
  • 文章管理
  • 评论管理

因为是临时写的,凑合着看大概是这样。

<header>
    <h1>后台管理系统</h1>

</header>
<span class="userInfo">你好,{{userInfo.username}}! <a href="javascript:;">退出</a></span>
<aside>
    <ul>
        <li><a href="javascript:;">首页</a></li>
        <li><a href="javascript:;">设置</a></li>
        <li><a href="/admin/user">用户管理</a></li>
        <li><a href="javascript:;">分类管理</a></li>
        <li><a href="javascript:;">文章管理</a></li>
        <li><a href="javascript:;">评论管理</a></li>
    </ul>
</aside>
<section>
    {% block main %}{% endblock %}
</section>
<footer></footer>

父类模板

这个代码应该是可复用的。因此可以使用父类模板的功能。

继承

在同文件夹下新建一个layout.html。把前端代码全部剪切进去。这时候admin/index.html一个字符也不剩了。

怎么访问呢?

在index下面,输入:

{% extends 'layout.html' %}

再刷新localhost:9001/admin,发现页面又回来了。

有了父类模板的功能,我们可以做很多事情了。

非公用的模板元素

类似面向对象的继承,右下方区域是不同的内容,不应该写进layout中,因此可以写为

<section>
{% block 占位区块名称 %}{% endblock %}
</section>

然后回到index.html,定义这个区块的内容

{% block main %}
<!-- 你的html内容 -->
{% endblock %}

十三. 用户管理

需求:点击“用户管理”,右下方的主体页面显示博客的注册用户数量。

所以链接应该是:

<li><a href="/admin/user">用户管理</a></li>

其实做到这块,应该都熟悉流程了。每增加一个新的页面,意味着写一个新的路由。在路由里渲染一个新的模板。在渲染的第二个参数里,以对象的方式写好你准备用于渲染的信息。

回到admin.js

router.get('/user/',function(req,res,next){
    res.render('admin/user_index',{
        userInfo:req.userInfo
    })
});

为了和index区分,新的页面定义为user_index。因此在view/admin文件夹下创建一个user_index.html

先做个简单的测试吧

{% extends 'layout.html' %}

{% block main %}
用户列表
{% endblock %}

点击就出现了列表。

接下来就是要从数据库中读取所有的用户数据。然后传进模板中。

读取用户数据

model下的User.js输出的对象含有我们需要的方法。

我们的User.js是这样的

var mongoose=require('mongoose');

// 用户的表结构
var usersSchema=require('../schemas/users');

module.exports=mongoose.model('User',usersSchema);

回到admin.js

var User=reuire('/model/User.js');

User有一个方法是find方法,返回的是一个promise对象

试着打印出来:

User.find().then(function(user){
        console.log(user);
    });

结果一看,厉害了:

当前博客的两个用户都打印出来了。

接下来就是把这个对象传进去了,就跟传ajax一样:

var User=require('../models/User');
//用户管理

User.find().then(function(user){
    router.get('/user/', function (req,res,next) {
        res.render('admin/user_index',{
            userInfo:req.userInfo,
            users:user
        })
    })
});

模板就能使用用户数据了。

模板如何使用后台传进来的用户对象数据

main的展示区中,应该是一个标题。下面是一串表格数据。

大致效果如图

这需要模板中的循环语法

{% extends 'layout.html' %}

{% block main %}
<h3>用户列表</h3>

<table class="users-list">
    <thead>
        <tr>
            <th>id</th>
            <th>用户名</th>
            <th>密码</th>
            <th>是否管理员</th>
        </tr>
    </thead>
    <tbody>
        {% for user in users %}
        <tr>
            <td>{{user._id.toString()}}</td>
            <td>{{user.username}}</td>
            <td>{{user.password}}</td>
            <td>
                {% if user.isAdmin %}
                是
                {% else %}
                不是
                {% endif %}
            </td>
        </tr>
        {% endfor %}
    </tbody>
</table>
{% endblock %}

显示结果如图

分页显示(limit方法)

实际上用户多了,就需要分页

假设我们分页只需要对User对象执行一个limit方法。比如我想每页只展示1条用户数据:

router.get('/user/', function (req,res,next) {
    User.find().limit(1).then(function(user){
        res.render('admin/user_index',{
            userInfo:req.userInfo,
            users:user
        });
    });
});

分页展示设置(skip)

User的skip方法用于设置截取位置。比如skip(2),表示从第3条开始取。

比如我想每页设置两条数据:

  • 第一页:1=> skip(0)
  • 第二页:2=>skip(1)
  • 因此,当我要在第page页展示limit条数据时,skip方法里的数字参数为:(page-1)*limit

比如我要展示第二页数据:

router.get('/user/', function (req,res,next) {
    var page=2;
    var limit=1;
    var skip=(page-1)*limit;

    User.find().limit(limit).skip(skip).then(function(user){
        res.render('admin/user_index',{
            userInfo:req.userInfo,
            users:user
        });
    });
});

但是究竟有多少页不是我们所能决定的。

有多少页?(req.query.page)

首先要解决怎么用户怎么访问下一页的问题,一般来说,在网页中输入http://localhost:9001/admin/user?pages=数字

就可以通过页面访问到。

既然page不能定死,那就把page写活。

var page=req.query.page||1;

这样就解决了

分页按钮

又回到了前端。

分页按钮是直接做在表格的后面。

到目前为止,写一个“上一页”和“下一页”的逻辑就好了——当在第一页时,上一页不显示,当在第最后一页时,下一页不显示

首先,把page传到前端去:

router.get('/user/', function (req,res,next) {
    var page=req.query.page||1;
    var limit=1;
    var skip=(page-1)*limit;

    User.find().limit(limit).skip(skip).then(function(user){
        res.render('admin/user_index',{
            userInfo:req.userInfo,
            users:user,
            page:page
        });
    });
});

注意,传到前端的page是个字符串形式的数字,所以使用时必须转化为数字。

查询总页数(User.count)

user.count是一个promise对象,

User.count().then(function(count){
  console.log(count);
})

这个count就是总记录条数。把这个count获取到之后,计算出需要多少页(向上取整),传进渲染的对象中。注意,这些操作都是异步的。所以不能用变量储存count。而应该把之前的渲染代码写到then的函数中

还有一个问题是页面取值。不应当出现page=200这样不合理的数字。所以用min方法取值。

router.get('/user/', function (req,res,next) {
    var page=req.query.page||1;
    var limit=1;
    var count=0;

    User.count().then(function(_count){
        count=_count;
        var pages=Math.ceil(count/limit);
        console.log(count);

        page=Math.min(page,pages);
        page=Math.max(page,1);

        var skip=(page-1)*limit;

        User.find().limit(limit).skip(skip).then(function(user){
            res.render('admin/user_index',{
                userInfo:req.userInfo,
                users:user,
                page:page,
                pages:pages
            });
        });
    });//获取总页数
});

添加表格信息

需要在表头做一个简单的统计,包括如下信息

  • 一共有多少条用户记录
  • 每页显示:多少条
  • 共多少页
  • 当前是第多少页

因此应该这么写:

router.get('/user/', function (req,res,next) {
    var page=req.query.page||1;
    var limit=1;
    var count=0;

    User.count().then(function(_count){
        count=_count;
        var pages=Math.ceil(count/limit);


        page=Math.min(page,pages);
        page=Math.max(page,1);

        var skip=(page-1)*limit;

        User.find().limit(limit).skip(skip).then(function(user){
            res.render('admin/user_index',{
                userInfo:req.userInfo,
                users:user,
                page:page,
                pages:pages,
                limit:limit,
                count:count
            });
        });
    });//获取总页数
});

前端模板可以这样写:

{% extends 'layout.html' %}

{% block main %}
<h3>用户列表    <small>(第{{page}}页)</small></h3>

<table class="users-list">
    <thead>
        <tr>
            <th>id</th>
            <th>用户名</th>
            <th>密码</th>
            <th>是否管理员</th>
        </tr>
    </thead>
    <tbody>
        {% for user in users %}
        <tr>
            <td>{{user._id.toString()}}</td>
            <td>{{user.username}}</td>
            <td>{{user.password}}</td>
            <td>
                {% if user.isAdmin %}
                是
                {% else %}
                不是
                {% endif %}
            </td>
        </tr>
        {% endfor %}
    </tbody>
</table>
<p class="table-info">一共有{{count}}个用户,每页显示{{limit}}个。</p>

<ul class="page-btn">
    {% if Number(page)-1!==0 %}
    <li><a href="/admin/user?page={{Number(page)-1}}">上一页</a></li>
    {% else %}
    <li>再往前..没有了</li>
    {% endif %}
    {% if Number(page)+1<=pages %}
    <li><a href="/admin/user?page={{Number(page)+1}}">下一页</a></li>
    {% else %}
    <li>已是最后一页</li>
    {% endif %}
</ul>

{% endblock %}

效果如图

封装

分页是一个极其常用的形式,可以考虑把它封装一下。

同目录下新建一个page.html

把按钮组件放进去。

{%include 'page.html'%}

结果有个问题,里面有一条写死的url(admin/xxx),为了解决,可以设置为...admin/{{type}}?page=yyy,然后把回到admin.js,把type作为一个属性传进去。

那么用户管理部分就到此结束了。


十四. 博客分类管理

前面已经实现了那么多页面,现在尝试实现博客内容的分类管理。

基本设置

首先把分类管理的链接修改为/category/,在admin.js中增加一个对应的路由。渲染的模板为admin/category_inndex.html

路由器基本写法:

router.get('/category/',function(req,res,next){

    res.render('admin/category_index',{
        userInfo:req.userInfo
    });
});

模板基本结构:

{% extends 'layout.html' %}

{% block main %}

{% endblock %}

点击“分类管理”,请求的页面就出来了。当然还是一个空模板。

分类管理的特殊之处在于,它下面有两个子菜单(分类首页,管理分类)。对此我们可以用jQuery实现基本动效。

html结构

<li id="category">
            <a href="/admin/category">分类管理</a>
            <ul class="dropdown">
                <li><a href="javascript:;">管理首页</a></li>
                <li><a href="/admin/category/add">添加分类</a></li>
            </ul>
        </li>

jq

$('#category').hover(function(){
        $(this).find('.dropdown').stop().slideDown(400);
    },function(){
        $(this).find('.dropdown').stop().slideUp(400);
    });

还是得布局。

布局的基本设置还是遵循用户的列表——一个大标题,一个表格。

添加分类页面

分类页面下面单独有个页面,叫做“添加分类“。

基本实现

根据上面的逻辑再写一个添加分类的路由

admin.js:

// 添加分类
router.get('/category/add',function(req,res,next){
    res.render('admin/category_add',{
        userInfo:req.userInfo
    });
});

同理,再添加一个category_add模板,大致这样:

{% extends 'layout.html' %}

{% block main %}

<h3>添加分类    <small>>表单</small></h3>

<form>
    <span>分类名</span><br/>
    <input type="text" name="name"/>
    <button type="submit">提交</button>
</form>

{%include 'page.html'%}
{% endblock %}

目前还非常简陋但是先实现功能再说。

添加逻辑

添加提交方式为post。

<form method="post">
  <!--balabala-->
</form>

所以路由器还得写个post形式的函数。

// 添加分类及保存方法:post
router.post('/category/add',function(req,res,next){

});

post提交的结果,还是返回当前的页面。

post提交到哪里?当然还是数据库。所以在schemas中新建一个提交数据库。categories.js

var mongoose=require('mongoose');

// 博客分类的表结构
module.exports= new mongoose.Schema({
    // 分类名称
    name: String,

});

好了。跟用户注册一样,再到model文件夹下面添加一个model添加一个Categories.js:

var mongoose=require('mongoose');

// 博客分类的表结构
var categoriessSchema=require('../schemas/categories');

module.exports=mongoose.model('Category',categoriessSchema);

文件看起来很多,但思路清晰之后相当简单。

完成这一步,就可以在admin.js添加Category对象了。

admin.js的路由操作:处理前端数据

还记得bodyparser么?前端提交过来的数据都由它进行预处理:

// app.js
app.use(bodyParser.urlencoded({extended:true}));

有了它,就可以通过req.body来进行获取数据了。

刷新,提交内容。

在post方法函数中打印req.body:

在这里我点击了两次,其中第一次没有提交数据。记录为空字符串。这在规则中是不允许的。所以应该返回一个错误页面。

// 添加分类及保存方法:post
var Category=require('../models/Categories');
router.post('/category/add',function(req,res,next){

    //处理前端数据
    var name=req.body.name||'';
    if(name===''){
        res.render('admin/error',{
          userInfo:req.userInfo
        });
    }
});

错误页面,最好写一个返回上一步(javascript:window.history.back())。

<!--error.html-->
{% extends 'layout.html' %}}

{% block main %}
<h3>出错了</h3>
<h4>你一定有东西忘了填写!</h4>
<a href="javascript:window.history.back()">返回上一步</a>
{% endblock %}

错误页面应该是可复用的。但的渲染需要传递哪些数据?

  • 错误信息(message)
  • 操作,返回上一步还是跳转其它页面?
  • url,跳转到哪里?

就当前项目来说,大概这样就行了。

res.render('admin/error',{
            userInfo:req.userInfo,
            message:'提交的内容不得为空!',
            operation:{
                url:'javascript:window.history.back()',
                operation:'返回上一步'
            }
        });

模板页面:

{% extends 'layout.html' %}}

{% block main %}
<h3>出错了</h3>
<h4>{{message}}</h4>
<a href={{operation.url}}>{{operation.operation}}</a>
{% endblock %}

如果名称不为空(save方法)

显然,这个和用户名的验证是一样的。用findOne方法,在返回的promise对象执行then。返回一个新的目录,再执行then。进行渲染。

其次,需要一个成功页面。基本结构和错误界面一样。只是h3标题不同

    // 查询数据是否为空
    Category.findOne({
        name:name
    }).then(function(rs){
        if(rs){//数据库已经有分类
            res.render('admin/error',{
                userInfo:req.userInfo,
                message:'数据库已经有该分类了哦。',
                operation:{
                    url:'javascript:window.history.back()',
                    operation:'返回上一步'
                }
            });
            return Promise.reject();
        }else{//否则表示数据库不存在该记录,可以保存。
            return  new Category({
                name:name
            }).save();
        }
    }).then(function(newCategory){
        res.render('admin/success',{
            userInfo:req.userInfo,
            message:'分类保存成功!',
            operation:{
                url:'javascript:window.history.back()',
                operation:'返回上一步'
            }
        })
    });
});

接下来的事就又交给前端了。

数据可视化

显然,渲染的分类管理页面应该还有一个表格。现在顺便把它完成了。其实基本逻辑和之前的用户分类显示是一样的。而且代码极度重复:

// 添加分类及保存方法
var Category=require('../models/Categories');


router.get('/category/', function (req,res,next) {
    var page=req.query.page||1;
    var limit=2;
    var count=0;

    Category.count().then(function(_count){
        count=_count;
        var pages=Math.ceil(count/limit);

        page=Math.min(page,pages);
        page=Math.max(page,1);

        var skip=(page-1)*limit;

        Category.find().limit(limit).skip(skip).then(function(categories){

            res.render('admin/category_index',{
                type:'category',
                userInfo:req.userInfo,
                categories:categories,
                page:page,
                pages:pages,
                limit:limit,
                count:count
            });
        });
    });//获取总页数
});

可以封装成函数了——一下就少了三分之二的代码量。

functionrenderAdminTable(obj,type,limit){
    router.get('/'+type+'/', function (req,res,next) {
        var page=req.query.page||1;

        var count=0;

        obj.count().then(function(_count){
            count=_count;
            var pages=Math.ceil(count/limit);

            page=Math.min(page,pages);
            page=Math.max(page,1);

            var skip=(page-1)*limit;

            obj.find().limit(limit).skip(skip).then(function(data){

                res.render('admin/'+type+'_index',{
                    type:type,
                    userInfo:req.userInfo,
                    data:data,
                    page:page,
                    pages:pages,
                    limit:limit,
                    count:count
                });
            });
        });//获取总页数
    });
}
//调用时,
//用户管理首页
var User=require('../models/User');
renderAdminTable(User,'user',1);
//分类管理首页
// 添加分类及保存方法
var Category=require('../models/Categories');
renderAdminTable(Category,'category',2);

模板

{% extends 'layout.html' %}

{% block main %}

<h3>分类列表</h3>

<table class="users-list">
    <thead>
    <tr>
        <th>id</th>
        <th>分类名</th>
        <th>备注</th>
        <th>操作</th>
    </tr>
    </thead>
    <tbody>
    {% for category in data %}
    <tr>
        <td>{{category._id.toString()}}</td>
        <td>{{category.name}}</td>
        <td>
          <a href="/admin/category/edit">修改 </a>
            |<a href="/admin/category/edit"> 删除</a>
        </td>
        <td></td>
    </tr>
    {% endfor %}
    </tbody>
</table>

{%include 'page.html'%}
{% endblock %}

博客分类的修改与删除

基本逻辑

删除的按钮是/admin/category/delete?id={{category._id.toString()}},同理修改的按钮是/admin/category/edit?id={{category._id.toDtring()}}(带id的请求)。

这意味着两个新的页面和路由:

分类修改,分类删除。

删除和修改都遵循一套比较严谨的逻辑。其中修改的各种判断相当麻烦,但是,修改和删除的逻辑基本是一样的。

当一个管理员在进行修改时,另一个管理员也可能修改(删除)了数据。因此需要严格判断。

修改(update)

修改首先做的是逻辑,根据发送请求的id值进行修改。如果id不存在则返回错误页面,如果存在,则切换到新的提交页面

// 分类修改
router.get('/category/edit',function(req,res,next){

    // 获取修改的分类信息,并以表单的形式呈现,注意不能用body,_id是个对象,不是字符串
    var id=req.query.id||'';

    // 获取要修改的分类信息
    Category.findOne({
        _id:id
    }).then(function(category){
        if(!category){
            res.render('admin/error',{
                userInfo:req.userInfo,
                message:'分类信息不存在!'
            });
            return Promise.reject();
        }else{
            res.render('admin/edit',{
                userInfo:req.userInfo,
                category:category
            });
        }
    });
});

然后是一个提交页,post返回的是当前页面

{% extends 'layout.html' %}

{% block main %}

<h3>分类管理    <small>>编辑分类</small></h3>

<form method="post">
    <span>分类名</span><br/>
    <input type="text" value="{{category.name}}" name="name"/>
    <button type="submit">提交</button>
</form>

还是以post请求保存数据。

  • 提交数据同样也需要判断id,当id不存在时,跳转到错误页面。

  • 当id存在,而且用户没有做任何修改,就提交,直接跳转到“修改成功”页面。实际上不做任何修改。

  • 当id存在,而且用户提交过来的名字和非原id({$ne: id})下的名字不同时,做两点判断:

  • 数据库是否存在同名数据?是则跳转到错误页面。

  • 如果数据库不存在同名数据,则更新同id下的name数据值,并跳转“保存成功”。

    更新的方法是

    Category.update({
      _id:你的id
    },{
      要修改的key:要修改的value
    })

根据此逻辑可以写出这样的代码。

//分类保存
router.post('/category/edit/',function(req,res,next){
    var id=req.query.id||'';

    var name=req.body.name||name;
    Category.findOne({
        _id:id
    }).then(function(category){

        if(!category){
            res.render('admin/error',{
                userInfo:req.body.userInfo,
                message:'分类信息不存在!'
            });
            return Promise.reject();
        }else{
            // 如果用户不做任何修改就提交
            if(name==category.name){
                res.render('admin/success',{
                    userInfo:req.body.userInfo,
                    message:'修改成功!',
                    operation:{
                        url:'/admin/category',
                        operation:'返回分类管理'
                    }
                });
                return Promise.reject();
            }else{
                // id不变,名称是否相同
                Category.findOne({
                    _id: {$ne: id},
                    name:name
                }).then(function(same){

                    if(same){
                        res.render('admin/error',{
                            userInfo:req.body.userInfo,
                            message:'已经存在同名数据!'
                        });
                        return Promise.reject();
                    }else{

                        Category.update({
                            _id:id
                        },{
                            name:name
                        }).then(function(){
                            res.render('admin/success',{
                                userInfo:req.body.userInfo,
                                message:'修改成功!',
                                operation:{
                                    url:'/admin/category',
                                    operation:'返回分类管理'
                                }
                            });
                        });


                    }
                });
            }
        }
    });
});

为了防止异步问题,可以写得更加保险一点。让它每一步都返回一个promise对象,

//分类保存
router.post('/category/edit/',function(req,res,next){
    var id=req.query.id||'';

    var name=req.body.name||name;
    Category.findOne({
        _id:id
    }).then(function(category){

        if(!category){
            res.render('admin/error',{
                userInfo:req.body.userInfo,
                message:'分类信息不存在!'
            });
            return Promise.reject();
        }else{
            // 如果用户不做任何修改就提交
            if(name==category.name){
                res.render('admin/success',{
                    userInfo:req.body.userInfo,
                    message:'修改成功!',
                    operation:{
                        url:'/admin/category',
                        operation:'返回分类管理'
                    }
                });
                return Promise.reject();
            }else{
                // 再查询id:不等于当前id
                return Category.findOne({
                    _id: {$ne: id},
                    name:name
                });
            }
        }
    }).then(function(same){
        if(same){
            res.render('admin/error',{
                userInfo:req.body.userInfo,
                message:'已经存在同名数据!'
            });
            return Promise.reject();
        }else{
            return Category.update({
                _id:id
            },{
                name:name
            });
        }
    }).then(function(resb){
        res.render('admin/success',{
            userInfo:req.body.userInfo,
            message:'修改成功!',
            operation:{
                url:'/admin/category',
                operation:'返回分类管理'
            }
        });
    });
});

这样就能实现修改了。

删除(remove)

删除的逻辑类似。但是要简单一些,判断页面是否还存在该id,是就删除,也不需要专门去写删除界面。,只需要一个成功或失败的界面就OK了。

删除用的是remove方法——把_id属性为id的条目删除就行啦

// 分类的删除
router.get('/category/delete',function(req,res){
    var id=req.query.id;

    Category.findOne({
        _id:id
    }).then(function(category){
        if(!category){
            res.render('/admin/error',{
                userInfo:req.body.userInfo,
                message:'该内容不存在于数据库中!',
                operation:{
                    url:'/admin/category',
                    operation:'返回分类管理'
                }
            });
            return  Promise.reject();
        }else{
            return Category.remove({
             _id:id
             })
        }
    }).then(function(){
        res.render('admin/success',{
            userInfo:req.body.userInfo,
            message:'删除分类成功!',
            operation:{
                url:'/admin/category',
                operation:'返回分类管理'
            }
        });
    });
});

前台分类导航展示与排序

前台的导航分类是写死的,现在是时候把它换成我们需要的内容了。

因为我个人项目的关系,我一级导航是固定的。所以就在文章分类下实现下拉菜单。

从数据库读取前台首页内容,基于main.js

为此还得引入Category

var Category=require('../models/Categories');
router.get('/',function(req,res,next){
    // 读取分类信息
    Category.find().then(function(rs){
        console.log(rs)
    });

    res.render('main/index',{
        userInfo:req.userInfo
    });
});

运行后打印出来的信息是:

就成功拿到了后台数据。

接下来就是把数据加到模板里面去啦

var Category=require('../models/Categories');

router.get('/',function(req,res,next){

    // 读取分类信息
    Category.find().then(function(categories){
        console.log(categories);
        res.render('main/index',{
            userInfo:req.userInfo,
            categories:categories
        });
    });

});

前端模板这么写:

<ul class="nav-article">
                            {% if !userInfo._id %}
                            <li><a href="javascript:;">仅限注册用户查看!</a></li>{%else%}{%for category in categories %}<li><a href="javascript:;">{{category.name}}</a></li>{% endfor %}{% endif %}</ul>

你在后台修改分类,

结果就出来了。挺好,挺好。

然而有一个小问题,就是我们拿到的数据是倒序的。

思路1:在后端把这个数组reverse一下。就符合正常的判断逻辑了。

res.render('main/index',{
            userInfo:req.userInfo,
            categories:categories.reverse()
        });

但这不是唯一的思路,从展示后端功能的考虑,最新添加的理应在最后面,所以有了思路2

思路2:回到admin.js对Category进行排序。

id表面上看是一串毫无规律的字符串,然而它确实是按照时间排列的。

那就行了,根据id用sort方法排序

obj.find().sort({_id:-1})......
//-1表示降序,1表示升序

博客分类管理这部分到此结束了。


十五. 文章管理(1):后台

文章管理还是基于admin.js

<!--layout.html-->
<li><a href="/admin/content">文章管理</a></li>

增加一个管理首页

<!--content.html-->
{% extends 'layout.html' %}

{% block main %}

<h3>文章管理 </h3>
<a href="content/add">添加新的文章!</a>

<!--表格-->

{% endblock %}

再增加一个编辑文章的界面,其中,要获取分类信息

{% extends 'layout.html' %}

{% block main %}

<h3>文章管理    <small>>添加文章</small></h3>

<form method="post">

    <span>标题</span>
    <input type="text" name="title"/>
    <span>分类</span>
    <select name="categories">
        {% for category in categories %}
        <option value="{{category._id.toString()}}">{{category.name}}</option>
        {% endfor %}
    </select>
    <button type="submit">提交</button><br>
    <span style="line-height: 30px;">内容摘要</span><br>
    <textarea id="description" cols="150" rows="3" placeholder="请输入简介" name="description">

    </textarea>
    <br>
    <span style="line-height: 20px;">文章正文</span><br>
    <textarea id="article-content">

    </textarea>

</form>

{% endblock %}

效果如下

再写两个路由。

// admin.js
// 内容管理
router.get('/content',function(req,res,next){

    res.render('admin/content_index',{
        userInfo:req.userInfo
    });
});

// 添加文章
router.get('/content/add',function(req,res,next){
    Category.find().then(function(categories){
        console.log(categories)
        res.render('admin/content_add',{
            userInfo:req.userInfo,
            categories:categories
        });
    })
});

获取数据

还是用到了schema设计应该存储的内容。

最主要的当然是文章相关——标题,简介,内容,发表时间。

还有一个不可忽视的问题,就是文章隶属分类。我们是根据分类id进行区分的

// schemas文件夹下的content.js

var mongoose=require('mongoose');

module.exports=new mongoose.Schema({
    // 关联字段 -分类的id
    category:{
        // 类型
        type:mongoose.Schema.Tpyes.ObjectId,
        // 引用,实际上是说,存储时根据关联进行索引出分类目录下的值。而不是存进去的值。
        ref:'Category'
    },

    // 标题
    title:String,

    // 简介
    description:{
        type:String,
        default:''
    },

    // 文章内容
    content:{
        type:String,
        default:''
    },

    // 当前时间
    date:String

});

接下来就是创建一个在models下面创建一个Content模型

// model文件夹下的Content.js

var mongoose=require('mongoose');
var contentsSchema=require('../schemas/contents');

module.exports=mongoose.model('Content',contentsSchema);

内容保存是用post方式提交的。

因此再写一个post路由

//admin.js
// 内容保存
router.post('/content/add',function(req,res,next){

    console.log(req.body);
});

在后台输入内容,提交,就看到提交上来的数据了。

不错。

表单验证

简单的验证规则:不能为空

验证不能为空的时候,应该调用trim方法处理之后再进行验证。

// 内容保存
router.post('/content/add',function(req,res,next){
    console.log(req.body)
    if(req.body.category.trim()==''){
        res.render('admin/error',{
            userInfo:req.userInfo,
            message:'分类信息不存在!'
        });
        return Promise.reject();
    }

    if(req.body.title.trim()==''){
        res.render('admin/error',{
            userInfo:req.userInfo,
            message:'标题不能为空!'
        });
        return Promise.reject();
    }

    if(req.body.content.trim()==''){
        res.render('admin/error',{
            userInfo:req.userInfo,
            message:'内容忘了填!'
        });
        return Promise.reject();
    }


});

还有个问题。就是简介(摘要)

保存数据库数据

保存和渲染相关的方法都是通过引入模块来进行的。

var Content=require('../models/Contents');
····

new Content({
        category:req.body.category,
        title:req.body.title,
        description:req.body.description,
        content:req.body.content,
        date:new Date().toDateString()
    }).save().then(function(){
            res.render('admin/success',{
                userInfo:req.userInfo,
                message:'文章发布成功!'
            });
        });
····

然后你发布一篇文章,验证无误后,就会出现“发布成功”的页面。

然后你就可以在数据库查询到想要的内容了

这个对象有当前文章相关的内容,也有栏目所属的id,也有内容自己的id。还有日期

为了显示内容,可以用之前封装的renderAdminTable函数

{% extends 'layout.html' %}

{% block main %}

<h3>文章管理 </h3>
<a href="content/add">添加新的文章!</a>

<table class="users-list">
    <thead>
    <tr>
        <th>标题</th>
        <th>所属分类</th>
        <th>发布时间</th>
        <th>操作</th>
    </tr>
    </thead>
    <tbody>
    {% for content in data %}

    <tr>
        <td>{{content.title}}</td>
        <td>{{content.category}}</td>
        <td>
            {{content.date}}
        </td>
        <td>
            <a href="/admin/content/edit?id={{content._id.toString()}}">修改 </a>
            |<a href="/admincontent/delete?id={{content._id.toString()}}"> 删除</a>
        </td>
    </tr>
    {% endfor %}
    </tbody>
</table>

{%include 'page.html'%}
{% endblock %}

分类名显示出来的是个object

分类名用的是data.category

但如果换成data.category.id就能获取到一个buffer对象,这个buffer对象转换后,应该就是分类信息。

但是直接用的话,又显示乱码。

这就有点小麻烦了。

回看schema中的数据库,当存储后,会自动关联Category模对象(注意:这里的Category当然是admin.js的Category)进行查询。查询意味着有一个新的方法populate。populate方法的参数是执行查询的属性。在这里我们要操作的属性是category

// 这是一个功能函数
functionrenderAdminTable(obj,type,limit,_query){
    router.get('/'+type+'/', function (req,res,next) {
        var page=req.query.page||1;
        var count=0;

        obj.count().then(function(_count){
            count=_count;
            var pages=Math.ceil(count/limit);
            page=Math.min(page,pages);
            page=Math.max(page,1);

            var skip=(page-1)*limit;
            /*            * sort方法排序,根据id,            * */
            var newObj=_query?obj.find().sort({_id:-1}).limit(limit).skip(skip).populate(_query):obj.find().sort({_id:-1}).limit(limit).skip(skip);
            newObj.then(function(data){
                console.log(data);

                res.render('admin/'+type+'_index',{
                    type:type,
                    userInfo:req.userInfo,
                    data:data,
                    page:page,
                    pages:pages,
                    limit:limit,
                    count:count
                });
            });
        });//获取总页数
    });
}

diao调用时写法为:renderAdminTable(Content,'content',2,'category');

打印出来的data数据为:

发现Category的查询结果就返回给data的category属性了

很棒吧!那就把模板改了

不错不错。

修改和删除

修改和删除基本上遵照同一个逻辑。

修改

请求的文章id如果在数据库查询不到,那就返回错误页面。否则渲染一个编辑页面(content_edit)——注意,这里得事先获取分类。

// 修改
router.get('/content/edit',function(req,res,next){
    var id=req.query.id||'';

    Content.findOne({
        _id:id
    }).then(function(content){
       if(!content){
           res.render('admin/error',{
               userInfo:req.userInfo,
               message:'该文章id事先已被删除了。'
           });
           return Promise.reject();
       }else{
           Category.find().then(function(categories){
               // console.log(content);
               res.render('admin/content_edit',{
                   userInfo:req.userInfo,
                   categories:categories,
                   data:content
               });
           });
       }
    });
});

把前端页面显示出来之后就是保存。

保存的post逻辑差不多,但实际上可以简化。

// 保存文章修改
router.post('/content/edit',function(req,res,next){
    var id=req.query.id||'';

    Content.findOne({
        _id:id
    }).then(function(content){
        if(!content){
            res.render('admin/error',{
                userInfo:req.body.userInfo,
                message:'文章id事先被删除了!'
            });
            return Promise.reject();
        }else{
            return Content.update({
                _id:id
            },{
                category:req.body.category,
                title:req.body.title,
                description:req.body.description,
                content:req.body.content
            });
        }
    }).then(function(){
        res.render('admin/success',{
            userInfo:req.body.userInfo,
            message:'修改成功!',
            operation:{
                url:'/admin/content',
                operation:'返回分类管理'
            }
        });
    });
});

删除

基本差不多。

router.get('/content/delete',function(req,res,next){
   var id=req.query.id||'';

    Content.remove({
        _id:id
    }).then(function(){
        res.render('admin/success',{
            userInfo:req.userInfo,
            message:'删除文章成功!',
            operation:{
                url:'/admin/content',
                operation:'返回分类管理'
            }
        });
    });
});

信息扩展(发布者,点击量)

可以在数据表结构中再添加两个属性

user: {
        //类型
        type:mongoose.Schema.Types.objectId,
        //引用
        ref:'User'
    },
    
    views:{
      type:Number,
      default:0
    }

然后在文章添加时,增添一个user属性,把req.userInfo._id传进去。

显示呢?实际上populate方法接受一个字符串或者有字符串组成的数组。所以数组应该是xxx.populate(['category','user'])。这样模板就能拿到user的属性了。

然后修改模板,让它展现出来:


十六. 文章管理(2):前台

先给博客写点东西吧。当前的文章确实太少了。

当我们写好了文章,内容就已经存放在服务器上了。前台怎么渲染是一个值得考虑的问题。显然,这些事情都是main.js完成的。

这时候注意了,入门一个领域,知道自己在干什么是非常重要的。

获取数据集

由于业务逻辑,我的博客内容设置为不在首页展示,需要在/article页专门展示自己的文章,除了全部文章,分类链接渲染的是:/article?id=xxx

先看全部文章下的/article怎么渲染吧。

文章页效果预期是这样的:

  • 文章页需要接收文章的信息。
  • 文章需要接收分页相关的信息。

文章页需要接收的信息比较多,所以写一个data对象,把这些信息放进去,到渲染时直接用这个data就行了。

//main.js
var express=require('express');

var router=express.Router();

var Category=require('../models/Categories');
var Content=require('../models/Content');
/**省略首页路由**/
router.get('/article',function(req,res,next){
    var data={
        userInfo:req.userInfo,
        categories:[],
        count:0,
        page:Number(req.query.page||1),
        limit:3,
        pages:0
    };

    // 读取分类信息
    Category.find().then(function(categories){
        data.categories=categories;

        return Content.count();
    }).then(function(count){
        data.count=count;
        //计算总页数
        data.pages=Math.ceil(data.count/data.limit);
        // 取值不超过pages
        data.page=Math.min(data.page,data.pages);
        // 取值不小于1
        data.page=Math.max(data.page,1);
        // skip不需要分配到模板中,所以忽略。
        var skip=(data.page-1)*data.limit;

        return Content.find().limit(data.limit).skip(skip).populate(['category','user']).sort(_id:-1);


    }).then(function(contents){
        data.contents=contents;
        console.log(data);//这里有你想要的所有数据
        res.render('main/article',data);
    })
});

该程序反映了data一步步获取内容的过程。

前台应用数据

  • 我只需要对文章展示做个for循环,然后把数据传进模板中就可以了。

```javascript
{% for content in contents %}



{{content.date.slice(5,11)}}
{{content.category.name.slice(0,3)+'..'}}

                  <p>{{content.description}}</p>
                  <address>推送于{{content.date}}</address>
              </div>
              {% endfor %}

```

  • 侧边栏有一个文章内容分类区,把数据传进去就行了。

  • 分页按钮可以这样写

```html




      {% if page-1!==0 %}


      {%endif%}
{% if page+1<=pages %}
                      <li><a href="/article?page={{page+1}}">下一页</a></li>
                      {% endif %}
                      <li><a href="/article?page={{pages}}">最后页</a></li>
                  </ul>
              </div>

```

效果:

你会发现,模板的代码越写越简单。

获取分类下的页面(where方法)

现在来解决分类的问题。

之前我们写好的分类页面地址为/article?category={{category._id.toString()}}

所以要对当前的id进行响应。如果请求的category值为不空,则调用where显示。

router.get('/article',function(req,res,next){
    var data={
        userInfo:req.userInfo,
        category:req.query.category||'',
        categories:[],
        count:0,
        page:Number(req.query.page||1),
        limit:3,
        pages:0
    };
    var where={};
    if(data.category){
        where.category=data.category
    }
  //...
  return Content.where(where).find().limit(data.limit).skip(skip).sort({_id:-1}).populate(['category','user']);

这样点击相应的分类,就能获取到相应的资料了。

但是页码还是有问题。原因在于count的获取,也应该根据where进行查询。

return Content.where(where).count();

另外一个页码问题是,页码的链接写死了。

只要带上category就行了。

所以比较完整的页码判断是:

<ul>
                        {% if pages>0 %}
                        <li><a href="/article?category={{category.toString()}}&page=1">第一页</a></li>
                        {% if page-1!==0 %}
                        <li><a href="/article?category={{category.toString()}}&page={{page-1}}">上一页</a></li>
                        {%endif%}

                        <li style="background:rgb(166,96,183);"><a style="color:#fff;"  href="javascript:;">{{page}}/{{pages}}</a></li>

                        {% if page+1<=pages %}
                        <li><a href="/article?category={{category.toString()}}&page={{page+1}}">下一页</a></li>
                        {% endif %}
                        <li><a href="/article?category={{category.toString()}}&page={{pages}}">最后页</a></li>
                        {% else %}
                        <li style="width: 100%;text-align: center;">当前分类没有任何文章!</li>
                        {% endif %}
                    </ul>

然后做一个当前分类高亮显示的判断

<ul>
                        {% if category=='' %}
                        <li><a style="border-left: 6px solid #522a5c;" href="/article">全部文章</a></li>
                        {%else%}
                        <li><a href="/article">全部文章</a></li>
                        {% endif %}
                        {% for _category in categories %}
                        {% if category.toString()==_category._id.toString() %}
                        <li><a style="border-left: 6px solid #522a5c;" href="/article?category={{_category._id.toString()}}">{{_category.name}}</a></li>
                        {% else %}
                        <li><a href="/article?category={{_category._id.toString()}}">{{_category.name}}</a></li>
                        {% endif %}
                        {% endfor %}
                    </ul>

展示文章详细信息

同理内容详情页需要给个链接,然后就再写一个路由。在这里我用的是/view?contentid={{content._id}}

基本逻辑

需要哪些数据?

      • userInfo
      • 全部分类信息
      • 文章内容(content)——包括当前文章所属的分类信息

查询方式:contentId

router.get('/view/',function(req,res,next){
    var contentId=req.query.contentId||'';
    var data={
        userInfo:req.userInfo,
        categories:[],
        content:null
    };

    Category.find().then(function(categories){
        data.categories=categories;
        return Content.findOne({_id:contentId});
    }).then(function(content){
        data.content=content;
        console.log(data);
        res.render('main/view',data);
    });
});

发现可以打印出文章的主要内容了。

接下来就是写模板。

新建一个article_layout.html模板,把article.html的所有内容剪切进去。

博客展示页的主要区域在于之前的内容列表。所以把它抽离出来。

把一个个内容按照逻辑加上去,大概就是这样。

阅读数的实现

很简单,每当用户点击文章,阅读数就加1.

router.get('/view/',function(req,res,next){
    var contentId=req.query.contentId||'';
    var data={
        userInfo:req.userInfo,
        categories:[],
        content:null
    };

    Category.find().then(function(categories){
        data.categories=categories;
        return Content.findOne({_id:contentId});
    }).then(function(content){
        data.content=content;
        content.views++;//保存阅读数
        content.save();
        console.log(data);
        res.render('main/view',data);
    });
});

内容评论

先把评论的样式写出来吧!大概是这样

评论是通过ajax提交的。是在ajax模块——api.js

评论的post提交到数据库,应该放到数据库的contents.js中。

// 评论
    comments: {
        type:Array,
        default:[]
    }

每条评论包括如下内容:

评论者,评论时间,还有评论的内容。

在api.js中写一个post提交的路由

// 评论提交
router.post('/comment/post',function(req,res,next){
    // 文章的id是需要前端提交的。
    var contentId=req.body.contentId||'';
    var postData={
        username:req.userInfo.username,
        postTime: new ConvertDate().getDate(),
        content: req.body.content
    };

    // 查询当前内容信息
    Content.findOne({
        _id:contentId
    }).then(function(content){
        content.comments.push(postData);
        return content.save()
    }).then(function(newContent){//最新的内容在newContent!
        responseData.message='评论成功!';
        res.json(responseData);
    })

});

然后在你的view页面相关的文件中写一个ajax方法,我们要传送文章的id

但是文章的id最初并没有发送过去。可以在view页面写一个隐藏的input#contentId,把当前文章的id存进去。然后通过jQuery拿到数据。

// 评论提交
    $('#messageComment').click(function(){
        $.ajax({
            type:'POST',
            url:'/api/comment/post',
            data:{
                contentId:$('#contentId').val(),
                content:$('#commentValue').val(),
            },
            success:function(responseData){
                console.log(responseData);
            }
        });
        return false;

    });

很简单吧!

评论提交后,清空输入框,然后下方出现新增加的内容。

最新的内容从哪来呢?在newContent处。所以我们只需要让responseData存进newContent,就能实现内容添加。

// api.js
//...
// 查询当前内容信息
    Content.findOne({
        _id:contentId
    }).then(function(content){
        content.comments.push(postData);
        return content.save()
    }).then(function(newContent){
        responseData.message='评论成功!';
        responseData.data=newContent;
        res.json(responseData);
    })

//...

看,这样就拿到数据了。

接下来就在前端渲染页面:

用这个获取内容。

functionrenderComment(arr){
    var innerHtml='';
    for(var i=0;i<arr.length;i++){
        innerHtml='<li><span class="comments-user">'+arr[i].username+' </span><span class="comments-date">'+arr[i].postTime+'</span><p>'+arr[i].content+'</p></li>'+innerHtml;
    }
    return innerHtml;
}
    // 评论提交
    $('#messageComment').click(function(){
        $.ajax({
            type:'POST',
            url:'/api/comment/post',
            data:{
                contentId:$('#contentId').val(),
                content:$('#commentValue').val(),
            },
            success:function(responseData){
                console.log(responseData);
                alert(responseData.message);
                var arr= responseData.data.comments;
                //console.log(renderComment(arr));
                $('.comments').html(renderComment(arr));
            }
        });
        return false;

    });

这样就可以显示出来了。但是发现页面一刷新,内容就又没有了——加载时就调用ajax方法。

api是提供一个虚拟地址,ajax能够从这个地址获取数据。

从新写一个路由:

//api.js
// 获取指定文章的所有评论
router.get('/comment',function(req,res,next){
    var contentId=req.query.contentId||'';
    Content.findOne({
       _id:contentId
    }).then(function(content){
        responseData.data=content;
        res.json(responseData);
    })
});

注意这里是get方式

 //每次文章重载时获取该文章的所有评论
    $.ajax({
        type:'GET',
        url:'/api/comment',
        data:{
            contentId:$('#contentId').val(),
            content:$('#commentValue').val(),
        },
        success:function(responseData){
            console.log(responseData);
            var arr= responseData.data.comments;
            //console.log(renderComment(arr));
            $('.comments').html(renderComment(arr));
            $('#commentValue').val('');
            $('#commentsNum').html(arr.length)
        }
    });

评论分页

分因为是ajax请求到的数据,所以完全可以在前端完成。

评论分页太老旧了。不如做个伪瀑布流吧!

预期效果:点击加载更多按钮,出现三条评论。

之所以说是伪,因为评论一早就拿到手了。只是分段展示而已。当然你也可以写真的。每点击一次都触发新的ajax请求。只请求三条新的数据。

评论部分完全可以写一个对象。重置方法,加载方法,获取数据方法。

写下来又是一大篇文章。

// 加载评论的基本逻辑
functionComments(){
    this.count=1;
    this.comments=0;
}

在ajax请求评论内容是时,给每条评论的li加一个data-index值。

// 获取评论内容
Comments.prototype.getComment=function(arr){
    var innerHtml='';
    this.comments=arr.length;//获取评论总数
    for(var i=0;i<arr.length;i++){
        innerHtml=
            '<li data-index='+(arr.length-i)+'><span class="comments-user">'+
            arr[i].username+
            ' </span><span class="comments-date">'+
            arr[i].postTime+
            '</span><p>'+
            arr[i].content+
            '</p></li>'+innerHtml;
    }
    
    return innerHtml;
};

在每次加载页面,每次发完评论的时候,都初始化评论页面。首先要做的是解绑加载按钮可能的事件。当评论数少于三条,加载按钮变成“没有更多了”。超过三条时,数据自动隐藏。

Comments.prototype.resetComment=function (limit){
    this.count=1;
    this.comments=$('.comments').children().length;//获取评论总数
    $('#load-more').unbind("click");

    if(this.comments<limit){
        $('#load-more').text('..没有了');
    }else{
        $('#load-more').text('加载更多');
    }

    for(var i=1;i<=this.comments;i++){
        if(i>limit){
            $('.comments').find('[data-index='+ i.toString()+']').css('display','none');
        }
    }
};

点击加载按钮,根据点击计数加载评论

Comments.prototype. loadComments=function(limit){
    var _this=this;
    $('#load-more').click(function(){
        //console.log([_this.comments,_this.count]);
        if((_this.count+1)*limit>=_this.comments){
            $(this).text('..没有了');

        }
        _this.count++;

        for(var i=1;i<=_this.comments;i++){
            if(_this.count<i*_this.count&&i<=(_this.count)*limit){
                $('.comments').find('[data-index='+ i.toString()+']').slideDown(300);
            }
        }
    });
};

然后就是在网页中应用这些方法:

$(function(){
    //每次文章重载时获取该文章的所有评论
    $.ajax({
        type:'GET',
        url:'/api/comment',
        data:{
            contentId:$('#contentId').val(),
            content:$('#commentValue').val(),
        },
        success:function(responseData){

            var arr= responseData.data.comments;
            //渲染评论的必要方法
            var renderComments=new Comments();

            //获取评论内容
            $('.comments').html(renderComments.getComment(arr));

            //清空评论框
            $('#commentValue').val('');

            //展示评论条数
            $('#commentsNum').html(arr.length);

            //首次加载展示三条,每点击一次加载3条
            renderComments.resetComment(3);
            renderComments.loadComments(3);


            // 评论提交
            $('#messageComment').click(function(){
                $.ajax({
                    type:'POST',
                    url:'/api/comment/post',
                    data:{
                        contentId:$('#contentId').val(),
                        content:$('#commentValue').val(),
                    },
                    success:function(responseData){

                        alert(responseData.message);
                        var arr= responseData.data.comments;
                        $('.comments').html(renderComments.getComment(arr));
                        $('#commentValue').val('');
                        $('#commentsNum').html(arr.length);

                        renderComments.resetComment(3);
                        renderComments.loadComments(3);
                    }
                });
                return false;
            });
            
            
            
        }
    });

});

发布者信息和文章分类展示

get方式获取的内容中虽然有了文章作者id,但是没有作者名。也缺失当前文章的内容。所以在get获取之后,需要发送发布者的信息。

另一方面,由于view.html继承的是article的模板。而article是需要在在发送的一级目录下存放一个category属性,才能在模板判断显示。

因此需要把data.content.category移到上层数性来。

}).then(function(content){
        //console.log(content);
        data.content=content;
        content.views++;
        content.save();

       return User.find({
            _id:data.content.user
        });

    }).then(function(rs){
        data.content.user=rs[0];
        data.category=data.content.category;
        res.render('main/view',data);
    });

markdown模块的使用

现在的博客内容是混乱无序的。

那就用到最后一个模块——markdown

按照逻辑来说,内容渲染不应该在后端进行。尽管你也可以这么做。但是渲染之后,编辑文章会发生很大的问题。

所以我还是采用熟悉的marked.js,因为它能比较好的兼容hightlight.js的代码高亮。

<script type="text/javascript" src="../../public/js/marked.js"></script>
<script type="text/javascript" src="../../public/js/highlight.pack.js"></script>
<script>hljs.initHighlightingOnLoad();</script>
// ajax方法
success:function(responseData){
           // console.log(responseData);
            var a=responseData.data.content;

            var rendererMD = new marked.Renderer();
            marked.setOptions({
                renderer: rendererMD,
                gfm: true,
                tables: true,
                breaks: false,
                pedantic: false,
                sanitize: false,
                smartLists: true,
                smartypants: false
            });


            marked.setOptions({
                highlight: function (code,a,c) {
                    return hljs.highlightAuto(code).value;
                }
            });
  //后文略...

在通过ajax请求到数据集之后,对内容进行渲染。然后插入到内容中去。

那么模板里的文章内容就不要了。

但是,浏览器自带的html标签样式实在太丑了!在引入样式库吧

highlight.js附带的样式库提供了多种基本的语法高亮设置。

然后你可以参考bootstrap的code部分代码。再改改行距,自适应图片等等。让文章好看些。


十七. 收尾

到目前为止,这个博客就基本实现了。

前端需要一些后端的逻辑,才能对产品有较为深刻的理解。

下面关于Node.js的内容你可能也喜欢

Node.js 的详细介绍请点这里
Node.js 的下载地址请点这里

猜你喜欢

转载自www.linuxidc.com/Linux/2017-02/140115.htm