mongodb-rest

This project is no longer abandoned!

Thanks so much to Tom for starting this project that has been so useful. I'm planning on moving this project forward now and hopefully others are willing to help.

As Tom has said this REST server has no security and is not fit for use in production. So be warned! Security issues may or may not be addressed in the future.

I have found this REST server to be invaluable for rapid prototyping web applications. When you don't care about security and you just need to try something out without investing the time to build a proper secure REST API.

Recent updates:
mongodb-rest now works with dependencies updated to latest versions.
Added handling for mongodb errors.
Removed Jade dependency.
Can now get a list of database names.
Can now get a list of collection names for a specified database.
It is now easier to start and configure the server procedurally.
REST API output is now human readable by default.

Name

mongodb-rest - REST server for MongoDB

Description

This is a REST server for MongoDB using Node, using Express and the native node.js MongoDB driver.

Installation

Installation is via npm:

npm install mongodb-rest

You can install globally using -g:

npm install -g mongodb-rest

Now issue mongodb-rest on the command line and the server should start.

NOTE: Make sure you are running a MongoDB database in addition to the mongodb-rest server.

Test

After installation you can quickly test it by issuing the following from the command line:

curl -d '{ "A1" : 201 }' -H "Content-Type: application/json" http://localhost:3000/test/example1

This should add a document to the "test" db.example1 collection:

{
	"A1": 201,
	"_id": ObjectId("4e90e196b0c7f4687000000e")
}

Start Server Programmatically

mongodb-rest can easily be started programmatically by 'requiring' the module and calling startServer.

var mongodbRest = require('mongodb-rest');
mongodbRest.startServer();

You can optionally pass in a configuration object:

mongodbRest.startServer(config);

Configuration

When starting from the command line you should have config.json in the current working directory.

When starting the server programmatically you can pass in a Javascript object for mongodb-rest configuration.

Here is an example JSON configuration object:

{ 
	"db": {
		"port": 27017,
		"host": "localhost"
	},
	"server": {
		"port": 3000,
		"address": "0.0.0.0"
	},
	"accessControl": {
		"allowOrigin": "*",
		"allowMethods": "GET,POST,PUT,DELETE,HEAD,OPTIONS"
	}
	"humanReadableOutput": true
}

Supported REST API

Supported REST API requests:

• GET /dbs - Returns the names of all databases.
• GET /<db>/ - Returns names of all collections in the specified database.
• GET /<db>/<collection> - Returns all documents in the specified collection.
• GET /<db>/<collection>?query=%7B%22isDone%22%3A%20false%7D - Returns all documents satisfying query.
• GET /<db>/<collection>?query=%7B%22isDone%22%3A%20false%7D&limit=2&skip=2 - Ability to add options to query (limit, skip, etc)
• GET /<db>/<collection>/id - Returns document with id
• POST /<db>/<collection> - Insert new document in collection (document in POST body)
• PUT /<db>/<collection>/id - Update document with id (updated document in PUT body)
• DELETE /<db>/<collection>/id - Delete document with id

Flavors:

• Setup "sproutcore" as flavor, it will then change _id as returned by MongoDB into guid, as used by SproutCore, this allows for simpler DataSources.
• Setup "nounderscore" as flavor, it will then change _id into id.

Content Type:

• Please make sure application/json is used as Content-Type when using POST/PUT with request bodies.

Dependencies:

• Are indicated in package.json.

Testing

Integration tests use jasmine-node.

Run this command from the main folder:

jasmine-node .\ --verbose

Future

Roadmap:
https://trello.com/b/OzRxPSjO/mongodb-rest-roadmap

Credits

• MongoDB Driver
• Express
• npm

Testing:

• Jasmine-Node
• Q (for async testing)