Hướng dẫn viết api đơn giản với nodejs
Chuẩn bị mỗi trường
Sử dụng postman để test restful api
Postman là một chương trình giúp bạn đóng vai 1 client để tạo restquest đến server, postman như một trình duyệt dành cho web dev. Nó hỗ trợ đầy đủ các method http như post, get, put, delete….và các tham số trong http requestĐịa chỉ để download : https://www.postman.com/downloads/Cài đặt postman không có gì đặt biệt vì rất dễ , bạn chỉ việc chạy chương trình, nhắp nút next next là xong
Sau đây là phần hướng dẫn RESTful API trong NodeJS, bạn cần chuẩn bị database, tạo folder project trước khi thực hiện nhé.
Thực hiện restful api trong nodejs
Chuẩn bị database
Tạo table tên sach như sau:
Nhập dữ liệu
Cài module express và express-generator
Nếu máy của bạn đã cài rồi thì thôi bỏ qua, còn chưa thì
- Mở command line
- Gõ lệnh npm install -g express
- Tiếp theo gõ lệnh npm -g install express-generator
Tạo project để thực tập
- Vào command line rồi chạy lệnh:
express --view=ejs RestfulTest
Bạn sẽ thấy folder RestfulTest xuất hiện các folder và file trong đó
2. Chuyển vào folder RestfulTest mới tạo và chạy các lệnh cài đặt module cần thiết
npm install npm install mysql
Tạo model kết nối db
1. Tạo folder models trong project
2. Tạo file file models/database.js
var mysql = require('mysql');
var db = mysql.createConnection({
host: 'localhost',
user: 'root',
password: '',
database: 'labnodejs'
});
db.connect(() => console.log('Da ket noi database !'));
module.exports = db;
Tạo route
1. Mở file app.js và định nghĩa route sach dẫn vào controller routes/sach
var sachRouter = require('./routes/sach');
app.use('/sach', sachRouter);
2. Tạo file routes/sach.js và code
var express = require('express');
var router = express.Router();
var db = require('./../models/database');
router.get('/', function(req, res, next) {
//chức năng trả về danh sách các record
//phương thức request: get
//lấy ra các record trong table
//trả về danh sách sách dạng json
});
router.post('/', function(req, res, next) {
//chức năng thêm mới record vào table
//phương thức request: post
//tiếp nhận dữ liệu gửi trong body request
//thực hiện chèn record mới vào table
//trả về thông báo đã chèn dạng json
});
router.get('/:id', function(req, res, next) {
//chức năng trả về chi tiết 1 record
//phương thức request: get
//tiếp nhận id của reord trong url
//lấy ra record theo id từ table
//trả về chi tiết record dạng json
});
router.put('/:id', function(req, res, next) {
//chức năng cập nhật record trong table
//phương thức request: put
//tiếp nhận dữ liệu gửi trong body request
//thực hiện cập nhật record vào table
//trả về thông báo json đã cập nhật
});
router.delete('/:id', function(req, res) {
//chức năng xóa 1 record trong table
//phương thức request: delete
//tiếp nhận id trong url
//thực hiện xóa record
//trả về thông báo json đã xóa
});
module.exports = router;
Thực hiện chức năng danh sách record
1. Trong routes/sach.js, code lại chức năng trả về danh sách các record để được như sau
router.get('/', function(req, res, next) {
let sql = SELECT id, tenSach, moTa, urlHinh FROM sach;
db.query(sql, function(err, data) {
res.json(data);
});
});
2. Test: Mở Postman để test
Trình Postman download từ https://www.postman.com/downloads/ , giúp bạn tạo các loại request khác nhau (get, post, put, delete…) đến server. Nếu bạn chưa cài thì down rồi cài vào máy nhé.
Mở chương trình postman, chọn method GET và nhập url rồi nhắp Send như hình
Thực hiện lấy chi tiết record
1. Trong routes/sach.js, code lại chức năng trả về chi tiết 1 record để được như sau
router.get('/:id', function(req, res, next) {
let id=req.params.id;
let sql = 'SELECT * FROM sach WHERE id = ?'
db.query(sql, id, (err, d) => {
res.json(d[0]);
});
});
2. Test: Mở Postman để test
Trong tool postman, chọn method GET và nhập url rồi nhắp Send như hình
Thực hiện chức năng thêm record
1. Trong routes/sach.js, code lại chức năng thêm mới record vào table để được như sau:
router.post('/', function(req, res, next) {
let data = req.body;
let sql = 'INSERT INTO sach SET ?';
db.query(sql, data, (err, d) => {
if (err) throw err;
res.json({thongbao:"Đã chèn xong sách"});
});
});
2. Test: Mở Postman để test
Trong tool postman, chọn method POST và nhập url rồi nhắp Send như hình
Thực hiện chức năng cập nhật record
1. Trong routes/sach.js, code lại chức năng cập nhật record trong table để được như sau:
router.put('/:id', function(req, res, next) {
let data = req.body;
let id = req.params.id;
let sql = 'UPDATE sach SET ? WHERE id = ?';
db.query(sql, [data, id], (err, d) => {
if (err) throw err;
res.json({thongbao: 'Đã cập nhật sách'});
});
});
2. Test: Mở Postman để test
Trong tool postman, chọn method PUT và nhập url rồi nhắp Send như hình
Thực hiện chức năng xóa record
1. Trong routes/sach.js, code lại chức năng xóa record trong table để được như sau:
router.delete('/:id', function(req, res) {
let id = req.params.id;
let sql = 'DELETE FROM sach WHERE id = ?'
db.query(sql, id , (err, d) => {
if (err) throw err;
res.json({thongbao: 'Đã xóa thành công'});
});
});
2. Test: Mở Postman để test
Trong tool postman, chọn method DELETE và nhập url rồi nhắp Send như hình
Như vậy là hoàn thành các chức năng cơ bản về api nodejs