แนวทางสร้าง RESTful API ด้วย Express เบื้องต้น

const users = [
    {
        "id":1,
        "name":"John Doe",
        "email":"john.doe@gmail.com"
    },
    {
        "id":2,
        "name":"William Smith",
        "email":"will.smith@gmail.com"
    },
    {
        "id":3,
        "name":"Jennifer Lee",
        "email":"jennifer.lee@gmail.com"
    }        
]
module.exports = users  // ส่งออกข้อมูลไปใช้ยัง module อื่นๆ

// แสดงรายการทั้งหมด
app.get('/api/users', (req, res) => {
    res.send('GET Request all')
})

// เพิ่มรายการใหม่ เข้าไปในรายการทั้งหมด
app.post('/api/users', (req, res) => {
    res.send('POST Request')
})

// แสดงรายการตามค่า id ที่ต้องการ
app.get('/api/user/:id', (req, res) => {
    res.send('GET Request for any ID')
})

// อัพเดทรายการตามค่า id ที่ต้องการ
app.put('/api/user/:id', (req, res) => {
    res.send('PUT Request for any ID')
})

// ลบรายการตามค่า id ที่ต้องการ
app.delete('/api/user/:id', (req, res) => {
    res.send('DELETE Request for any ID')
})

app.route('/api/users')
    .get((req, res) => {
        res.send('GET Request all')
    })
    .post((req, res) => {
        res.send('POST Request')
    })

app.route('/api/user/:id')
    .get((req, res) => {
        res.send('GET Request for any ID')
    })
    .put((req, res) => {
        res.send('PUT Request for any ID')
    })
    .delete((req, res) => {
        res.send('DELETE Request for any ID')
    })

    res.status([status code]).json([json string object])
    // ตัวอย่าง res.status(400).json({"status":400,"message":"Not found user with the given ID"})

    res.json([json string object])
    // ตัวอย่าง 
    // const result = {
    //     "status":200,
    //     "data":user
    // }
    // res.json(result)	  

{
	"status":400, 
	"message":"Not found user with the given ID"
}

{
    "status": 200,
    "data": {
        "id": 1,
        "name": "John Doe",
        "email": "john.doe@gmail.com"
    }
}

const express = require('express')
const router = express.Router()
const users = require('../mock-users') // ใช้งานข้อมูลจำลองจากไฟล์ mock-users.js

// กำหนด route แบบ chain 
router.route('/users?')
    .get((req, res, next) => { // GET มาที่ path: "/users" หรือ "/user"
        // ส่งข้อมูลทั้งหมด กลับออกไปแสดง
        const result = { // รูปแบบผลลัพธ์ข้อมูลที่จะส่งกลับ
            "status":200,
            "data":users
        }
        return res.json(result)  
    })
    .post((req, res, next) => {// POST มาที่ path: "/users" หรือ "/user"
        let user = {
            "id":users.length+1, // เพิ่ม id จากค่าเดิมไปอีก 1
            "name":req.body.name, // ใช้ค่า name จากที่ส่งเข้ามา
            "email":req.body.email // ใช้ค่า email จากที่ส่งเข้ามา
        }
        users.push(user) // เพิ่มข้อมูลใหม่เข้าไปใน array users
       const result = { // รูปแบบผลลัพธ์ข้อมูลที่จะส่งกลับ
            "status":200,
            "data":users
        }
        return res.json(result)  
    })    

// กำหนด route แบบ chain และมี id params เพิ่มเข้ามา    
router.route('/user/:id')
    .all((req, res, next) => {// ทุกๆ Request มาที่ "/user/:id"
        // หาว่า ใน users มี user.id ที่ตรงกับ params.id หรือไม่ ถ้ามี ก็เก็บ user นั้นๆ
        let user = users.find( (user) => user.id === parseInt(req.params.id))
        // ถ้าไม่มี ก็ส่งสถานะ 400 และข้อความกลับออกไป
        if(!user) return res.status(400).json({"status":400,"message":"Not found user with the given ID"})
        res.user = user // กรณีข้อมูล user ส่งต่อไปยังฟังก์ชั่นถัดไป
        next()
    })
    .get((req, res, next) => {// GET มาที่ path: "/user/:id" ใดๆ
        // ส่งข้อมูล user ที่หาเจอ และได้มาจากฟังก์ชั่นก่อนหน้า ส่งออกไป
        const result = {
            "status":200,
            "data":res.user
        }
        return res.json(result)
    })
    .put((req, res, next) => {// PUT มาที่ path: "/user/:id" ใดๆ
        let user = { // กำหนดข้อมูลที่จะอัพเดท
            "id":res.user.id, // อัพเดท id mี่ตรงกับค่า params.id
            "name":req.body.name, // ใช้ข้อมูลใหม่ที่ส่งเข้ามาสำหรับ name
            "email":req.body.email // ใช้ข้อมูลใหม่ที่ส่งเข้ามาสำหรับ email
        }
        // ส่งข้อมูลที่ได้อัพเดทเรียบร้อยแล้ว กลับออกไป
        const result = {
            "status":200,
            "data":user
        }
        return res.json(result)        
    })
    .delete((req, res, next) => {// DELETE มาที่ path: "/user/:id" ใดๆ
        // จำลองการลบข้อมูล ในที่นี้ ให้แสดงเฉพาะข้อมูลที่เหลืออยู่ หรือก็คือ ข้อมูลที่ไม่่ตรงกับ params.id ที่ส่งมา
        let user = users.filter( (user) => user.id !== parseInt(req.params.id))
        const result = {
            "status":200,
            "data":user
        }
        return res.json(result)
    })            

module.exports = router

const express = require('express')  // ใช้งาน module express
const app = express()  // สร้างตัวแปร app เป็น instance ของ express
const path = require('path') // เรียกใช้งาน path module
const createError = require('http-errors') // เรียกใช้งาน http-errors module
const port = 3000  // port 
 
// ส่วนของการใช้งาน router module ต่างๆ 
const indexRouter = require('./routes/index')
const userRouter = require('./routes/users')
 
// view engine setup
app.set('views', path.join(__dirname, 'views'));
app.set('view engine', 'ejs');
app.set('view options', {delimiter: '?'});
// app.set('env','production')
 
app.use(express.json())
app.use(express.urlencoded({ extended: false }))
app.use(express.static(path.join(__dirname, 'public')))
 
// เรียกใช้งาน indexRouter
app.use('/', indexRouter)
app.use('/api', userRouter) 

// ทำงานทุก request ที่เข้ามา 
app.use(function(req, res, next) {
    var err = createError(404)
    next(err)
})
 
// ส่วนจัดการ error
app.use(function (err, req, res, next) {
    // กำหนด response local variables 
    res.locals.message = err.message
    res.locals.error = req.app.get('env') === 'development' ? err : {}
 
    // กำหนด status และ render หน้า error page
    res.status(err.status || 500) // ถ้ามี status หรือถ้าไม่มีใช้เป็น 500
    res.render('error') 
})
 
app.listen(port, function() {
    console.log(`Example app listening on port ${port}!`)
})