Kas ir par vārdu došanu? Un kāpēc mums par to vispār būtu jārūpējas? Tas ir tikai vārds.
Mainīgo, metožu, klašu, pakotņu utt. nosaukumu piešķiršanai bieži tiek pievērsta mazāka uzmanība, nekā tas ir pelnījis. Ļoti bieži mēs sastopamies ar tādiem nosaukumiem kā i,j,k vai bezjēdzīgiem nosaukumiem, piemēram, customerServicingProfileObjectUtil. Mēs neuzskatām, ka ir svarīgi veltīt dažas minūtes, lai izstrādātu labākus nosaukumus mūsu programmas komponentiem. Galu galā tas ir tikai vārds. Ja mēs nesaprotam, ko tas dara, mēs vienmēr varam vienkārši izlasīt kodu un izdomāt.
Nosaukšana var nozīmēt vairāk, nekā mēs domājam. Ja mēs nevaram izdomāt labu nosaukumu komponentam, kas varētu nozīmēt kādu no tālāk norādītajiem
- Mēs nesaprotam šīs sastāvdaļas pienākumus
- Tam ir vairāk nekā viena atbildība
Tātad, izdomājot labu nosaukumu, mēs varam skaidri redzēt problēmas un pārveidot kodu, lai labāk notīrītu kodu. Tas arī palīdz mūsu koda lasāmībai. Ja mēs redzam metodi ar nolūku atklāt nosaukumu, mums nav jāraugās caur šo metodi, mēģinot noskaidrot, ko tā dara, tādējādi padarot koda izpratni ātrāku. Galu galā mēs rakstām kodu, lai liktu citiem cilvēkiem to saprast.
Vēl viena slikta koda smaka ir tad, kad mums ir jāizmanto komentāri, lai aprakstītu komponentu, nevis jāizmanto tā nosaukums. Tā vietā mēs varam vienkārši pārdēvēt komponentu ar jēgpilnu nosaukumu, lai izvairītos no nepieciešamības pēc šī komentāra.
Piemērs no Roberta C Martinga savā Clean kodu grāmatā:
int d; // elapsed time in days vietā izmantojiet int elapsedTimeInDays
Kad mēs pareizi nosaucam komponentus, mēs tos labāk saprotam, saprotam, ka tie var būt dažādās vietās. Būtībā mēs labāk pārveidojam kodu.
