Giter Club home page Giter Club logo

serve-gridfs's Introduction

serve-gridfs

Middleware to serve static files using mongodb gridfs

Based on serve-static

Tested on node 10.x, npm 6.x

Require node-mongodb-native 3.x

Install

$ npm i serve-gridfs

API

import serveGridfs from 'serve-gridfs'

serveGridfs(mongoConnection, { options })

Create a new middleware function to serve files from a mongodb gridfs collection. The file to be served is based on req.url. In a default setting, when a file is not found, this middleware call next(), instead of returning 404, to be in line with the express serve-static middleware.

mongoConnection

Internally, this middleware use promised based mongo client, so pass in the connection detail here.

const mongoConnection = MongoClient.connect('mongodb://localhost:27017/myApp')

Options

All options are optional

Key Type Default Note
bucketName string 'fs' Default set by mongodb
chunkSizeBytes number 261120 255 * 1024
writeConcern object null
readPreference object null
byId bool true The file sepecified in req.url by default is the mongodb _id, if set to false, mongodb will look for filename instead of _id, see example below. When multiple files have the same filename, by default, the latest file will be served
acceptRanges bool true Setting to false will not send Accept-Ranges and ignore the contents of the Range request header
cacheControl bool or string true Setting to false will disable the Cache-Control in a response header. The default is public, max-age=0. You can set this to any string, which will also overide the maxAge key below.
maxAge number 0 Set this to whatever you like in seconds
etag bool true md5 generated by mongodb gridfs
lastModified bool true
fallthrough bool true By default, when the file specified in req.url cannot be found in mongodb gridfs collection, a next() will be called without an error. If set to false, a next(new Error('FileNotFound)) will be called. Also, setting to false will throw a 405 http status code if req.method is not GET or HEAD
setHeaders function null signature function (res, path, stat) {}. path is the requested file path, the stat is the stat of the file if present, produced by mongodb fs.files, typically, it is { _id, length, chuckSize, uploadDate, md5, filename }, see uploadStream

Example

// with express js

import express from 'express'
import { MongoClient, GridFSBucket } from 'mongodb'
import serveGridfs from 'serve-gridfs'

const app = express()
const mongoConnection = MongoClient.connect('mongodb://localhost:27017/myApp')

app.use('/uploads', serveGridfs(mongoConnection))
app.use('/uploads_byname', serveGridfs(mongoConnection, { byId: false }))

const options = {
  bucketName: 'somethingElse',
  setHeaders(res, path, stat) {
    if (stat && stat.contentType === 'application/pdf' && stat.length > 102400000) res.setHeader('Content-Disposition', 'attachment; filename = ' + path)
  }
}
app.use('/uploads2', serveGridfs(mongoConnection, { bucketName: 'somethingElse' }))

Retriving a file

# Assuming there is a file with an _id of 001 and a filename of cat.png in mongodb gridfs collection, the following commands will retrieve the same file

$ curl http://localhost:3000/uploads/001
$ curl http://localhost:3000/uploads_byname/cat.png

Notes

  • Due to gridfs configuration, you can have an _id or filename containing slash, such as cat/001 or cat/tom.png as an _id and filename respectively. In this case, curl http://localhost:3000/uploads/cat/001 and curl http://localhost:3000/uploads_byname/cat/tom.png will resolve to the same file.

serve-gridfs's People

Contributors

aunz avatar

Stargazers

 avatar  avatar  avatar

Watchers

 avatar  avatar

Forkers

borischumichev

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.