Tài liệu này áp dụng cho phương thức sau: Cập nhật API (v4): threatListUpdates.fetch.
Thiết lập điều kiện ràng buộc
Khi cập nhật cơ sở dữ liệu cục bộ (xem phần Cập nhật cơ sở dữ liệu), máy khách có thể dùng các trường maxUpdateEntries
và maxDatabaseEntries
trong yêu cầu threatListUpdate.fetch để chỉ định các giới hạn về kích thước. Ứng dụng nên đặt các điều kiện ràng buộc để duy trì mức tiêu thụ RAM, ổ đĩa và băng thông của ứng dụng theo dự đoán, đồng thời để bảo vệ chống lại sự gia tăng của danh sách.
- Ứng dụng có thể chỉ định kích thước phản hồi cập nhật tối đa (
maxUpdateEntries
) cho số mục (1 mục = 1 lượt thêm hoặc 1 lượt xoá). - Ứng dụng có thể chỉ định kích thước cơ sở dữ liệu tối đa (
maxDatabaseEntries
) theo số lượng mục nhập (phần lớn các mục nhập trong cơ sở dữ liệu là tiền tố băm 4 byte, vì vậy, bạn có thể giả định rằng 1 mục nhập ≈ 4 byte).
Băng thông so với bộ nhớ
Mặc dù ứng dụng có thể chỉ định kích thước tuỳ ý cho phản hồi cập nhật và kích thước cơ sở dữ liệu, nhưng máy chủ Duyệt web an toàn chỉ tạo trước một số lượng hữu hạn kích thước cơ sở dữ liệu và phản hồi cập nhật có thể có.
- Ứng dụng nên sử dụng kích thước phản hồi của bản cập nhật (
maxUpdateEntries
) để giới hạn mức sử dụng băng thông. - Ứng dụng nên dùng kích thước cơ sở dữ liệu (
maxDatabaseEntries
) để giới hạn dung lượng RAM hoặc bộ nhớ ổ đĩa cần thiết trên thiết bị.
Hướng dẫn thiết lập các điều kiện ràng buộc
Danh sách của tính năng Duyệt web an toàn có thể thay đổi dần hoặc đột ngột về kích thước. Ứng dụng nên đặt maxUpdateEntries
cho các yêu cầu cập nhật danh sách. Việc này sẽ giới hạn kích thước phản hồi tối đa của phản hồi cập nhật danh sách và cải thiện độ tin cậy khi không thể xử lý các bản cập nhật lớn.
Trong trường hợp không có các yêu cầu nghiêm ngặt hơn hoặc các yêu cầu ít nghiêm ngặt hơn, bạn nên sử dụng maxUpdateEntries=16777216
. Với kích thước mục nhập danh sách thông thường là 4 byte cho mỗi tiền tố băm, kích thước này tương đương với khoảng 67 megabyte cho mỗi danh sách. Bạn nên sử dụng giới hạn nhỏ hơn maxUpdateEntries=2097152
cho các ứng dụng di động, vì các ứng dụng này thường kém mạnh mẽ hơn. Với kích thước thông thường của mục nhập danh sách là 4 byte cho mỗi tiền tố băm, dung lượng này tương đương với khoảng 8 megabyte cho mỗi danh sách.
Các danh sách của tính năng Duyệt web an toàn có quy mô và tốc độ tăng trưởng khác nhau. Tuy nhiên, ứng dụng nên đặt các điều kiện ràng buộc giống nhau cho tất cả các danh sách, dựa trên mức sử dụng bộ nhớ hoặc băng thông tối đa được phép cho mỗi danh sách.
Để cải thiện độ tin cậy, ứng dụng nên triển khai phép đo từ xa để phát hiện tình trạng sử dụng quá mức bộ nhớ hoặc băng thông, cũng như các cơ chế để nhanh chóng phân phối các quy tắc ràng buộc mới cho ứng dụng.
Trạng thái ứng dụng
Máy chủ Duyệt web an toàn không bao giờ gửi bản cập nhật khiến ứng dụng ở trạng thái lỗi thời; máy khách sẽ được cập nhật đầy đủ sau mỗi yêu cầu cập nhật. Ví dụ: nếu một ứng dụng hiện có cơ sở dữ liệu gồm 4096 mục nhập nhưng chỉ muốn tải xuống tối đa 2048 delta, thì máy chủ có thể đặt lại ứng dụng về một cơ sở dữ liệu 2048 nếu ứng dụng đó thực sự đã lỗi thời.