Nodejs文件相关操作

欢迎关注我的博客我在马路边

适用人群

本文适用于刚接触Node的小白，毕竟我也是小白，大佬请绕行。

Node文件操作

在实际开发中遇到很多有关文件及文件夹的操作，比如创建、删除文件及文件夹，文件拷贝、压缩和生产word等。用到文件系统、流操作以及相关依赖等，封装了一些常用的方法可供重复使用。

常用API

具体API参考：Node.js中文网（点击前往），API对各种方法的使用介绍已经很详细，下面不过多介绍，主要写一些开发中遇到的问题以及重构方法。
在操作过程中一般会遇到同步和异步操作，一般方法以Sync结尾均为同步操作，异步一般通过回调函数或者监听来实现同步效果。

fs文件系统

文件操作是很常见的方式，下面简述同步和异步操作的方法，文件流操作需要通过管道通信来监听，具体事件可参考：监听事件。

// 引用文件系统
const fs = require('fs');
// 文件操作最长遇到的问题：同步、异步操作
// 文件读取异步操作
fs.readFile('/etc/passwd', (err, data) => {     // 回调函数
    if (err) throw err;
    console.log(data);
});
// 文件读取同步操作
fs.readFileSync('<directory>');
// 文件流操作
fs.createReadStream('sample.txt', { encoding: 'utf-8'});
fs.createWriteStream('sample.txt'), { close: false }).on('close', function(){
    // 监听close事件实现文件流传输同步操作
    ...
})
// 通过文件流将文件从A拷贝到B
fs.createReadStream('/A/sample.txt', { encoding: 'utf-8'}).pipe(fs.createWriteStream('/B/sample.txt'), { close: false }).on('close', function () {
   // 监听close事件实现文件流传输同步操作
   ...
});

officegen Office插件

导出word依赖officegen包，git地址。详细介绍了各种API的使用方式，当然这里也是异步的。

// 引入officegen
const officegen = require('officegen');

// 创建 ppt 2007 :
var pptx = officegen ( 'pptx' );
// 创建 Word 2007 :
var docx = officegen ( 'docx' );
// 创建 Excel 2007 :
var xlsx = officegen ( 'xlsx' );
// 以创建ppt为例
pptx.setDocTitle ( '<title>' );
var out = fs.createWriteStream ( 'out.pptx' );      // 流输出创建文件
pptx.generate ( out );
out.on ( 'close', function () {
  console.log ( 'Finished to create the PPTX file!' );      // 回调执行接下步骤达到同步操作
});

封装重用方法

封装了删除、创建文件夹及文件的方法，以及重复生成word文件方法。

文件操作

采用递归创建不重复名称的文件夹，filePath为文件夹路径，num为初始状态0

/**
 * 创建文件夹
 * @param {*} filePath 
 * @param {*} num 
 */
function mkDifDir(filePath, num) {
    var newFilePath = filePath;
    while (fs.existsSync(newFilePath) && fs.statSync(newFilePath).isDirectory()) {
        num++;
        newFilePath = filePath + '(' + num + ')'
    }
    fs.mkdirSync(newFilePath);
    return newFilePath;
}

// 调用方式
mkDifDir('D://abc', 0);
// 返回结果
// 如果目标目录存在abc文件夹，则创建abc(1)文件夹，返回D://abc(1)，否则直接创建abc文件夹
// 如果还存在abc(1)文件夹，则依次类推直到不重复创建出abc(n)文件夹位置并返回值

根据传入多及目录递归创建文件夹

/**
 * 创建多层目录文件
 * @param {*} dirname 
 */
function mkdirsSync(dirname) {
    if (fs.existsSync(dirname)) {
        return true;
    } else {
        if (mkdirsSync(path.dirname(dirname))) {
            fs.mkdirSync(dirname);
            return true;
        }
    }
}
// 调用方式
mkdirsSync('D://a//b//c//d//e//f');
// 返回结果
// 会在D盘下依次生成a==>b==>c==>d==>e==>f文件结构的文件夹
// 如果存在D://a//b//c//d则会在d下创建e==>f文件结构的文件夹

上述方法的进阶版，也是调用上述方法，再嵌套一层，可以直接一句目录创建出文件夹及文件

/**
 * 创建文件包含文件夹目录
 * @param {*} filePath 
 */
function createFile(filePath) {
    var dirPath = path.dirname(filePath);
    mkdirsSync(dirPath);
    if (!fs.existsSync(filePath)) {
        fs.writeFileSync(filePath, '', { // 创建文件
            encoding: 'utf-8'
        })
    }
}
// 调用方式
mkdirsSync('D://a//b//c//d//e//f//abc.txt');
// 返回结果
// 会在D盘下依次生成a==>b==>c==>d==>e==>f文件结构的文件夹，并在f文件夹下创建acb.txt
// 如果存在D://a//b//c//d则会在d下创建e==>f文件结构的文件夹，并在f文件夹下创建acb.txt

根据目录删除文件夹下的所有文件及文件夹下的内容，同样也是递归操作

/**
 * 删除url下所有的内容
 * @param {*} url 
 */
function deleteAllFiles(url) {
    var files = [];
    files = fs.readdirSync(url);
    if (files.length == 0) {
        fs.rmdirSync(url);
    }
    files.forEach(function (file, index) {
        // var curPath = url + "/" + file;
        var curPath = path.join(url, file);
        //fs.statSync同步读取文件夹文件，如果是文件夹，在重复触发函数
        if (fs.statSync(curPath).isDirectory()) { // recurse
            deleteAllFiles(curPath);
            // 是文件delete file
        } else {
            fs.unlinkSync(curPath);
        }
    });
    // 清除文件夹
    fs.rmdirSync(url);
}
// 调用方式
// 存在目录
// D--a--b--c--d--e--f--abc.txt
//          |--h--r--n--abc.txt
//          |--i--t--m--abc.txt
//          |--j--y--k--abc.txt
//          |--k--y--l--abc.txt
mkdirsSync('D://a//b//c');
// 结果只剩下D://a//b//c文件夹，内部内容全部清除。

office操作

其实上述API已经写了怎么调用和实现，并且连接内的API更加清楚，但是我们使用时常常会生成很多word每次都要重复写，所以封装了一个回调方法用来生成word，其他的可根据具体内容进行扩展。实现如下：

/**
 * 导入数据并生成word。 
 * @param {导入的数据} data 
 * @param {导出路径} outPath 
 * @param {回到函数} callback 
 */
function exportWord(data, outPath, callback) {
    var docx = officegen('docx');
    var pObj = docx.createP();
    pObj.addText(data);
    var out = fs.createWriteStream(outPath, { close: false });     // 文件写入
    out.on('error', function (err) {
        logger.info("exportWord error ! outPath : " + outPath, err);
    });
    docx.generate(out);
    out.on('close', function () {
        logger.info("exportWord success ! outPath : " + outPath);
        callback('callback');
    });
}

// 这样就不用写重复方法了，调用方式如下
exportWord('balabalabala...', 'abc.docx', function () {    // 导出word文件abc.docx，word内容balabalabala...
    exportWord('balabalabala...', 'qwe.docx', function () {    // 导出word文件qwe.docx，word内容balabalabala...
        exportWord('balabalabala...', '123.docx', function () {    // 导出word文件123.docx，word内容balabalabala...
        // 回调中继续其他操作
        ...
        });
    });
});

总结

上述内容只是常用的内容一部分，对于小白的我来说经常忘记，所以在此记录，互相学习，互相帮助。开发过程中还有其他形形色色的问题，后期再更新。

欢迎关注我的博客我在马路边