කේත ලිවීමේදී නාම තේරුම් ගත නොහැකි වීම, වැඩේ අඩු කරවන්නට හේතුවක්. නාමයක් "කොහොමද" කියලා කියන එකට වඩා "ඇයි" කියලා කියන්න ඕන. මේ ලිපියෙදී නාමකරණයේ වැදගත් කාරණා, උච්චාරණය, සමානුකූල පද්ධති සහ සොයාගත හැකි නාමයන් ගැන සාමාන්ය උදාහරණ සමඟ පැහැදිලි කරමු.
නාමකරණයේ මූලික නීති
- අරමුණ පෙන්වන නාම – නාමය ඒකේ අරමුණ, කාර්යය, භාවිතය කියලා පැහැදිලි කරන්න. "data" වගේ පොදු නාම වලට ඉඩ නොදෙන්න.
- උච්චාරණයට සුළු නාම – කතාබහේදී කියන්න පුළුවන් නාමය වඩා හොඳ. "genymdhms" වගේ අකුරු ගැලපීමේ නාම වලට වළක්වා, "generation_timestamp" වගේ කියන්න පුළුවන් නාම භාවිතා කරන්න.
- වෙළඳ නාමයේ අසත්ය නොකිරීම – නාමය එය නියම කරන දේවල් වැරදි ලෙස ඉදිරිපත් නොකරන්න. "account_list" කියලා නම් List වර්ගයක්, HashMap නම් "account_map" වගේ නාමයක් භාවිතා කරන්න.
- සමානුකූල ශෛලිය – JavaScript සඳහා camelCase, Python සඳහා snake_case, පන්තීන් සඳහා PascalCase වැනි එකම රීතියක් තෝරා ඒකම පරිදි අනුගමනය කරන්න.
- අර්ථවත් වෙනස්කම් – a1, a2 වගේ අංක පදනම් නාම වලට වඩා, "latitude" වැනි අර්ථවත් නාම භාවිතා කරන්න. "ProductInfo" සහ "ProductData" වගේ අර්ථය සමාන නාම වලට වෙනස් නාමයක් දෙන්න.
- සෙවීමට සුළු නාම – තනි අකුරු නාම (e, i) පරික්ෂණය සඳහා පමණක් භාවිතා කරන්න. "error_message" වැනි නාම සොයා ගැනීම පහසු.
පන්තීන් සහ ක්රියාකාරකම් නාමකරණය
පන්තීන් නාමය නාම පදයක් හෝ නාම පද සමූහයක් විය යුතුය – Customer, WikiPage වැනි. ක්රියාකාරකම් නාමය ක්රියා පදයක් – save, delete, getAddress වැනි. මේ රීතිය අනුගමනය කිරීමෙන් කේතය තේරුම් ගැනීමට කාලය අඩු වේ.
ශ්රී ලංකාවට ඇති වැදගත්කම
ශ්රී ලංකාවේ ඉගෙනුම් ආයතන, තාක්ෂණ සමාගම්, ස්වයංක්රීය සංවර්ධකයන් සඳහා නාමකරණය අත්යවශ්යය. නාම පද්ධති සමානුකූල කිරීමෙන්:
- විද්යාලීය කේත පරික්ෂණය සහ පිරිසිදු කිරීම පහසු වේ.
- දෙවන පාර්ශවයන් සමඟ API හුවමාරු කිරීමේදී ගැටලු අඩු වේ.
- දෙකඩි කාලයක් අඩු කර, නිෂ්පාදන වේගය වැඩි වේ.
- ශ්රී ලංකාවේ තාක්ෂණ සමාජයේ නවකයන්ට හොඳ උදාහරණයක් සපයයි.
කේතය තුළ නාමයන් තුළ වෙනස්කම් පෙනී සිටී නම්, Refactor Tools භාවිතයෙන් නාමය මාරු කරගන්න. "Rule of Three" කියන නීතිය අනුව, නාමය තුනක් වරක් භාවිතා කර පසු වැරදි නම්, ඒක මාරු කරන්න.
සාමාන්ය නාමකරණ උපදෙස් අනුගමනය කිරීමෙන් ඔබේ කේතය පිරිසිදු, කියවීමට පහසු, නඩත්තු කිරීමේදී කාලය ඉතිරි වන ලාභයක් ලබා ගත හැක.
