Nguyên tắc ít ngạc nhiên nhất là gì?

Trong lập trình cái gì được gọi là Nguyên tắc tối thiểu ngạc nhiên? Khái niệm này liên quan đến việc thiết kế các API tốt như thế nào? Đây có phải là một cái gì đó áp dụng cho chỉ lập trình hướng đối tượng hay nó cũng thấm vào các kỹ thuật lập trình khác? Điều này có liên quan đến nguyên tắc "làm một việc duy nhất trong phương pháp của bạn và làm tốt không"?

Nguyên lý tối thiểu gây ngạc nhiên được áp dụng cho một loạt các hoạt động thiết kế - và không chỉ trong điện toán (mặc dù đó thường là nơi xảy ra những điều đáng kinh ngạc nhất).

Hãy xem xét một thang máy có một nút bên cạnh có chữ "gọi". Khi bạn nhấn nút, điện thoại sẽ đổ chuông (thay vì gọi thang máy đến tầng đó). Điều này sẽ được coi là đáng kinh ngạc. Thiết kế chính xác sẽ là đặt nút gọi bên cạnh điện thoại thay vì thang máy.

Tiếp theo, hãy nghĩ đến một trang web có cửa sổ bật lên hiển thị lỗi kiểu cửa sổ với nút 'ok' trên đó. Mọi người nhấp vào nút 'ok' nghĩ rằng nó dành cho hệ điều hành và thay vào đó đi đến một trang web khác. Điều này gây ngạc nhiên cho người dùng.

Khi nói đến API ...

• Hãy nghĩ về một phương thức toString () thay vì in ra các trường sẽ trả về "sẽ được thực hiện".
• Một phương thức equals () hoạt động trên thông tin ẩn.
• Đôi khi mọi người cố gắng thực hiện một lớp danh sách được sắp xếp bằng cách thay đổi phương thức add thành gọi sort () trên mảng sau đó - điều đáng ngạc nhiên vì phương thức add được cho là nối vào danh sách - điều này đặc biệt đáng kinh ngạc khi một người lấy lại đối tượng List không biết rằng ở đâu đó sâu bên trong, ai đó đã vi phạm hợp đồng giao diện.

Có một phương pháp thực hiện một điều khác biệt góp phần làm giảm sự ngạc nhiên, tuy nhiên đây là những nguyên tắc riêng biệt trong thiết kế API. Bốn nguyên tắc thường được gọi là "thiết kế API tốt" là (từ pdf này - chỉ là một ví dụ của bản trình bày như vậy. Các liên kết ở cuối của một đặc biệt này giúp đọc tốt):

• Nguyên tắc trách nhiệm duy nhất
• Nguyên tắc đóng mở
• KHÔ
• Nguyên tắc ít ngạc nhiên nhất

Nó có khả năng gây ngạc nhiên cho ai đó khi có một lớp cố gắng làm mọi thứ - hoặc cần hai lớp để làm một việc duy nhất. Nó cũng có khả năng gây kinh ngạc khi ai đó gây rối với những người bên trong theo những cách kỳ quặc dưới vỏ bọc (tôi thấy các lớp học mở trong Ruby là một nguồn gây ngạc nhiên không bao giờ kết thúc). Cũng thật đáng kinh ngạc khi tìm thấy hai phương pháp có vẻ giống nhau.

Như vậy, nguyên tắc ít gây ngạc nhiên làm cơ sở cho các thiết kế API khác - nhưng bản thân nó không đủ để nói đơn giản là "không có API đáng kinh ngạc".

Đọc thêm (từ phối cảnh UI) - một blog của nhà phát triển IBM có tiêu đề Người dùng cáu kỉnh: Nguyên tắc tối thiểu ngạc nhiên

Nguyên tắc ít gây ngạc nhiên nhất là khi bạn, với tư cách là một nhà thiết kế API, ngăn người dùng của bạn nói BÂY GIỜ .

Một số ví dụ về sự ngạc nhiên trong các ngôn ngữ khác nhau.

var array=new string[]; 
var list=array as IList<string>; //this works... 
list.Add("foo"); //exception saying it's not supported

foo.Equals(bar); //will call overriden Equals method
foo == bar; //equivalent to above in everyway, except for it won't call overrides... unless you're dealing with a string

var d=DateTime.Today;
d.Add(new TimeSpan(36,0,0,0)); //add 36 days to datetime d
Console.Writeline(d); //will print todays date. WAT

//in javascript
var f=function(){
  return 
    10; 
} //will either throw a syntax error or return void, depending on your javascript runner

Và còn nhiều ví dụ nữa trong các ngôn ngữ và API khác nhau. Công việc của bạn là một người viết API là để ngăn chặn điều này. Mọi thứ nên được đặt tên và nhập theo cách rõ ràng một cách rõ ràng những gì một cuộc gọi đến API của bạn sẽ làm. Bao gồm tài liệu phong phú, nơi điều này là không thể.

Về cơ bản, nếu mọi người phải đọc kỹ tài liệu của bạn để tìm ra cách ĐỌC mã được viết cho API của bạn, có lẽ bạn đã làm sai.

Đây là một ví dụ về "sự ngạc nhiên" xảy ra với tôi gần đây. Tôi bị lạc trên đường, vì vậy đã kéo qua và hơi điên cuồng (tôi đến trễ) đã đấm một ngã tư vào GPS của tôi. Tôi nhấp vào Đi và đặt tay trở lại bánh xe - nhưng sau đó nhận được một cảnh báo lớn (toàn màn hình) rằng GPS sẽ được cập nhật - yêu cầu tôi phải xác nhận.

Suy nghĩ của tôi là "bạn đang đùa à? Bây giờ bạn đang nói với tôi điều này à? Tôi cần phải rời tay khỏi bánh xe để thừa nhận?".

Bề mặt ngạc nhiên trong giao diện (thường là UI, nhưng tôi cho rằng nó cũng có thể là một API hoạt động theo cách không mong muốn). Tôi có thể nói rằng nó cũng thấm vào bên dưới giao diện, bởi vì nó cần phần mềm cơ bản được thiết kế tốt để hỗ trợ giao diện được thiết kế thực sự tốt.