Nodejs之MEAN栈开发-- form验证及图片上传

Posted 2020-07-30

这一节增加推荐图书的提交和删除功能，来学习node的form提交以及node的图片上传功能。开始之前需要源码同学可以先在git上fork：https://github.com/stoneniqiu/ReadingClub

一、form验证

 MVC的form验证有三个地方可以做，第一道关就是前端提交之前，第二道关就是在数据保存之前，也就是在controller中做验证，第三道关就是数据保存的时候，也就是如果提交的数据模型不符合实体定义的约束，数据是无法保存的，这是最后一道防线。第一道关主要是依赖于js或者jquery框架，比较常用的是jquery.validate.js。如果是Asp.net MVC 可以自动生成验证规则，这里就不细究了，网上有很多文章。第二层和各自的业务逻辑有关,也需要做一些必要验证，防止前端禁止javascript，而提交不合法数据，这里是要讲基于Mongoose的第三层验证。

1.回顾模型定义

我们先回顾一下之前用Mongoose定义的book模型：

var bookSchema = new mongoose.Schema({
    title: { type: String, required: true },
    rating: {
        type: Number,
        required: true,
        min: 0,
        max: 5
    },
    info: { type: String, required: true },
    img: String,
    tags: [String],
    brief: { type: String, required: true },
    ISBN: String,
});

每个属性定义了类型和是否必须，还可以添加min，max，默认值等其他约束。如果提交的模型不满足这些约束，将不能保存成功。相当于Asp.net MVC中的DataAnnotations的作用。后面的form验证就基于此。

2.添加路由

 我们需要增加4个路由规则，2个用于添加(一个get，一个post)，一个用于删除，一个用于上传图片：

router.get(\'/book/create\', homeController.bookcreateview);
router.post(\'/book/create\', homeController.doBookCreate);
router.delete(\'/book/:id\', homeController.delete);
router.post(\'/uploadImg\', homeController.uploadImg);

基于Express的路由，我们可以创建Restful的路由规则。路由位于app_server文件夹下。

3.添加控制器方法

home.bookcreateview:

module.exports.bookcreateview = function (req, res) {
    res.render(\'bookCreate\', { title: \'新增推荐图书\' });
};

这里直接是一个get请求，所以直接用render去渲染视图，当然这个bookCreate视图接下来会创建。

doBookCreate:

module.exports.doBookCreate = function (req, res) {
    var requestOptions, path, postdata;
    path = "/api/book";
    postdata = {
        title: req.body.title,
        info: req.body.info,
        ISBN: req.body.ISBN,
        brief: req.body.brief,
        tags: req.body.tags,
        img: req.body.img,
        rating:req.body.rating,
    };
    requestOptions = {
        url: apiOptions.server + path,
        method: "POST",
        json: postdata,
    };
    request(requestOptions, function (err, response, body) {
        console.log("body.name", body.name, response.statusCode);
        if (response.statusCode === 201) {
            res.redirect("/detail/"+body._id);
        } 
        else if (response.statusCode == 400 && body.name && body.name == "ValidationError") {
            res.render(\'bookCreate\', { title: \'新增推荐图书\', error:"val"});
        }
        else {
            console.log("body.name",body.name);
            info(res, response.statusCode);
        }
    });
};

info:

function info (res, status) {
    var title, content;
    if (status === 404) {
        title = "404, 页面没有找到";
        content = "亲，页面飞走了...";
    } else if (status === 500) {
        title = "500, 内部错误";
        content = "尴尬...，发生错误";
    } else {
        title = status + ", 有什么不对劲";
        content = "某些地方可能有些错误";
    }
    res.status(status);
    res.render(\'info\', {
        title : title,
        content : content,
        status: status,
    });
};

View Code

在上一节，我们创建了数据操作的api部分。代码的流程就是先从req中获取到前端传过来的数据，然后用request模块调用api，如果添加成功(状态码是201)就返回到detail页面，如果验证失败，就原路返回，并给出提示。如果错误，交给info方法去处理。

delete:

module.exports.delete = function (req, res) {
    var requestOptions, path;
    path = "/api/book/" + req.params.id;
    requestOptions = {
        url: apiOptions.server + path,
        method: "delete",
        json: {},
    };
    request(requestOptions, function (err, response, body) {
        if (response.statusCode == 204) {
            res.json(1);
        } 
        else {
            res.json(0);
        }
    });
};

如果删除成功，返回的状态码是204，然后返回json(1)让前端去处理界面。

4.添加视图

1) 先需要在图书列表的右侧边栏增加一个按钮：

在books视图中修改：

   .col-md-3
     .userinfo
       p stoneniqiu
       a(href=\'/book/create\').btn.btn-info 新增推荐

当用户点击会跳转到/book/create页面

2)新增推荐页面：

extends layout
include _includes/rating

block content
  .row
   .col-md-12.page.bookdetail
      h3 新增推荐书籍  
      .row
        .col-xs-12.col-md-6
         form.form-horizontal(action=\'\',method="post",role="form")
          - if (error == "val")
           .alert.alert-danger(role="alert") All fields required, please try again
          .form-group
            label.control-label(for=\'title\') 书名
            input#name.form-control(name=\'title\')
          .form-group
            label.control-label(for=\'info\') 信息
            input#name.form-control(name=\'info\')            
          .form-group
            label.control-label(for=\'ISBN\') ISBN
            input#name.form-control(name=\'ISBN\')
          .form-group
            label.control-label(for=\'brief\') 简介
            input#name.form-control(name=\'brief\')
          .form-group
            label.control-label(for=\'tags\') 标签
            input#name.form-control(name=\'tags\')
          .form-group
            label.control-label(for=\'rating\') 推荐指数
            select#rating.form-control.input-sm(name="rating")
              option 5
              option 4
              option 3
              option 2
              option 1
          .form-group
            p 上传图片
            a.btn.btn-info(id="upload", name="upload") 上传图片
            br
            img(id=\'img\')
          .form-group
            button.btn.btn-primary(type=\'submit\') 提交
    

if语句的地方是用来显示错误提示；图片上传，稍后完整介绍；所以提交页面基本长成这样：

3）Mongoose验证

这个时候没有加前端验证，form可以直接提交。但是node打印出了错误日志，Book validation failed，验证失败。

这是Mongoose给我们返回的验证信息，这时界面上回显示一个提示信息：

这是因为在controller中的处理：

  else if (response.statusCode == 400 && body.name && body.name == "ValidationError") {
            res.render(\'bookCreate\', { title: \'新增推荐图书\', error:"val"});
        }

以上说明了Mongoose会在数据保存的时候验证实体，如果实体不满足path规则，将不能保存。但至此有三个问题，第一个问题是提示信息不明确，当然我们可以遍历输出ValidatorError；第二个就是，验证错误之后，页面原来的数据没有了，需要再输入一遍，这个我们可以参考Asp.net MVC将模型数据填充到视图中可以解决；第三个问题就是页面前端还没有验证，form直接就可以提交了，这个可以通过简单的Jquery脚本就可以做到；这三点先不细究。继续往下看，如果规范输入，这个时候是可以提交的，提交之后在books页面可以看到:

 

4）删除

在标题的右侧增加了一个删除符号（books视图中）：

         .col-md-10
            p
             a(href="/Detail/#{book._id}")=book.title
             span.close(data-id=\'#{book._id}\') ×

并添加脚本：

$(".close").click(function() {
    if (confirm("确定删除？")) {
        var id = $(this).data("id");
        var row = $(this).parents(".booklist");
        $.ajax({
            url: "/book/" + id,
            method: "delete",
        }).done(function(data) {
            console.log(data);
            row.fadeOut();
        });
    }
});

脚本可以先位于layout视图下方：

  script(src=\'/javascripts/books.js\')

这样，删除完成之后会隐藏当前行。下面解决图片上传问题。

二、图片上传

前面我们在路由里面定义了一个uploadimg方法，现在实现它。一般都涉及两个部分，一个是前台图片的提交，一个是后端数据的处理。

1.uploadimg 方法实现

先需要安装formidable模块。

然后在Public文件下创建一个upload/temp文件夹

脚本：

var fs = require(\'fs\');
var formidable = require(\'formidable\');
module.exports.uploadImg = function (req, res) {
  var form = new formidable.IncomingForm();   //创建上传表单
      form.encoding = \'utf-8\';        //设置编辑
      form.uploadDir = \'./../public/upload/temp/\';     //设置上传目录
      form.keepExtensions = true;     //保留后缀
      form.maxFieldsSize = 3 * 1024 * 1024;   //文件大小

    form.parse(req, function(err, fields, files) {
        console.log(files);
        if (err) {
            console.log(err);
          return res.json(0);        
        }
        for (var key in files) {
            console.log(files[key].path);
            var extName = \'\'; //后缀名
            switch (key.type) {
            case \'image/pjpeg\':
                extName = \'jpg\';
                break;
            case \'image/jpeg\':
                extName = \'jpg\';
                break;
            case \'image/png\':
            case \'image/x-png\':
            default:
                extName = \'png\';
                break;
            }
            var avatarName = (new Date()).getTime() + \'.\' + extName;
            var newPath = form.uploadDir + avatarName;
            
            fs.renameSync(files[key].path, newPath); //重命名
            return res.json("/upload/temp/"+ avatarName);
        }
    });
 
};

这个form会自动将文件保存到upLoadDir目录，并以upload_xxxx格式重新命名，所以最后使用fs模块对文件进行重命名。然后返回给前端。

2.前端

我喜欢用插件，前端我用的是plupload-2.1.8，拥有多种上传方式，比较方便。放置在Public文件下。在layout.jade中引用js：

   script(src=\'/plupload-2.1.8/js/plupload.full.min.js\')
   script(src=\'/javascripts/books.js\')

而在bookCreate.jade视图中，修改如下：

            a.btn.btn-info(id="upload", name="upload") 上传图片
            br
            img(id=\'img\')
            input#imgvalue(type=\'hidden\',name=\'img\',value=\'\')

a标签用来触发上传，img用来预览，input用来存放路径。在books.js下增加以下代码：

var uploader = new plupload.Uploader({
    runtimes: \'html5,flash,silverlight,html4\',
    browse_button: "upload",
    url: \'/uploadImg\',
    flash_swf_url: \'/plupload-2.1.8/js/Moxie.swf\',
    silverlight_xap_url: \'/plupload-2.1.8/js/Moxie.xap\',
    filters: {
        max_file_size: "3mb",
                mime_types: [
                    { title: "Image files", extensions: "jpg,gif,png" },
                    { title: "Zip files", extensions: "zip" }
                ]
    },
    init: {
        PostInit: function () {
        },
        FilesAdded: function (up, files) {
            plupload.each(files, function (file) {
                uploader.start();
            });
        },
        UploadProgress: function (up, file) {
        },
        Error: function (up, err) {
        }
    }
});
uploader.init();
uploader.bind(\'FileUploaded\', function (upldr, file, object) {
    var data = JSON.parse(object.response);
    console.log(data);
    $("#img").attr("src", data);
    $("#imgvalue").val(data);
});

提交:

 上传成功后跳转到detail页面。

 至此，围绕form的提交这一节学习了Mongoose的数据验证，以及使用plupload上传，以及后端用formidable和fs模块处理图片。相对于Asp.net MVC而言，Asp.net MVC因为有自动化的form相对快捷一些。下一节将介绍Angular，作为MEAN中的A，该出场了。

源码：https://github.com/stoneniqiu/ReadingClub