# 统一错误处理中间件(来自server/middlewares/errorHandle)
// use: 统一错误处理中间件，用来统一捕获其他中间件的错误,在其他中间件使用之前使用 
const tracer = require('tracer'); //使用tracer模块帮助我们自定义打印输出
const fs = require('fs');
const logger = tracer.colorConsole({ //自定义错误输出格式
    level: 'error',
    format: "{{timestamp}} <{{title}}> {{message}} (in {{file}}:{{line}})",
	dateformat: "HH:MM:ss.L",
    transport: function(data){  //指定错误输出的文件，存到error.log下
        console.log(data.output);  
        fs.appendFile('./error.log', data.output + '\n', { encoding: 'utf8'}, (err) => {
            if(err){
                throw err;
            };
        });
    }
});
//该中间件关键点：1.位置，2.一上来就先走其他中间件（需理解官网的洋葱图）
module.exports = async (ctx, next) => {
    try{
        await next(); //一上面直接先执行下面的中间件
    }catch(err){
         //.stack为error对象的属性，返回错误或异常的代码跟踪信息
         //打印出来,并将错误继续向上抛出，如果只打印不继续抛出，相当于控制器抛出的错误在这里就停了, 也可以对错误进行一些操作后再输出
        logger.error(err.stack);
        throw(err); 
    }
};

# 逻辑层（来自server/controllers/article.js）
const Article = require('../models/article.js');
class ArticleController{
    //创建文章
    static async createArticle(ctx, next){...}
    //发布文章
    static async ifPublishArticle(ctx){...}
    //删除文章
    static async deleteArticleById(ctx){...}
    //修改文章
    static async modifyArticle(ctx){...}
    //获取所有文章
    static async getAllArticles(ctx){...}
    //获取所以已发布的文章
    static async getAllPublishedArticles(ctx){...}
}
exports = module.exports = ArticleController;

# 接口层(来自server/routes/index.js)
//引入class这个类
const A = require('../controllers/article.js');
router
    .get('/articles/:id', A.getArticleById)                      
    .post('/articles', checkToken, A.createArticle)                         
    .delete('/articles/:id', checkToken, A.deleteArticleById)                 
    .patch('/articles/:id', checkToken, A.modifyArticle)                      
    .get('/allArticles', checkToken, A.getAllArticles)                      
    .get('/articles', A.getAllPublishedArticles)                      
    .patch('/pubArticles/:id', checkToken, A.ifPublishArticle)               
    .post('/tags', checkToken, T.createTag)                                  
    .get('/tags', T.getAllTags)                                    
    .patch('/tags/:id', checkToken, T.modifyTag)                              
    .delete('/tags/:id', checkToken, T.deleteTag)       

# 实例(来自server/routes/index.js)
router
    //修改单个标签
    .patch('/tags/:id', checkToken, T.modifyTag)
    //删除单个标签
    .delete('/tags/:id', checkToken, T.deleteTag)                           

// use: 用来给所有请求统一响应--统一响应中间件---要在使用其他中间件之前使用
//在ctx对象上挂载方法，如果在调用的是有些参数没有出入，那么相当这个参数不存在，除非采用默认值的方式
module.exports = async (ctx, next) => {
    //请求成功时
    ctx.success = ({ data, msg, total, success}) => {
        ctx.body = { code: 200, data, msg, total, success };
    };
    await next();
};

# 时期格式化处理
const moment = require('moment');
moment.locale('zh-cn');
//必须先set后get
articleSchema.set('toJSON', { getters: true, virtuals: true });
articleSchema.set('toObject', { getters: true, virtuals: true });
articleSchema.path('createTime').get(function(v) {
  return moment(v).format('YYYY MMMM Do, h:mm:ss a');
});
articleSchema.path('lastEditTime').get(function(v) {
  return moment(v).format('YYYY MMMM Do, h:mm:ss a');
});

const articleSchema = new Schema({
    .....
    tags: [{ type: Schema.Types.ObjectId, ref: 'tag' }]  //type为tag文档的id
});

result = await Article
                .find({})
                .populate('tags')
                .exec()

 let page = +ctx.query.page;
let limit = +ctx.query.limit || 5;
result = await Article
                .find()
                .sort({ 'createTime': -1 })
                .skip(limit * (page - 1))
                .limit(limit)
                .populate('tags')
                .exec()
                .catch(err => {
                    ctx.throw(500, '服务器内部错误-分页查找错误!');
                });

# 可以在configs目录下新建private.js来配置。对象格式要一致。
let config = {
   admin: {
       username: 'admin',           
       password: 'admin'
   },
   jwt: {
       secret: 'secret',            
       exprisesIn: '3600s'          //以秒为单位
   },
   mongodb: {
       host: '127.0.0.1',
       database: 'blog',
       port: 27017,
       user: '',                    //非必填
       password: ''                 //非必填
   },
   app: {
       port: process.env.PORT || 3000,
       routerBaseApi: '/api'
   }
};