Сіз үшін сапалы код деген не?

Мен үшін сапалы код келесі сипаттамаларға ие:

• Оқылымдылық: Басқа әзірлеушілерге (және алты айдан кейін өзіңізге) оңай түсінуге болады.
• Қолдау мүмкіндігі: Өзгерістер енгізу және қателерді түзету тез әрі қауіпсіз орындалады.
• Тестілеу мүмкіндігі: Код модульдерге бөлінген, оларды оқшаулау және тестілеу оңай.
• Таза код: Қайталау болмауы (DRY), айқын айнымалылар мен функциялардың атаулары, код-стайлды сақтау.
• Тиімділік: Қажетті ресурстарды (процессор, жад) оңтайлы пайдалану.
• Сенімділік: Мүмкін болатын қателерді (қате жағдайлар, null мәндер) ескереді және дұрыс өңдейді.
• Құжаттау: Қажет болған жағдайда анық түсіндірмелер немесе құжаттама бар.

Қайталауды болдырмайтын таза кодтың мысалы:

// Жаман: логиканы қайталау
fun processUser(user: User) {
    if (user.isActive) {
        println("Белсенді қолданушыны өңдеу ${user.name}")
        // Көп код...
    } else {
        println("Белсенді емес қолданушыны өңдеу ${user.name}")
        // Сол көп код...
    }
}

// Жақсы: қайталанатын логиканы бөлек шығару
fun processUser(user: User) {
    println("Қолданушыны өңдеу ${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
}