Как заменить статические методы из Java в Kotlin: полное руководство

Основные способы замены статических методов в Kotlin

В Kotlin нет ключевого слова static, но есть несколько альтернатив. Выбор зависит от того, что вы хотите сделать.

1. Функции верхнего уровня (Top-level functions)

Самый идиоматичный способ для утилитных методов — объявить функцию вне класса. Kotlin сам скомпилирует это в статический метод.

// Файл: StringUtils.kt
fun isEmpty(str: String?): Boolean {
    return str == null || str.trim().isEmpty()
}

const val APP_NAME = "MyApp"

// Использование
fun main() {
    println(isEmpty("")) // true
    println(APP_NAME) // MyApp
}

В Java этот код будет доступен как статические методы класса StringUtilsKt. Чтобы изменить имя класса, используйте аннотацию @JvmName:

@file:JvmName("StringUtils")
package com.example.utils

fun isEmpty(str: String?): Boolean { ... }

2. Companion object (объект-компаньон)

Используйте, когда статические члены должны быть частью класса (например, фабричные методы).

class User(val name: String) {
    companion object {
        const val DEFAULT_NAME = "Guest"
        
        fun createGuest(): User {
            return User(DEFAULT_NAME)
        }
        
        @JvmStatic
        fun createAdmin(): User {
            return User("Admin")
        }
    }
}

// Использование
val guest = User.createGuest()
println(User.DEFAULT_NAME) // Guest

Обратите внимание: @JvmStatic нужен, чтобы метод был виден как статический из Java. Без этой аннотации из Java придётся писать User.Companion.createAdmin().

3. Object (объект-одиночка)

Идеально для классов, которые должны существовать в единственном экземпляре (например, синглтон или фабрика).

object NetworkConfig {
    const val BASE_URL = "https://api.example.com"
    const val TIMEOUT = 5000
    
    fun getHeaders(): Map<String, String> {
        return mapOf("Content-Type" to "application/json")
    }
}

// Использование
println(NetworkConfig.BASE_URL)
println(NetworkConfig.getHeaders())

4. Константы верхнего уровня с const

Для примитивных констант используйте const val на верхнем уровне. Это создаст настоящие статические поля.

const val MAX_RETRIES = 3
const val TIMEOUT_MS = 1000L

class RetryManager {
    fun retry() {
        repeat(MAX_RETRIES) { ... }
    }
}

5. Extension functions (функции-расширения)

Для утилит, работающих с конкретным типом. Они компилируются как статические методы.

fun String?.isNullOrEmpty(): Boolean {
    return this == null || this.trim().isEmpty()
}

// Использование
val text: String? = null
println(text.isNullOrEmpty()) // true

Когда что использовать?

• Функции верхнего уровня — для утилит без состояния (как ваша isEmpty).
• Companion object — для статических членов, логически связанных с классом (фабрики, константы).
• Object — для синглтонов или групп констант/методов.
• Extension functions — для добавления функционала к существующим классам.

В вашем примере с StringUtils лучше всего подойдут функции верхнего уровня:

// StringUtils.kt
fun String?.isEmptyOrBlank(): Boolean = this == null || this.isBlank()
const val APP_NAME = "MyApp"

Такой код чище, проще для тестирования и более идиоматичен для Kotlin. Избегайте создания классов только ради статических методов — используйте файлы с функциями.

inline fun <reified T> T?.orThrow(message: String): T {
    return this ?: throw IllegalArgumentException(message)
}

// Использование
val name: String? = null
val safeName = name.orThrow("Name cannot be null") // Выбросит исключение

@JvmOverloads
fun createUser(name: String, age: Int = 18): User {
    return User(name, age)
}