Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

Repository files navigation

排行榜 API

一支刻意做到最小的後端 API。兩個端點、一張表、六條驗證。

這是半天課用的程式。課堂上你只用 Postman,什麼都不用裝; 這份說明是給課後想自己跑起來、自己改的你。


怎麼跑

需要 Node 22 以上。 這支程式用的 node:sqlite 是 Node 22 才內建的, 舊版會直接報「找不到模組」。先確認:

node -v

然後:

npm install
node --watch server.js

開 http://localhost:3000/ping,看到 {"ok":true} 就成功了。

開起來會印一行紅字 ExperimentalWarning: SQLite is an experimental feature。 那是 Node 對 node:sqlite 的固定警告,不是錯誤,不用管。

有兩支 server,先搞清楚差別

檔案 裡面有什麼 什麼時候開
server.js **完成版。**兩個端點、六條驗證都在裡面 想直接玩、想對答案
server.start.js **空白起點。**只有 /ping 想自己從頭做一次

下面的範例都是對 server.js 跑的。 如果你開的是 server.start.js,POST /scores 會回 404 Cannot POST /scores —— 那不是壞掉,是那兩個端點還沒寫,要你自己補。


兩個端點

打什麼 做什麼 回什麼
POST /scores 檢查你送的資料,沒問題就存進資料庫 201 和那筆資料
GET /scores/top 撈前十名,排好、編號 200 和一個陣列

送一筆:

curl -s -X POST http://localhost:3000/scores \
  -H 'Content-Type: application/json' \
  -d '{"name":"阿明","score":1200}'
{"id":1,"name":"阿明","score":1200}

看排行榜:

curl -s http://localhost:3000/scores/top
[{"rank":1,"name":"小美","score":3400},
 {"rank":2,"name":"阿明","score":1200},
 {"rank":3,"name":"阿華","score":800}]

還有一個排行榜網頁,開 http://localhost:3000/ 就看得到。


六條驗證

POST /scores 的資料要通過六道檢查才存得進去。任何一道沒過就回 400。

# 檢查 沒過的回應
1 有 name 和 score 嗎 {"error":"name 和 score 都是必填"}
2 name 是文字、score 是數字嗎 {"error":"name 必須是文字,score 必須是數字"}
3 name 去掉空白後不是空的嗎 {"error":"name 不能是空白"}
4 name 不超過 16 個字嗎 {"error":"name 最多 16 個字"}
5 score 是 0 以上的整數嗎 {"error":"score 必須是 0 以上的整數"}
6 score 不超過 1000000 嗎 {"error":"score 不能超過 1000000"}

順序有意義。 先問「有沒有送」,再問「型別對不對」,最後才問「值合不合理」。 把第 3 條搬到第 1 條前面,送一筆沒有 name 的資料,程式會當掉回 500 —— 你不能對一個不存在的東西呼叫 .trim()。

400 是「你送錯了」,我擋下來了。 500 是「我壞了」,這是我的問題。 兩個都是錯,但要修的人不一樣。


檔案

檔案 是什麼
server.js 完成版,兩個端點加六條驗證。平常跑這支
server.start.js 空白起點,只有 /ping。想自己做一次就開這支
public/index.html 排行榜網頁
scores.db 資料庫,跑起來自動產生

想從頭做一次,就開 server.start.js 自己補那兩個端點,卡住再開 server.js 對答案。


清空資料

rm scores.db

然後按 Ctrl+C 把 server 關掉重開。 只刪檔案沒有用—— 跑著的程式還抓著那個已經被刪掉的檔案在讀寫,API 會繼續回舊資料。 重開才會建一個新的空資料庫。


作業(自願)

幫 POST /scores 加一條規則:同一個名字,只保留最高分。

提示:先 SELECT 查有沒有這個名字,再決定要 INSERT 還是 UPDATE。


技術選擇

選擇 理由
Express 最少行數就能跑起一支 API
node:sqlite(Node 22 內建) 不裝原生套件。原本用 better-sqlite3,在開發機上直接 segfault
唯一相依套件是 express 裝不起來的機率降到最低
不用 TypeScript 半天課,型別會變成干擾

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages