Создание RESTful API с помощью Express 4

 var mongoose=require('mongoose'); var Schema=mongoose.Schema; var movieSchema = new Schema({ title: String, releaseYear: String, director: String, genre: String }); module.exports = mongoose.model('Movie', movieSchema); 

В предыдущем фрагменте мы создали новую модель Movie . С каждым фильмом связаны четыре свойства: название, год выпуска, режиссер и жанр. Наконец, мы помещаем модель в module.exports чтобы получить к ней доступ извне.

Создание маршрутов

Все наши маршруты идут в routes/movies.js . Для начала добавьте следующее в файл movies.js :

 var Movie = require('../models/movie'); var express = require('express'); var router = express.Router(); 

В Express 4 появился новый метод с именем express.Router() который дает нам новый экземпляр router . Может использоваться для определения промежуточного программного обеспечения и маршрутов. Интересным моментом в router Express является то, что он похож на мини-приложение. Вы можете определить промежуточное ПО и маршруты с помощью этого маршрутизатора, а затем просто использовать его в своем основном приложении, как любое другое промежуточное ПО, вызвав app.use() .

Получение всех фильмов

Когда пользователи отправляют запрос GET в /api/movies , мы должны отправить им ответ, содержащий все фильмы. Вот фрагмент, который создает маршрут для этого.

 router.route('/movies').get(function(req, res) { Movie.find(function(err, movies) { if (err) { return res.send(err); } res.json(movies); }); }); 

router.route() возвращает один экземпляр маршрута, который можно использовать для настройки одного или нескольких HTTP-глаголов. Здесь мы хотим поддержать запрос GET . Итак, мы вызываем get() и передаем обратный вызов, который будет вызываться при поступлении запроса. Внутри обратного вызова мы извлекаем все фильмы с помощью Mongoose и отправляем их обратно клиенту в формате JSON.

Создание нового фильма

Наш API должен создать новый фильм в базе данных при выполнении запроса POST к /api/movies . Строка JSON должна быть отправлена ​​как тело запроса. Мы будем использовать тот же маршрут, /movies , но вместо get() использовать метод post() get() .

Вот код:

 router.route('/movies').post(function(req, res) { var movie = new Movie(req.body); movie.save(function(err) { if (err) { return res.send(err); } res.send({ message: 'Movie Added' }); }); }); 

Здесь мы создаем новый экземпляр Movie из тела запроса. Здесь используется body-parser . Затем мы просто сохраняем новый фильм и отправляем ответ, указывающий, что операция прошла успешно.

Обратите внимание, что методы get() , post() и т. Д. Возвращают один и тот же экземпляр route . Таким образом, вы можете фактически связать два предыдущих вызова, как показано ниже.

 router.route('/movies') .get(function(req, res) { Movie.find(function(err, movies) { if (err) { return res.send(err); } res.json(movies); }); }) .post(function(req, res) { var movie = new Movie(req.body); movie.save(function(err) { if (err) { return res.send(err); } res.send({ message: 'Movie Added' }); }); }); 

Обновление фильма

Если пользователи хотят обновить фильм, им нужно отправить запрос PUT в /api/movies/:id со строкой JSON в качестве тела запроса. Мы используем именованный параметр :id для доступа к существующему фильму. Поскольку мы используем MongoDB, все наши фильмы имеют уникальный идентификатор _id . Итак, нам просто нужно получить параметр :id и использовать его для поиска конкретного фильма. Код для этого показан ниже.

 router.route('/movies/:id').put(function(req,res){ Movie.findOne({ _id: req.params.id }, function(err, movie) { if (err) { return res.send(err); } for (prop in req.body) { movie[prop] = req.body[prop]; } // save the movie movie.save(function(err) { if (err) { return res.send(err); } res.json({ message: 'Movie updated!' }); }); }); }); 

Здесь мы создаем новый маршрут /movies/:id и используем метод put() . Вызов Movie.findOne({ _id: req.params.id }) используется для поиска фильма, id которого передается в URL. Когда у нас есть экземпляр movie , мы обновляем его на основе JSON, переданного в теле запроса. Наконец, мы сохраняем этот movie и отправляем ответ клиенту.

Получение фильма

Чтобы прочитать отдельный фильм, пользователям необходимо отправить запрос GET по маршруту /api/movies/:id . Мы будем использовать тот же маршрут, что и выше, но на этот раз используем get() .

 router.route('/movies/:id').get(function(req, res) { Movie.findOne({ _id: req.params.id}, function(err, movie) { if (err) { return res.send(err); } res.json(movie); }); }); 

Остальная часть кода довольно проста. Мы извлекаем фильм на основе переданного id и отправляем его пользователю.

 router.route('/movies/:id').delete(function(req, res) { Movie.remove({ _id: req.params.id }, function(err, movie) { if (err) { return res.send(err); } res.json({ message: 'Successfully deleted' }); }); }); 

 module.exports = router; 

 var express = require('express'); var bodyParser = require('body-parser'); var mongoose = require('mongoose'); var movies = require('./routes/movies'); //routes are defined here var app = express(); //Create the Express app 

 //connect to our database //Ideally you will obtain DB details from a config file var dbName = 'movieDB'; var connectionString = 'mongodb://localhost:27017/' + dbName; mongoose.connect(connectionString); 

 //configure body-parser app.use(bodyParser.json()); app.use(bodyParser.urlencoded()); app.use('/api', movies); //This is our route middleware module.exports = app; 

 var app = require('../app'); //Require our app app.set('port', process.env.PORT || 8000); var server = app.listen(app.get('port'), function() { console.log('Express server listening on port ' + server.address().port); });