Kiedy czytałem artykuły na temat tworzenia oprogramowania, często słyszałam zwrot "czysty interfejs". Ludzie mówili o czystym interfejsie API i klas.Wskazówki dotyczące projektowania czystego interfejsu
Jak definiujesz "czysty interfejs"? Czy są jakieś wytyczne dotyczące projektowania systemu z czystym interfejsem?
"Czysty interfejs" to taki, który nie wycieka szczegółów implementacji. Jest łatwy do zrozumienia, nie eksponuje swoich prywatnych części i nie powoduje nadmiernego sprzężenia między tobą a kodem, z którym się łączysz. Jest to raczej zapach kodu niż ścisła definicja ...
+1 Zgadzam się, dodałbym również, że właściwości nie są powtórzeniami. Jeśli natkniesz się na tę samą metodę lub właściwość w więcej niż jednym interfejsie, który ma podobny cel, być może lepiej będzie wybrać interfejs wyższego poziomu, z którego będą czerpać inni użytkownicy. –
Całe książki zostały napisane na ten temat, a Framework Design Guidelines (.NET-centric) jest jednym z moich ulubionych. Jest w tym dużo i nie ma prostej odpowiedzi, ale gdybym otrzymał dla prostej odpowiedzi, powiedziałabym zaprojektować API tak, aby można było zrobić proste rzeczy bez konieczności czytania rozbudowanej dokumentacji przez programistę. Oznacza to prosty, spójny interfejs z rozsądnymi, opisowymi nazwami. Nie utrudniaj podstawowych rzeczy.
Zachowaj prostotę i pisz krótko i szybko, nie wymagające wyjaśnienia kod. Ten, który jest łatwy do odczytania i utrzymania.
+1 za to, że chcesz zrobić właściwą drogę, i za kopanie głębiej niż własne myśli. –
Dzięki, doceniam to :) – hongster