Bài này hoàn thiện API thêm, đọc, sửa, xóa sinh viên với SQLModel, tách model tạo/sửa/đọc, phân trang và tìm kiếm.

55 phútTrung cấp
Bạn sẽ học được
  • Tách model Tạo, Cập nhật, Đọc
  • Thêm, đọc, sửa một phần, xóa
  • Phân trang, tìm kiếm
  • Mã trạng thái chuẩn

Cơ sở lý thuyết

CRUD ánh xạ tự nhiên sang REST: Create ↔ POST, Read ↔ GET, Update ↔ PUT/PATCH, Delete ↔ DELETE. PUT thay thế toàn bộ tài nguyên (phải gửi đủ trường); PATCH cập nhật một phần (chỉ gửi trường cần đổi).

  • exclude_unset: chỉ lấy các trường máy khách thực sự gửi, phân biệt "không gửi" với "gửi giá trị null" – điều cốt lõi để cài PATCH đúng.
  • Idempotent: gọi PUT, DELETE nhiều lần cho cùng kết quả như gọi một lần; POST thì không (tạo nhiều bản ghi).
  • Phân trang: offset/limit đơn giản; với dữ liệu lớn dùng phân trang theo con trỏ (keyset: WHERE id > id_cuối) để hiệu năng không giảm.
  • Xóa mềm (soft delete): đánh dấu đã xóa thay vì xóa thật, để khôi phục và giữ lịch sử.

CRUD

class SVTao(SQLModel):
    ma: str; ten: str; diem: float = 0
class SVSua(SQLModel):
    ten: str | None = None; diem: float | None = None

@router.post("/", response_model=SinhVien, status_code=201)
def tao(sv: SVTao, db: PhienDB):
    obj = SinhVien.model_validate(sv)
    db.add(obj); db.commit(); db.refresh(obj)
    return obj

@router.get("/", response_model=list[SinhVien])
def ds(db: PhienDB, q: str = "", trang: int = 1):
    cau = select(SinhVien).where(SinhVien.ten.contains(q)).offset((trang - 1) * 20).limit(20)
    return db.exec(cau).all()

@router.patch("/{id}", response_model=SinhVien)
def sua(id: int, du_lieu: SVSua, db: PhienDB):
    obj = db.get(SinhVien, id) or abort404()
    obj.sqlmodel_update(du_lieu.model_dump(exclude_unset=True))
    db.add(obj); db.commit(); db.refresh(obj)
    return obj

@router.delete("/{id}", status_code=204)
def xoa(id: int, db: PhienDB):
    obj = db.get(SinhVien, id) or abort404()
    db.delete(obj); db.commit()

Ứng dụng thực tế

Bài toán: ứng dụng di động chỉ đổi số điện thoại của sinh viên. Nếu dùng PUT mà ứng dụng gửi thiếu trường, dữ liệu khác có thể bị ghi đè thành rỗng; PATCH với exclude_unset an toàn hơn. Thêm xóa mềm:

class SinhVien(SQLModel, table=True):
    id: int | None = Field(default=None, primary_key=True)
    ten: str
    sdt: str | None = None
    da_xoa: bool = False

class SVSua(SQLModel):
    ten: str | None = None
    sdt: str | None = None

@router.patch("/{id}")
def sua(id: int, du_lieu: SVSua, db: PhienDB):
    sv = db.get(SinhVien, id)
    if not sv or sv.da_xoa: raise HTTPException(404)
    sv.sqlmodel_update(du_lieu.model_dump(exclude_unset=True))   # {"sdt": "0912..."} chỉ đổi sdt
    db.commit(); db.refresh(sv)
    return sv

@router.delete("/{id}", status_code=204)
def xoa(id: int, db: PhienDB):
    sv = db.get(SinhVien, id)
    if sv: sv.da_xoa = True; db.commit()
Thực hành
  1. Hoàn thiện CRUD sinh viên.
  2. Thêm sắp xếp theo điểm qua tham số.
  3. Thử toàn bộ API trên /docs.
Tóm tắt bài học
  • Model tách theo mục đích.
  • PATCH cập nhật một phần với exclude_unset.
  • DELETE trả 204.