Skip to content

Cache và invalidation ​

Trang này liệt kê endpoint nào cung cấp và endpoint nào làm mất hiệu lực từng cache tag của RTK Query. Dành cho developer cần biết vì sao một danh sách tự tải lại sau khi thêm, sửa, xóa, hoặc vì sao nó không tự tải lại. Cách ba lớp cache phối hợp được giải thích ở Chiến lược cache, trang này không lặp lại.

Vì sao dùng tag ​

Sau khi ghi dữ liệu, mọi danh sách đang hiển thị dữ liệu đó cần được tải lại. Thay vì gọi refetch thủ công ở từng màn hình, endpoint đọc đánh dấu kết quả bằng tag (providesTags) và endpoint ghi khai báo tag nào bị cũ (invalidatesTags). RTK Query tự tải lại các truy vấn đang được dùng có tag đó.

NOTE

Tag không kèm id (ví dụ "Job") làm mất hiệu lực cả các tag cùng loại có id (ví dụ { type: "Job", id }). Vì vậy deleteJob chỉ cần "Job" để làm mới cả danh sách lẫn chi tiết.

Tag đang khai báo ​

baseApi có 10 tag: Auth, User, Company, Job, Resume, CVProfile, Subscriber, Statistics, Notification, Skill.

Endpoint cung cấp tag ​

EndpointTag cung cấp
getMeAuth
getJobs, searchJobsJob
getJob{ Job, id }
getCompanies, getTopHiringCompaniesCompany
getCompany{ Company, id }
getResumesResume
getResume{ Resume, id }
getMyCVProfileCVProfile
getUsers, getSavedJobs, getFollowingCompaniesUser
getUser{ User, id }
getAdminDashboardStats, getHrDashboardStatsStatistics
getNotifications{ Notification, id: "LIST" }, { Notification, id: "LIST-<page>-<limit>" } và { Notification, id } cho từng thông báo
getUnreadCount{ Notification, id: "UNREAD_COUNT" }
getSubscribers, getSubscribersByUser{ Subscriber, id } cho từng bản ghi và { Subscriber, id: "LIST" }
getSubscriber{ Subscriber, id }
getSubscriberSkills{ Subscriber, id: "SKILLS" }

Endpoint làm mất hiệu lực tag ​

EndpointTag bị làm mất hiệu lực
login, register, googleLogin, changePassword, setPasswordAuth
logoutAuth, User, Company, Job, Resume
requestAccountDeletion, cancelAccountDeletionAuth, User
createJob, deleteJob, bulkDeleteJobsJob
updateJob, approveJob{ Job, id } và Job
createCompany, deleteCompany, bulkDeleteCompaniesCompany
updateCompany{ Company, id } và Company
createResume, createResumeWithUpload, deleteResume, takeOutAppliedJob, bulkDeleteResumesResume
updateResume{ Resume, id } và Resume
upsertCVProfileCVProfile
createUser, deleteUser, bulkDeleteUsersUser
updateUser, lockUser, unlockUser{ User, id } và User
saveJob, unsaveJob, followCompany, unfollowCompanyAuth, User
confirmToolActionAuth, User
markAsRead, deleteNotification{ Notification, id }, LIST, UNREAD_COUNT
markAllAsReadLIST, UNREAD_COUNT
createSubscriber, deleteSubscriber{ Subscriber, id: "LIST" }
updateSubscriber{ Subscriber, id: "SKILLS" } và LIST

Endpoint không dùng tag ​

Các endpoint sau không khai báo providesTags hoặc invalidatesTags:

EndpointHệ quả
getExternalJobKết quả chỉ được giữ theo keepUnusedDataFor mặc định
getSkillCatalog, getPopularSkillsGiữ riêng 1 ngày và 1 giờ (keepUnusedDataFor), không bao giờ bị làm mất hiệu lực
uploadFile, deleteFileKhông ảnh hưởng cache nào
sendMessage, getChatHistory, clearChatHistory, cancelToolActionLịch sử chat không nằm trong cache theo tag
verifyEmail, resendCode, refreshToken, forgotPassword, resetPassword, cancelAccountDeletionByTokenKhông ảnh hưởng cache nào

Cập nhật lạc quan ​

saveJob và unsaveJob sửa ngay cache của getMe trong onQueryStarted, và hoàn tác nếu request thất bại. followCompany và unfollowCompany cũng có onQueryStarted trong cùng file user.api.ts.

Điều cần lưu ý ​

  • searchJobs (danh sách /jobs công khai) có tag Job, nên mọi thao tác tạo, sửa, duyệt, xóa tin sẽ làm nó tải lại. Trang công khai ban đầu render từ server nên không bị ảnh hưởng cho tới khi người dùng đổi bộ lọc.
  • saveJob làm mất hiệu lực Auth và User chứ không phải Job, nên danh sách việc làm không tự tải lại khi lưu việc.
  • Cache không được lưu qua lần tải lại trang, chỉ auth và chatBot được Redux Persist giữ.

Source code liên quan ​

Đọc tiếp: Chiến lược cache, Quy ước API, Quản lý state.

Tài liệu kỹ thuật xây dựng theo chuẩn Documentation as Code