რა არის თქვენი აზრით ხარისხიანი კოდი?

მაღალი ხარისხის კოდი ჩემთვის აქვს შემდეგი მახასიათებლები:

• კითხულობა: ადვილია სხვა დეველოპერებისთვის (და საკუთარი თავისთვის ექვს თვეში).
• მხარდაჭერა: ცვლილებების შეტანა და შეცდომების გამოსწორება ხდება სწრაფად და უსაფრთხოდ.
• ტესტირებადობა: კოდი დაყოფილია მოდულებად, რომლებიც ადვილად იზოლირებად და ტესტირებადია.
• სუფთა: დუბლირების გარეშე (DRY), გასაგები ცვლადებისა და ფუნქციების სახელები, კოდის სტილის დაცვა.
• ეფექტურობა: რესურსების ოპტიმალური გამოყენება (პროცესორი, მეხსიერება) დავალებისთვის.
• სანდოობა: ითვალისწინებს შესაძლო შეცდომებს (გამონაკლისები, null-შესაძლებლობები) და სწორად უვლის მათ.
• დოკუმენტაცია: საჭიროების შემთხვევაში შეიცავს ნათელ კომენტარებს ან დოკუმენტაციას.

წმინდა კოდის მაგალითი, რომელიც ავიცილებს დუბლირებას:

// ცუდი: ლოგიკის დუბლირება
fun processUser(user: User) {
    if (user.isActive) {
        println("Processing active user ${user.name}")
        // ბევრი კოდი...
    } else {
        println("Processing inactive user ${user.name}")
        // იგივე ბევრი კოდი...
    }
}

// კარგი: განმეორებადი ლოგიკის გამოყოფა
fun processUser(user: User) {
    println("Processing user ${user.name}") // საერთო ლოგიკა
    if (user.isActive) {
        processActiveUser(user)
    } else {
        processInactiveUser(user)
    }
    // ბევრი კოდი... // საერთო ლოგიკა if/else-ის შემდეგ
}

fun processActiveUser(user: User) {
    // მხოლოდ სპეციფიკური ლოგიკა აქტიურებისთვის
}

fun processInactiveUser(user: User) {
    // მხოლოდ სპეციფიკური ლოგიკა არააქტიურებისთვის
}

მეორე მაგალითი, რომელიც აჩვენებს კითხულობას და გასაგებ სახელებს:

// ცუდი
fun calc(a: Int, b: Int): Int {
    return a + b
}

// კარგი
fun calculateSum(firstNumber: Int, secondNumber: Int): Int {
    return firstNumber + secondNumber
}