paint-brush
კოდი სუნი 285 - როგორ დავაფიქსიროთ არაიმპერატიული ფუნქციებიმიერ@mcsee
290 საკითხავი

კოდი სუნი 285 - როგორ დავაფიქსიროთ არაიმპერატიული ფუნქციები

მიერ Maximiliano Contieri
Maximiliano Contieri HackerNoon profile picture

Maximiliano Contieri

@mcsee

I’m a sr software engineer specialized in Clean Code, Design...

3 წთ read2025/01/11
Read on Terminal Reader
Read this story in a terminal
Print this story
tldt arrow
ka-flagKA
წაიკითხეთ ეს ამბავი ქართულად!
en-flagEN
Read this story in the original language, English!
bn-flagBN
এই গল্পটি বাংলায় পড়ুন!
es-flagES
Lee esta historia en Español!
ja-flagJA
この物語を日本語で読んでください!
sr-flagSR
Прочитајте ову причу на српском!
sw-flagSW
Soma hadithi hii kwa kiswahili!
kk-flagKK
Бұл оқиғаны қазақша оқыңыз!
sq-flagSQ
Lexojeni këtë histori në shqip!
hu-flagHU
Olvasd el ezt a történetet magyarul!
ms-flagMS
Baca cerita ini dalam bahasa Melayu!
af-flagAF
Lees hierdie storie in Afrikaans!
th-flagTH
อ่านเรื่องนี้เป็นภาษาไทย!
KA

Ძალიან გრძელი; Წაკითხვა

გაურკვეველი სახელების მქონე ფუნქციები მალავს განზრახვას და აბნევს მკითხველს. გამოიყენეთ აღწერითი, მოქმედებაზე ორიენტირებული სახელები.
featured image - კოდი სუნი 285 - როგორ დავაფიქსიროთ არაიმპერატიული ფუნქციები
Maximiliano Contieri HackerNoon profile picture
Maximiliano Contieri

Maximiliano Contieri

@mcsee

I’m a sr software engineer specialized in Clean Code, Design and TDD Book "Clean Code Cookbook" 500+ articles written

0-item

STORY’S CREDIBILITY

Original Reporting

Original Reporting

This story contains new, firsthand information uncovered by the writer.

იყავი იმპერატიული!!

TL;DR: ფუნქციები გაურკვეველი სახელებით მალავს განზრახვას და აბნევს მკითხველს. გამოიყენეთ აღწერითი, მოქმედებაზე ორიენტირებული სახელები.

პრობლემები

  • გაურკვეველი ფუნქციის მიზანი
  • გაზრდილი შემეცნებითი დატვირთვა
  • შეცდომაში შემყვანი კონტექსტი
  • შემცირებული წაკითხვა
  • რთული თანამშრომლობა
  • ფარული ფუნქციონირება

გადაწყვეტილებები

  1. გამოიყენეთ მოქმედებაზე ორიენტირებული ზმნები
  2. გააკეთეთ სახელები აღწერით
  3. ასახეთ ფუნქციის მიზანი
  4. მოერიდეთ ზოგად ტერმინებს
  5. მიეცით მნიშვნელოვანი კონტექსტი
  6. მკაფიოდ გამოხატეთ ერთი პასუხისმგებლობა
  7. შეადარეთ მოქმედება შედეგს

რეფაქტორინგი

https://hackernoon.com/improving-the-code-one-line-at-a-time

კონტექსტი

ზოგადი ტერმინებით დასახელებული ფუნქციები მკითხველს აიძულებს ჩაძირონ განხორციელებაში, რათა გაიგონ მათი ქცევა.


ეს კარგავს დროს და ზრდის შეცდომების შანსს.


დასახელება კიდევ უფრო მნიშვნელოვანი ხდება დამოუკიდებელ ფუნქციებთან მუშაობისას, სადაც კლასის სახელი არ იძლევა დამატებით კონტექსტს.


ეს საკითხი პირდაპირ კავშირშია „ უთხარი, არ იკითხო“ პრინციპს .


იმის ნაცვლად, რომ გამოაშკარავდეს ორაზროვანი ქცევები, რომლებიც აიძულებს აბონენტს დაასკვნას ფუნქციონალობა, იმპერატიული სახელები გადმოსცემს ზუსტ მოქმედებას, ხელმძღვანელობს მკითხველს კოდის შემოწმების გარეშე.


როდესაც თქვენ ასახელებთ ფუნქციებს აღწერილობით, თქვენ აღმოფხვრის არასაჭირო ვარაუდებს და უერთდებით ამ პრინციპს.

კოდის ნიმუში

არასწორი

 public String dateFormatting(Date date) { return new SimpleDateFormat("yyyy-MM-dd").format(date); } public void load() { System.out.println("Loading..."); }

უფლება

 public String formatDate(Date date) { return new SimpleDateFormat("yyyy-MM-dd").format(date); } public void loadUserPreferences() { System.out.println("Loading user preferences..."); }

გამოვლენა

  • [x] სახელმძღვანელო

თქვენ შეგიძლიათ ამოიცნოთ ეს სუნი ფუნქციების სახელების გადახედვით, რომლებიც იყენებენ ბუნდოვან ტერმინებს, როგორიცაა do , run , process , load და ა.შ.


ავტომატურ ლინტერებს შეუძლიათ ამ შაბლონების მონიშვნა ან ფუნქციების ზედმეტად ზოგადი სახელებით მონიშვნა.

ტეგები

  • დასახელება

დონე

  • [x] დამწყები

რატომ არის ბიექცია მნიშვნელოვანი

ფუნქციების სახელებმა უნდა შექმნან მკაფიო ერთი-ერთზე მიმოწერა მათ სახელსა და ფუნქციებს შორის.


ამ Bijection-ის დარღვევა აიძულებს დეველოპერებს შეისწავლონ კოდის დეტალები კონტექსტში, შეანელონ გამართვა, მიმოხილვები და გაფართოებები.

AI თაობა

ხელოვნური ინტელექტის ინსტრუმენტები ხანდახან წარმოქმნის ფუნქციების ზოგად სახელებს თქვენი დომენის გაგების გარეშე.


ხელოვნური ინტელექტის გამოყენებისას, მიუთითეთ, რომ ფუნქციების სახელები უნდა იყოს აღწერილობითი და მოქმედებაზე ორიენტირებული.

AI გამოვლენა

ხელოვნური ინტელექტის მოდელებს შეუძლიათ ხელი შეუწყონ ორაზროვანი სახელების აღმოჩენას ფუნქციის ხელმოწერების წინასწარ განსაზღვრულ საუკეთესო პრაქტიკასთან დასახელების შედარებით.


ხელოვნური ინტელექტის შერწყმა და ხელით კოდის მიმოხილვა საუკეთესო შედეგებს იძლევა.

სცადეთ ისინი!

გახსოვდეთ: AI ასისტენტები უამრავ შეცდომას უშვებენ

სათანადო ინსტრუქციის გარეშე

სპეციფიკური ინსტრუქციებით

ChatGPT

ChatGPT

კლოდ

კლოდ

გაურკვევლობა

გაურკვევლობა

კოპილოტი

კოპილოტი

ტყუპები

ტყუპები

დასკვნა

ფუნქციების სახელები არ არის მხოლოდ ეტიკეტები; ისინი კონტრაქტებია მკითხველთან.


ორაზროვანი სახელები არღვევენ ამ კონტრაქტს და იწვევს დაბნეულობას.


აღწერილობითი, მოქმედებაზე ორიენტირებული სახელები ამარტივებს კომუნიკაციას და ამარტივებს თქვენს კოდს შენარჩუნებასა და გაფართოებას.

ურთიერთობები


article preview
HACKERNOON

How to Find The Stinky Parts of Your Code (Part VII) | HackerNoon

We see several symptoms and situations that make us doubt the quality of our development.


article preview
HACKERNOON

How to Find the Stinky Parts of Your Code [Part XXXI] | HackerNoon

Beginners are afraid to remove code. And many seniors too.


article preview
HACKERNOON

How to Find The Stinky Parts of Your Code (Part VIII) | HackerNoon

Yet more code smells? Plenty of!


article preview
HACKERNOON

How to Find the Stinky Parts of Your Code [Part XXXV] | HackerNoon

Most of these smells are just hints of something that might be wrong. Therefore, they are not required to be fixed per se… (You should look into it, though.)

აგრეთვე იხილეთ


article preview
HACKERNOON

What Exactly Is A Name: The Quest [Part I] | HackerNoon

We all agree: a good name is always the most important thing. Let’s find them.


article preview
HACKERNOON

What Exactly Is A Name: Rehab [Part II] | HackerNoon

We all agree: a good name is always the most important thing. Let’s find them.

პასუხისმგებლობის უარყოფა

კოდის სუნი ჩემი აზრია .

კრედიტები

ფოტო britishlibrary- ზე Unsplash- ზე


ფუნქციის სახელი უნდა იყოს ზმნა ან ზმნური ფრაზა და ის უნდა იყოს მნიშვნელოვანი

რობერტ სი მარტინი


article preview
HACKERNOON

400+ Thought-Provoking Software Engineering Quotes | HackerNoon

The most complete curated collection of software and programming quotes


ეს სტატია CodeSmell სერიის ნაწილია.


article preview
HACKERNOON

How to Find the Stinky Parts of Your Code (Part I) | HackerNoon

The code smells bad. Let’s see how to change the aromas. In this series, we will see several symptoms and situations that make us doubt the quality of our developments. We will present possible solutions. Most of these smells are just hints of something that might be wrong. They are not rigid rules.


L O A D I N G
. . . comments & more!

About Author

Maximiliano Contieri HackerNoon profile picture
Maximiliano Contieri@mcsee
I’m a sr software engineer specialized in Clean Code, Design and TDD Book "Clean Code Cookbook" 500+ articles written

დაკიდეთ ტეგები

ეს სტატია იყო წარმოდგენილი...

Read on Terminal Reader
Read this story in a terminal
 Terminal
Read this story w/o Javascript
Read this story w/o Javascript
 Lite
X REMOVE AD