作者:柠檬????不酸(作者授权转载)
链接:https://juejin.im/post/6858866879339954189
在掘金白嫖了这么久,总觉得得有个产出,否则白嫖的怪不好意思的????看到网上各种各样的附件上传,觉得对于入门的人可能有些难度,今天就带来了关于Node+Mongodb的附件上传下载方面的文章。该项目比较简单,所以目录简单的一批,各位学到的可以快速搭建一个小网盘图床啥的。感谢掘金各位大大的文章让我升职加薪了????
首先我们得先去了解一下????Mongodb的文件储存(GridFS)是啥,因为我们都是基于 GridFS 来进行文件储存
了解了大概概念后就可以着手安装我们必须的插件了
????express (这是啥不用我多说)
????body-parser (Node解析body的中间件)
????ejs (模板引擎,快速开发就不搞前后端分离了,有兴趣的小伙伴可以用Vue/React来搭建小网盘)
????gridfs-stream (轻松地与MongoDB GridFS之间传输文件。)
????method-override (我们用form表单简单上传,因为form表单不支持put/delete请求方式,所以把它安排上了,小伙伴可自行使用Ajax,就不需要这么麻烦了)
????mongoose (用于连接mongodb必不可少的插件)
????multer (Multer是用于处理多部分/表单数据的node.js中间件,主要用于上传文件。它被编写在busboy之上,以实现最大效率。)
????multer-gridfs-storage (Multer的GridFS存储引擎可将上传的文件直接存储到MongoDb。)
????nodemon (热更新)
以上就是我们需要准备的东西了
// 懒人复制区域
npm install express body-parser ejs gridfs-stream method-override mongoose multer multer-gridfs-storage
// or
yarn add express body-parser ejs gridfs-stream method-override mongoose multer multer-gridfs-storage
复制代码
// 可自行补充信息
// npm init
复制代码
然后在根目录新建一个入口文件 app.js,和页面 views/index.ejs
将我们安装的包引入,再跑跑看看
const express = require('express')
const path = require('path')
const crypto = require('crypto')
const mongoose = require('mongoose')
const multer = require('multer')
const GridFsStorage = require('multer-gridfs-storage')
const GridFsStream = require('gridfs-stream')
const methodOverride = require('method-override')
const bodyParser = require('body-parser')
const app = express()
app.set('view engine', 'ejs') // 设置模板引擎
app.use(bodyParser.json())
app.use(methodOverride('_method'))
app.get('/', (req, res) => {
res.render('index')
})
})
const port = 5000
app.listen(port, () => {
console.log(`App listering on port ${port}`)
})
复制代码
一般来说启动了app.js的话我们在浏览器访问 http://localhost:5000 就能看到 views/index.ejs 中的界面了,如果没有,自行查看控制台是否报错
我这边用的本地mongodb数据库,线上也是一样的,我们可以用 NoSQL manager for mongdb 来查看我们数据库里面的数据,我们新建一个新的集合,我这边叫 grid_uploads。所以连接的话也是连接这个集合
// 数据库的链接
const mongoURL = 'mongodb://localhost:27017/grid_uploads'
const connect = mongoose.createConnection(mongoURL, {
useNewUrlParser: true,
useUnifiedTopology: true
})
复制代码
可以尝试在NoSQL写入一些数据,具体使用可以参考博客????【MongoDB】NoSQL Manager for MongoDB 教程
作为一个小两年的前端工程师,已经练就了像素眼了,我们肯定不能把界面做的辣么丑对吧,眼睛过不去啊,所以我们简单的用bootstrap4来做个界面好了
文件上传
Mongo文件上传
复制代码
那么我们请求 http://localhost:5000 的话我们看到的应该是这样子的
// 定义gfs变量,后续我们进行数据库文件操作的时候可不能少
let gfs;
connect.once('open', () => {
// 监听数据库开启,通过 gridfs-stream 中间件和数据库进行文件的出入控制
gfs = GridFsStream(connect.db, mongoose.mongo)
gfs.collection('upload')
// 它会在我们数据库中建立 upload.files(记录文件信息) upload.chunks(存储文件块)
})
// 使用 multer-gridfs-storage Multer 中间件来讲我们上传的附件直接存储到MongoDb
const storage = new GridFsStorage({
url: mongoURL,
file: (req, file) => {
return new Promise((resolve, reject) => {
// 下面注释部分是给文件进行重命名的,如果想要原文件名称可以自行使用 file.originalname 返回,
// 建议有时间的小伙伴存储两个文档,一个记录原文件名,一个记录加密文件名,然后返回到页面的时候可以将中文名返回去
// crypto.randomBytes(16, (err, buf) => {
// if (err) {
// return reject(err)
// }
// const filename = buf.toString('hex') + path.extname(file.originalname)
// const fileinfo = {
// filename,
// bucketName: 'upload'
// }
// resolve(fileinfo)
// })
const fileinfo = {
filename: new Date() + '-' + file.originalname,
bucketName: 'upload'
}
resolve(fileinfo)
})
}
})
const upload = multer({ storage })
复制代码
app.post('/upload', upload.single('file'), (req, res) => {
res.redirect('/')
})
复制代码
看起来简简单单,请记着这么几件事
在views/index.ejs中 (input type=file 指定的name得和接口的 upload.single('file') 一样
上传完文件我们重定向回我们的首页 此时我们就可以在NoSql看到我们的两个文档有数据了
这是upload.chunks
这是upload.files
获取我们所有的文件
app.get('/files', (req, res) => {
// 通过查找返回一个数组对象回去
gfs.files.find().toArray((err, files) => {
if (!files || files.length === 0) {
return res.status(404).json({
err: '文件不存在!'
})
}
return res.json(files)
})
})
复制代码
我们可以进行一些美化操作,比如我们可以将上传是图片的,返回到界面的话以图片显示,其他则以 a 标签的格式显示(可点击下载),所以我们可以将 views/index.ejs的界面进行美化改造(ejs语法用起来确实蛮麻烦的),进行重新排版以及添加删除按钮
文件上传
Mongo文件上传
<% if(files){ %>
<% files.forEach(function(file){ %>
<% if(file.isImage){ %>
" />
<% } else { %>
"><%= file.filename %>
<%}%>
<% }) %>
<% }else { %>
文件不存在
<% } %>
复制代码
要将 ejs 中的files变量获取到我们应该重写一下 get('/')接口,使其在访问localhost:5000的时候先去读取一下数据库文件信息并输出到页面中去
app.get('/', (req, res) => {
gfs.files.find().toArray((err, files) => {
if (!files || files.length === 0) {
res.render('index', { files: false })
return
}
files.map(file => {
// 如果是以下图片类型我们就在前端展示出来,其余一律按附件处理,通过 isImage 来区分图片和非图片
const imageType = ['image/png', 'image/jpg', 'image/gif', 'image/jpeg']
if (imageType.includes(file.contentType)) {
file.isImage = true
} else {
file.isImage = false
}
})
res.render('index', { files: files })
})
})
复制代码
完成上述的情况我们访问首页的话就行该是如下情况
在这里我们通过a标签访问 /download/:filename 接口,filename是文件名,当然可以用其他的比如_id,当查找到有该附件的时候就将它合并成可读留,通过管道返回,这样在前端界面上点击文件标题就可以直接下载了
app.get('/download/:filename', (req, res) => {
gfs.files.findOne({ filename: req.params.filename }, (err, file) => {
if (!file) {
return res.status(404).json({
err: '文件不存在!'
})
}
const readstream = gfs.createReadStream(file.filename)
readstream.pipe(res)
})
})
复制代码
在这里我们通过a标签访问 /files/:id 接口,id对应,点击删除按钮,就直接删除了,并重定向到首页
app.delete('/files/:id', (req, res) => {
gfs.remove({ _id: req.params.id, root: 'upload' }, (err) => {
if (err) {
return res.status(404).json({
err: '删除的文件不存在!'
})
}
res.redirect('/')
})
})
复制代码
由于我们一直用form做请求,但是form表单没有delete请求方式,所以我们用到了method-override插件,当然要是用Ajax就没关系了,我们项目毕竟速成嘛,主要看效果和过程
简简单单的告一段落了,学了的小伙伴们可以尝试更加深入的操作,所以我们就可以用此项目来做一个图床或者小网盘盘,还是简简单单滴。当然该附件上传也有一定的限制问题,比如大文件可能上传时间更久,我们就需要采用文件分片方式上传了,可以看掘金的????文件分片的案例。
最后感谢各位小伙伴的品尝,如有新的好玩的东西,我再来分享一下
????项目地址(https://gitee.com/caohuiboss/girdfs_uploads)
????在线体验地址 本人的土豆服务器,各位小伙伴不要下手太狠哈????,体验体验就好
读一本好书,就是在和高尚的人谈话。——歌德(我真说过)
公众号二条对应了 Node.js 文件相关 api 讲解,一起学习,效果更佳,美滋滋。
最后
1.看到这里了就点个在看支持下吧,你的「在看」是我创作的动力。
2.关注公众号程序员成长指北
,「带你一起学Node」!
3.添加微信【ikoala520】,拉你进技术交流群一起学习。
“在看转发”是最大的支持