Ako napísať dobré funkcie a metódy podľa CleanCode?

Keďže pre metódy sú funkcie pre triedy v Objektovo Orientovanom programovaní, nazývajme funkcie a metódy jednotne metódy. Metóda dve zložky:

• definícia metódy: ide najmä o čitateľnosť samotného tela metódy. Tu hrá významnú roľu napr. dĺžka metódy
• volanie metódy: metóda by mala byť natoľko zrozumiteľná, že by sa mala dať rýchlo zavolať resp. používať. Tu hrá významnú roľu napr. počet a poradie vstupných parametrov do metódy

Argumenty pochovávajú čitateľnosť!

Mali by ste minimalizovať počet argumentov / resp. parametrov metód. Najľahšie sa volá metóda bez parametrov, ako napr. objekt.aktualizuj() alebo podstranka.vykresli(). Takéto metódy bývajú najzrozumiteľnejšie.

Ak to nie je možné, mali by ste používať jeden argument, ako napr. debug.vypis(sprava).

Ak to nie je technicky možné, tak môžete použiť dva argumenty. Ako napr. bod.nastavSuradnice(3,5). Horšie je, že si tu treba pamätať poradie argumentov. Treba na to pamätať a zároveň je to priestor na chyby.

Pokiaľ používate tri argumenty, tak je to nie je veľmi vhodné. Opäť si potrebujete pamätať poradie troch argumentov. Napr. podstranka.vykresli(idStranky, poradie, text) Skúste sa takýmto prípadom úplne vyvarovať.

Pokračovanie článku ako aj množstvo praktických ukážok nájdete v knižke.

Ako sa naučiť kultúru programovania CleanCode aj keď ste programátor začiatočník?

Na to vám poslúži CleanCode Bibka. Malá CleanCode Biblia, ktorú v pohode zlúskate behom víkendu. Stiahnite si náš ebook teraz zdarma:

 

Marián Knězek

 

Súvisiace články:

• Čo je do kelu ten Clean Code?
• Kľúčové bolestivé body každého zdrojového kódu programu
• Čo sa ma študenti často pýtajú ku CleanCode?
• Štruktúra programátorského kódu podľa CleanCode? Nepoužívajte komentáre!
• Ako vie pomôcť CleanCode prehľadnosti formátovania kódu?
• Unit Testy pomáhajú CleanCode!
• Pravidlo DRY a CleanCode