Dùng sai do thiết kế
Vì sao điều này quan trọng Phần lớn lỗi ở ranh giới API không nằm trong API. Chúng nằm ở một bên gọi đã dùng nó theo một cách trông có vẻ ổn mà lặng lẽ làm sai. Bạn không thể sửa mọi bên gọi; bạn có thể khiến việc dùng sai là bất khả, hoặc ầm ĩ.
Một trợ lý viết API có xu hướng tỏ ra hữu ích: nếu bạn gửi trước khi kết nối, nó kết nối giùm bạn; nếu bạn truyền một chuỗi ở chỗ cần bytes, nó mã hóa giùm; nếu bạn quên một tùy chọn, đã có giá trị mặc định. Mỗi sự tử tế giấu đi một sai lầm cho tới khi nó nổi lên ở một nơi rất xa.
Thất bại sớm, thất bại ầm ĩ: báo lỗi ngay tại lời gọi sai, trước khi bất cứ thứ gì thay đổi, với một thông điệp nói rõ điều được mong đợi.
Bốn công cụ
- Trạng thái tường minh: một đối tượng biết nó đang mới, mở hay đóng, và từ chối những lời gọi không hợp.
- Tùy chọn có tên, không boolean:
mode="dry_run"không thể vô tình bị tráo với một cờ khác;copy(a, b, True, False)thì có thể. - Không có giá trị mặc định ngầm cho những lựa chọn nguy hiểm nếu làm sai: hãy để bên gọi tự nói ra.
- Kiểu mang ý nghĩa: tiền biết loại tiền tệ của nó không thể cộng với tiền thuộc loại khác.
Trong mô-đun này, những script dùng sai được giấu sẽ gọi API của bạn sai cách và mong đợi một lỗi tại lời gọi sai, mà không có gì thay đổi. Những script dùng đúng mong đợi nó cứ thế hoạt động. Mỗi bài toán liệt kê những cách dùng sai cần phòng ngừa.
Tóm tắt Những phỏng đoán có ý tốt giấu lỗi. Hãy từ chối cách dùng sai tại lời gọi sai, trước mọi tác động.
Bạn thấy vấn đề gì trong bài học này? Hãy báo cáo nó · Hỏi về bài học này
Bài tập này sẽ sớm mở.
Hoàn thành bài học trước đó để mở khóa bài này. Toàn bộ khóa học là miễn phí, không cần tài khoản, và bạn có thể đọc bài học này ngay bây giờ.
Trình duyệt này đang chặn cookie cho learn.floati.life, nên các bài học bạn đã hoàn thành tại đây không thể mở theo thứ tự. Hãy cho phép cookie cho trang web này và tải lại trang.