Clean Code на Kotlin: принципы и примеры чистого кода

Clean Code на Kotlin: принципы и примеры

Чистый код (Clean Code) — это не просто модный термин, а фундаментальный навык каждого разработчика. На языке Kotlin, который сочетает в себе лаконичность и выразительность, писать чистый код особенно приятно. В этой статье мы разберем основные принципы Clean Code применительно к Kotlin и рассмотрим конкретные примеры, которые помогут вам сделать ваш код более читаемым, поддерживаемым и надежным.

Почему Clean Code важен для Kotlin?

Kotlin — статически типизированный язык, работающий поверх JVM. Он предлагает множество современных возможностей: null safety, функции расширения, data class, sealed class и многое другое. Однако эти возможности могут как упростить, так и усложнить код, если не следовать принципам чистоты. Чистый код на Kotlin — это код, который легко понять с первого взгляда, который не требует комментариев для объяснения очевидных вещей и который можно безопасно изменять.

Принцип 1: Используйте Null Safety осознанно

Одна из главных фич Kotlin — null safety. Вместо бесконечных проверок на null, Kotlin предлагает элегантные решения. Однако злоупотребление оператором !! (not-null assertion) — прямой путь к NullPointerException.

Плохой пример:

fun processUser(user: User?) {
    val name = user!!.name
    println(name)
}

Здесь мы просто "кричим" компилятору: "Я знаю, что делаю!", но рискуем упасть в рантайме.

Хороший пример:

fun processUser(user: User?) {
    val name = user?.name ?: "Гость"
    println(name)
}

Используйте ?. (safe call) и ?: (elvis operator). Это делает код безопасным и читаемым. Если вам нужно выполнить действие только при не-null значении, используйте let:

user?.let { 
    println("Пользователь найден: ${it.name}")
}

Принцип 2: Избегайте длинных цепочек вызовов

Kotlin поддерживает цепочки вызовов (method chaining), особенно в коллекциях. Однако слишком длинные цепочки становятся нечитаемыми.

Плохой пример:

val result = list
    .filter { it.isActive }
    .map { it.name }
    .filter { it.startsWith("A") }
    .sorted()
    .take(5)
    .joinToString()

Такой код сложно отлаживать и понимать, что происходит на каждом шаге.

Хороший пример:

val activeUsers = list.filter { it.isActive }
val namesStartingWithA = activeUsers.map { it.name }.filter { it.startsWith("A") }
val top5Names = namesStartingWithA.sorted().take(5)
val result = top5Names.joinToString()

Разбивайте цепочки на промежуточные переменные с понятными именами. Это улучшает читаемость и упрощает отладку.

Принцип 3: Используйте Data Class для моделей данных

Вместо ручного написания equals(), hashCode(), toString() и copy(), используйте data class. Это снижает количество шаблонного кода (boilerplate).

Плохой пример (Java-style в Kotlin):

class User(val id: Int, val name: String) {
    override fun equals(other: Any?): Boolean { ... }
    override fun hashCode(): Int { ... }
    override fun toString(): String { ... }
}

data class User(val id: Int, val name: String)

val (id, name) = User(1, "Alice")
println("$id: $name") // 1: Alice

class Loading
class Success(val data: String)
class Error(val message: String)

fun handleState(state: Any) {
    when (state) {
        is Loading -> // ...
        is Success -> // ...
        is Error -> // ...
    }
}

sealed class UiState {
    object Loading : UiState()
    data class Success(val data: String) : UiState()
    data class Error(val message: String) : UiState()
}

fun handleState(state: UiState) {
    when (state) {
        is UiState.Loading -> println("Загрузка...")
        is UiState.Success -> println("Данные: ${state.data}")
        is UiState.Error -> println("Ошибка: ${state.message}")
    }
}

// Вместо утилитарного класса StringUtils
fun String.isEmail(): Boolean {
    return this.contains("@") && this.contains(".")
}

fun main() {
    val email = "user@example.com"
    if (email.isEmail()) {
        println("Корректный email")
    }
}

val d = 86400 // секунд в сутках
fun calc(a: Int,