介绍一个node创建博客的教程并总结

接近一个月没写博客了，是因为实在不知道该写什么= =。。。

除了完成工作外，这段时间自学了一个教你使用node从0-1创建博客的教程，写的十分详细，教程也重构过几次了，已经相对比较完善，推荐对node感兴趣的同学去学习一下，除了node外最近也在看阮一峰老师的《ES6入门》，内容非常多，写的非常细，在这里我不会做总结，内容太多实在不知道怎么总结，如果我看完了，可能会挑一些自己觉得不清楚的地方记录下来吧~下面是2个教程的地址。

博客教程：《一起学 Node.js》彻底重写完毕
ES6入门：ECMAScript 6 入门

下面是对博客教程的一些个人总结，由于我只是暂时完成了一次，还没再次进行code review，如果有写错的地方，后续我会改正。

一、项目的设计模式远远比你良好的数据结构和代码质量重要的多

上图是最终的项目完成后的目录结构，可以很明显的看到MVC的标准结构；

models中分别为组件模型、文章模型、用户模型的建立与修改，都是对数据库的CRUD操作以及对函数进行封装。
routes中为所有的路由控制，用于实现页面之间的交互逻辑与各个页面的业务逻辑，如登录、注册、留言、发表文章等等操作，业务路由分为5块，主页、文章页、登录、登出、注册，处理方式为直接调用model层中对应js包函数进行业务处理。
views中为页面模板文件，存放可服用的页面模板，模板文件采用ejs来处理，如果有同学熟悉jade，当然你可以用jade重写~由于已经通过多次重构与设计，模板的可复用性已经十分高了，views文件夹内部分为各页面模板与可复用组件，可复用组件放于components文件夹内；
可复用的组件包括：文章展示栏、导航栏、导航栏内设定操作、信息通知栏、文章评论栏；
可复用的页面公共部分：头部模板、尾部模板，头部为设定与通知，尾部为导航设定js脚本；
使用ejs或者jade模板的优点：Java SE的jsp知道吧。。。
config内为配置文件，用于生产环境与开发环境的配置部署与切换，如数据库地址；
lib内为数据库模型的声明与建立，包括用户模型、文章模型与评论模型；

这大概就是项目的整体架构和设计了，项目结束后，我们马后炮的来看看优点在哪

MVC的设计模式，实现业务逻辑、数据操作、视图的分离，在这里视图的可复用性是关键，否则你就真是jsp了，如果不分离而将业务逻辑与数据操作混合，后续维护我想别人是看不懂的了兄弟。
生产环境与开发环境等公共数据的分离，项目开始前我们一定要清楚哪些数据是公共部分，如cookie与session的设定；而哪些是需要灵活切换配置的部分，如数据库地址、api、uri等配置。
将数据模型的建立与业务逻辑的CRUD操作分离，这两者可以说是没有关系的，何必要放在一起增加其他维护者的时间成本呢？

以上3点就是我个人的一些劣见了，这只是我可以看到的优点，不代表没有其他优点，见仁见智了，也许水平更高后会有新的感悟吧。

二、关于教程中使用Mongodb的一点点学习总结

作者在教程中推荐使用的数据库可视化工具分别为Robomongo与Mongochef，在这里我推荐使用后者，Mongochef；为什么呢？因为Robomongo在本地数据库下是可以直接使用的，但是在你切换为MLab的线上数据库时，它要求你需要有unix内核，而windows是没有unix内核的，所以我想一般的前端应该都还在使用windows吧，这里希望大家避过这个坑，免得像我一样浪费了时间在调试上。
Mongodb是非关系型数据库，也就是说它不像SQL一样具有外键来以此进行关联查询等操作，所以我们推荐使用mongoose的populate,教程中只使用了2个参数，path与model，其他参数也用的比较少，如果大家这里去看文档的这个api会发现说的比较生涩，经过我几次的实际操作，总结出来就是与mysql外键的使用时一样的，path是你需要引用到本次结果的外键名，model就是外键名对应键值，当然这里的model会根据你上一步的查询操作去查询，所以你自然是需要给一个两个数据模型都存在的字段去查询，如id,所以这个populate实际上就是mongoose封装的非关系型数据库的外键。
关于作者使用的Mongolass,不要多想,这就是对Mongoose进行封装后的插件，你完全可以选择不用，作者在文中也多次提及，所以Mongolass与Mongoose的操作是一致的，如果学习，那么你学习Mongoose就可以了，而作者的Mongolass优点就是在于中间件的增加，即这个apimongolass.plugin()，你可以对你的所有数据库操作进行中间件的封装，在操作数据库时，可直接像调函数一样复用，这是mongoose所没有的，作者也就是在这层上做了一点小事，而我们，完全是可以在数据库操作回调的数据结构上使用函数的，只是如果使用作者这套会更清晰而已;这里给个例子给大家
```
//创建中间件addCreateAt,afterFind值数据操作返回结果为数组时，afterFindOne指返回为单个对象时
mongolass.plugin('addCreateAt', {afterFind: function (results) {results.forEach(function (item) {item.create_at = moment(objectIdToTimestamp(item._id)).format('YYYY-MM-DD HH:mm');});return results;},afterFindOne: function (result) {if (result) {result.create_at = moment(objectIdToTimestamp(result._id)).format('YYYY-MM-DD HH:mm');}return result;}
});module.exports = {// 注册一个用户create: function create(user) {return User.create(user).exec();},// 通过用户名获取用户信息getUserByName: function getUserByName (name) {return User.findOne({ name: name }).addCreateAt().exec()}
}
```
这里可能有点不清晰，将就看一下就好，具体请去看教程内的使用。
关于mongoose与promise的关系,经过我的查询，最终的结论是，当对mongodb操作的类型返回为Query类型时，返回的结果是遵循promise规范的，我们可以直接result.then( () => {...})，那么有哪些操作是Query类型呢？下面给出大家mongoose文档API docs中query.js下的操作都是的。mongoose文档-query.js。
Mongodb不像SQL一切的数据都是自定义的，Mongdb会默认帮你生成一个_id作为单表中的唯一识别，而 _id如果不特殊声明，那么默认类型是Object，就是说它是一个对象，而键名为 _id，所以我们直接find({ _id: xxx })就可以了，并且这里要告诉大家的是ObjectId是一个12字节的字符串，前4个字节为精确到秒的时间戳，这里大家只知道这个就可以了，后面我会用到这个，这里给大家插一张生成规则图示。

三、关于作者使用的一些中间件的用处与必要性
首先我们列出教程中所有用到过的中间件以及必要的包名，一一说明用处再进行筛选。

path (Node自身封装的路径解析模块)
express (帮助你快速创建web应用,后续中间件的依赖，必用)
express-session (基于express用于方便操纵session的中间件，要用)
connect-mongo (通常与express-session搭配使用，用处正如npm中官方所说’It could be interesting to re-use an existing connection’，主要用于将session存储于数据库中，使你得以复用现存的mongodb连接去使用数据库缓存，而减少对数据库的重复操作，降低动态网页响应时间与服务器过载，提高用户体验)
connect-flash (在session中添加了一个对象 req.session.flash = {}，后续访问简单使用req.flash()即可访问，一个用于通知的中间件)
config-lite (作者自己写的插件。。。主要用于区分生产环境、测试环境、开发环境的不同配置,默认加载目录为config目录下,生产环境 => production.js, 测试环境 => test.js, 开发环境 => default.js，这里我们可以选择不用而自己去定义)
winston 与 express-winston (用于生成日志文件)
sha1 (Node自身封装好的 sha1 加密算法模块)
fs (Node自身携带的文件系统模块)
monglass (前面说过了，作者自己写的基于mongoose的插件)
marked (markdown的包，因为评论与文章都支持markdown的形式，所以这个包用来将其转化对应的html)
objectid-to-timestamp (作者自己写的小插件，用于将ObjectId的前4个字节去除并加3个0返回时间戳= =。。。)
moment (日期格式化插件)

好了，终于大概列完了，其中作者自己写的包括congfig-lite、monglass、objectid-to-timestamp，借用大司马的老师的话来说，我这么说你们懂的吧。。。都可以不用。

接下来开始列举个人认为的一些插件的使用上的必要性(注意是个人)：

moment+objectid-to-timestamp，前面已经跟大家解释过了_id取出来后的前4个字节，就是前8个字符是精确到秒的时间戳，你自己再后面+3个0不就是精确到微秒的完整时间戳了嘛，还要我说接下来怎么做吗？
connect.flash，对象是在session中的，你自己存一个特定的对象来通知也可以，然后再render出模板文件的时候，后面第二个参数是返回的数据对象，你直接抛出去也可以，我这么说大家明白吧，不过这个插件本来就极小，你大可以别自己浪费力气了。
fs，列举出来的时候说过了吧。
marked，你不是专门写给我们这样的人用的话，你至于嘛，人家又不懂~

剩下好像没多少个包了吧，就这样吧，讲道理，该用就用，没多大，你自己封装自己写，也好不到哪去兄弟，本来就是为了快速开发，当然你自己也可以实现是前提，别搞半天，你自己都不懂就瞎用。。。

四、写到最后
最近确实有在学习一些东西，偶尔也在看《你不知道的javascript》中卷，但是确实知识比较凌乱，有很多可能工作中并不能用到，而ES6和这个博客教程我还能写出啥呢= =。。。两位作者本人都已经写的非常非常详细了（黑人脸），这篇博客教程最重要的是设计模式和思想 设计模式和思想 设计模式和思想，重要的事情要说3遍，,最后也希望大家多支持开源吧，无偿的维护不容易，如果付费就能够获取到人家长时间总结的经验，那么就值得我们付费，我也捐了10块给博客教程的作者，虽然少但也是个支持吧，也是我自身对这篇教程的肯定。

介绍一个node创建博客的教程并总结相关推荐

如何使用GitHub创建一个自己的博客并且上传
如何使用GitHub创建个人博客并且上传一.git是什么 1.1 git简介 1.2 git作用 1.3 安装Git 1.4 如何开始使用Git 1.5 Git常用命令介绍 1.5.1 初始化本地仓 ...
Windows下使用GitHub Pages搭建hexo博客详细教程以及Next主题超全配置
根据下面的教程搭建的博客见这里前言马上要进入研究生了,不能再过浑浑噩噩的日子了,搭建一个小网站,用于记录自己所学的东西.其实,之前在腾讯云1元乞丐版上也搭建过博客,但是呢,只用来扯淡了.这次使用 ...
Django 3.2.5博客开发教程:HelloWorld欢迎页面
基础配置做好了之后,我们就可以先迁移数据到数据库,然后启动我们的项目,感受Django的魅力. 在Pycharm左下角底部的Terminal,会弹出Terminal终端窗口,Pycharm自动会帮我们 ...
Django 3.2.5博客开发教程:体验django模板
上面我们有说过,用户发送请求的时候,视图会返回一个响应,响应可以是一个重定向,一个404错误,一个XML文档,一张图片或者是一个HTML内容的网页.前面几个返回的信息比较有限,我们重点更多是放在HTM ...
Django 3.2.5博客开发教程:一些常用的模板使用方法
一.django static文件的引入方式 1.在django project中创建 static文件夹 2.settings.py中配置要在 STATIC_URL = '/static/' 下边 ...
如何启动 WordPress 博客 – 简易指南 – 创建博客(2021)
您想以正确的方式创建 WordPress 博客吗?我们知道,特别是当您不是技术极客时,创建博客可能是一个复杂的想法.在帮助许多用户创建博客后,我们决定创建最全面的指南,介绍如何在没有任何技术知识的情况 ...
Hexo个人博客搭建教程
Hexo个人博客搭建教程 1 搭建前准备 1.1 环境配置需要安装git.node,最后安装hexo 1.1.1 安装Git: 首先看电脑是否已经安装了git $ git 若提示not founde ...
【效率为王】超详细 Hexo + Github Pages 博客搭建教程
前言现在市面上已经有许多博客了,比如 CSDN.掘金.博客园.简书等等.我们可以直接在上面发表内容,而且交互比较人性化,而且也能被搜索引擎检索到.但是总归是别人的平台,经常会受限,因此我们就希望能有 ...
使用github+Hexo人人都能拥有一个美美的博客
我相信很多人都想拥有一个自己的博客,把自己的一些生活感想或者学习总结写到这上面分享给大家.首先我推荐一个网站简书,无论你是否是搞技术开发工作的或者其他文艺工作者,只要你想写文章,简书无疑是一个好的写文 ...

介绍一个node创建博客的教程并总结

介绍一个node创建博客的教程并总结相关推荐

最新文章

热门文章