node-express-mongodb
This project allows you to create a powerful REST API in a very short time. It relies on
Last updated 4 months ago by pabloibanez .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install node-express-mongodb 
SYNC missed versions from official npm registry.

NODE-EXPRESS-MONGODB.API

This project allows you to create a powerful REST API in a very short time. It relies on

NodeJS | Express | MongoDB | Mongoose | PassportJS

npm npm npm

GitHub forks GitHub stars

Table of Contents

Instalation

npm install node-express-mongodb --save

Usage

Once express application is created we need to instantiate node-express-mongodb:

require('node-express-mongodb')(app, options, passport);

Options

Key Description
APP_NAME Name of the application
MONGODB_URI MongoDB database URI
HOST Host url. Only for Postman purposes (optional)
PORT Port number. Only for Postman purposes (optional)
MODELS_PATH Path where the models are located. Default: ./app/models (optional)
DATA_PATH Path where data for generation is located. Default: ./app/data (optional)

Models

The way it generates the API is by reading each of the model definitions at models path. We need to create one definition for each of the models in our app. This needs to be a json similar to the one below:

{
    "name": "BasicExample",
    "route": "basicexample",
    "properties": {
        "property1": {
            "type": "String"
        },
        "property2": {
            "type": "String",
            "methodsNotAllowed": {
                "update": true
            }
        },
        "property3": {
            "type": "Number",
            "methodsNotAllowed": {
                "add": true
            }
        }
    },
    "methods": {
        "getAll": { "enabled": true },
        "get": { "enabled": true, "passportStrategy": "admin" },
        "add": { "enabled": true },
        "update": { "enabled": true },
        "remove": { "enabled": true }
    }
}

Once the app is started it generates all the routes based on them.

Default routes

There are 5 default routes. These are created if they are activated in the model.

Route Description
GET api/[modelRoute] Returns all the documents
GET api/[modelRoute]/:id Returns one document
POST api/[modelRoute] Creates one document
PUT api/[modelRoute]/:id Updates one document
DELETE api/[modelRoute]/:id Remove one document

Custom routes

It is possible to create custom routes. For this you have to add a route file to ./app/routes and the service to use to ./app/services. Both files must be named as the route in modeldefinition.

Authentication

It is possible to add authentication to the routes by PassportJS. The way to do this is by defining the passportStrategyin the method object:

"methods": {"get": { "enabled": true, "passportStrategy": "admin" }}

[!] Note that in this case admin strategy would need to be defined in passport.js

Data generation

It is possible to auto generate data in the DB for dev purposes by just adding a collection to a json file named as the model in ./generation/data.

In order to run this task an extra endpoint is set up. /api/admin/generate.

Postman project generation

A Postman configuration object is generated by default so it can be easily imporated in Postman to get the collection of all endpoints in the app.

All you have to do in Postman is

Import > Import From Link and copying the follow app endpoint:

/api/postman

License

MIT

Current Tags

  • 1.1.5                                ...           latest (4 months ago)

36 Versions

  • 1.1.5                                ...           4 months ago
  • 1.1.4                                ...           5 months ago
  • 1.1.3                                ...           5 months ago
  • 1.1.2                                ...           5 months ago
  • 1.1.1                                ...           5 months ago
  • 1.1.0                                ...           5 months ago
  • 1.0.29                                ...           6 months ago
  • 1.0.28                                ...           6 months ago
  • 1.0.27                                ...           6 months ago
  • 1.0.26                                ...           6 months ago
  • 1.0.25                                ...           9 months ago
  • 1.0.24                                ...           a year ago
  • 1.0.23                                ...           a year ago
  • 1.0.22                                ...           a year ago
  • 1.0.21                                ...           a year ago
  • 1.0.20                                ...           2 years ago
  • 1.0.19                                ...           2 years ago
  • 1.0.18                                ...           2 years ago
  • 1.0.17                                ...           2 years ago
  • 1.0.16                                ...           2 years ago
  • 1.0.15                                ...           2 years ago
  • 1.0.14                                ...           2 years ago
  • 1.0.13                                ...           2 years ago
  • 1.0.12                                ...           2 years ago
  • 1.0.11                                ...           2 years ago
  • 1.0.10                                ...           2 years ago
  • 1.0.9                                ...           2 years ago
  • 1.0.8                                ...           2 years ago
  • 1.0.7                                ...           2 years ago
  • 1.0.6                                ...           2 years ago
  • 1.0.5                                ...           2 years ago
  • 1.0.4                                ...           2 years ago
  • 1.0.3                                ...           2 years ago
  • 1.0.2                                ...           2 years ago
  • 1.0.1                                ...           2 years ago
  • 1.0.0                                ...           2 years ago
Maintainers (1)
Downloads
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 0
Last Month 19
Dependencies (12)
Dev Dependencies (6)
Dependents (0)
None

Copyright 2014 - 2016 © taobao.org |