Jak pisać dobre funkcje i metody zgodnie z CleanCode?

Ponieważ dla metod w programowaniu obiektowym funkcje dla klas, nazywajmy funkcje i metody jednolicie metodami. Metoda ma dwie składowe:

• definicja metody: chodzi głównie o czytelność samego ciała metody. Tutaj ważną rolę odgrywa np. długość metody
• wywołanie metody: metoda powinna być na tyle zrozumiała, że powinna być łatwo wywoływana lub używana. Ważną rolę odgrywa np. liczba i kolejność parametrów wejściowych do metody

Argumenty pogarszają czytelność!

Powinniście minimalizować liczbę argumentów / parametrów metod. Najłatwiej wywołuje się metodę bez parametrów, jak np. obiekt.aktualizuj() lub podstrona.wyrysuj(). Takie metody są najbardziej zrozumiałe.

Jeśli to niemożliwe, powinniście używać jednego argumentu, jak np. debug.wypisz(komunikat).

Jeśli to technicznie niemożliwe, możecie użyć dwóch argumentów, jak np. punkt.ustawWspolrzedne(3,5). Gorsze jest to, że trzeba pamiętać o kolejności argumentów. Należy to zapamiętać, a jednocześnie jest to przestrzeń na błędy.

Jeśli używacie trzech argumentów, to nie jest to zbyt odpowiednie. Ponownie musicie pamiętać o kolejności trzech argumentów. Na przykład podstrona.wyrysuj(idStrony, porzadek, tekst). Starajcie się całkowicie unikać takich przypadków.

Marián Knězek