Sealed Class — какво е това, принцип на работа и приложение

Какво е Sealed Class?

Sealed Class (запечатан клас) — това е клас в Kotlin, маркиран с модификатора sealed. Той дефинира ограничена йерархия от типове: всички възможни наследници са изброени в същия файл и компилаторът знае за всеки от тях. Това отличава sealed class от обикновения отворен клас, чиито наследници могат да бъдат декларирани навсякъде.

Основната цел на sealed class е типобезопасно представяне на краен набор от варианти. Всеки наследник може да има собствена структура от данни, което прави sealed class по-гъвкав от enum. По време на изпълнение sealed class е обикновен абстрактен клас, компилаторът налага ограничения само на етапа на компилиране.

Sealed class е особено полезен в архитектурата на Android приложения: UI състояния, резултати от мрежови заявки, Intent-подобни навигационни събития и, разбира се, йерархии от грешки — типични сценарии на приложение.

При компилиране sealed class се оптимизира до таблица за преход за when изрази, което го прави по-ефективен от if-else вериги. В комбинация с data class всеки наследник може да съдържа не само състояние, но и методи, което позволява изграждането на самодокументиращи се домейн модели без boilerplate код.

Sealed class е също ефективен за представяне на крайни автомати (state machine) в мобилни приложения. Всяко състояние — отделен наследник с уникални параметри, а преходите между състоянията се контролират чрез when израза. Компилаторът гарантира, че всички възможни състояния са обработени, което елиминира грешки по време на изпълнение при промяна на UI състояние или бизнес логика.

Sealed Class и Enum: ключови разлики

Начинаещите програмисти на Kotlin често бъркат sealed class с enum, тъй като и двата ограничават набора от стойности. Но съществува фундаментална разлика между тях: enum — набор от константи от един тип, sealed class — йерархия от различни типове.

Кога да изберете enum

Enum е оптимален, когато всички варианти са константи без допълнителна структура. Например дните от седмицата, статуси на поръчка или типове действия без параметри. Всяка enum стойност е singleton с фиксирано име.

Кога да изберете sealed class

Sealed class е необходим, когато всеки вариант има собствени данни. Например мрежова грешка съдържа код на отговор, грешка при парсиране — детайли, а грешка при авторизация — съобщение. Всеки наследник на sealed class е отделен тип с уникални полета.

// Enum — всички варианти от един тип
enum class Status { LOADING, SUCCESS, ERROR }

// Sealed class — всеки вариант със свои данни
sealed class UiState<out T> {
    object Loading : UiState<Nothing>()
    data class Success<T>(val data: T) : UiState<T>()
    data class Error(val message: String) : UiState<Nothing>()
}

Sealed Interface срещу Sealed Class

От Kotlin 1.5 съществува възможност за деклариране на sealed interface. Това разширява концепцията sealed към интерфейси: sealed interface също има фиксиран набор от имплементации, но поддържа множествено наследяване.

Кога да използвате sealed interface

Sealed interface е удобен, когато наследниците трябва да имплементират множество договори едновременно. Например UI събитие може да бъде едновременно кликаемо и проследимо. С sealed class трябваше да изберете един базов клас, с sealed interface наследникът имплементира и двата.

Ограничения на sealed class

Sealed class е клас, така че всеки наследник може да има само един родител. Sealed interface решава този проблем, но не може да съдържа състояние. Изборът между тях зависи от задачата: нужна е обща логика с полета — sealed class, нужна е гъвкавост на договорите — sealed interface.

sealed interface ScreenEvent {
    data class Refresh(val force: Boolean) : ScreenEvent
    data class Navigate(val route: String) : ScreenEvent
    data class ShowError(val toast: String) : ScreenEvent
}

sealed interface AnalyticsEvent {
    val name: String
    val params: Map<String, Any>
}

// Наследникът имплементира и двата интерфейса
data class LoginClicked(
    override val name: String = "login_click",
    override val params: Map<String, Any> = emptyMap()
) : ScreenEvent, AnalyticsEvent

Sealed Class за йерархия от грешки в мобилната разработка

Едно от основните приложения на sealed class в мобилната разработка — типобезопасна йерархия от грешки. Вместо да хвърляте изключения от различни типове или да използвате общ Exception, sealed class събира всички възможни домейн грешки в един тип.

Как да изградите йерархия от грешки

Създайте sealed class DomainError и избройте всички видове повреди като наследници. Всеки наследник съдържа само данните, които имат смисъл за този тип грешка. Компилаторът гарантира, че при обработка на грешката няма да забравите нито един вариант.

Пример: обработка на грешки при автентикация

Разгледайте приложение с авторизация, където са възможни различни сценарии на повреда: грешна парола, блокиране на акаунт, проблем със сървъра. Sealed class ги обединява в един тип с изчерпателна обработка.

sealed class AuthError {
    data class InvalidCredentials(
        val attempts: Int
    ) : AuthError()

    data class AccountBlocked(
        val until: Long
    ) : AuthError()

    data class NetworkFailure(
        val cause: Throwable
    ) : AuthError()

    object ServerError : AuthError()
}

fun handleError(error: AuthError): String = when (error) {
    is AuthError.InvalidCredentials ->
        "Оставащи опити: ${3 - error.attempts}"
    is AuthError.AccountBlocked ->
        "Достъпът е блокиран до ${Date(error.until)}"
    is AuthError.NetworkFailure ->
        "Проверете връзката: ${error.cause.localizedMessage}"
    AuthError.ServerError ->
        "Сървърът е временно недостъпен"
}

Модели на използване на Sealed Class в Android

Sealed class се превърна в стандартен инструмент в архитектурата на Android приложения. Нека разгледаме три ключови модела, където sealed class е незаменим в мобилната разработка.

• UI State — представяне на екрана като краен автомат: Loading, Content, Error. Всяко състояние съдържа свои данни, а sealed class гарантира, че всички преходи са обработени.
• Navigation Event — sealed class вместо навигационни константи: всеки екран е отделен наследник с параметри на маршрута. Компилаторът проверява типовете на аргументите.
• Action/Intent — моделът Unidirectional Data Flow използва sealed class за представяне на всички действия, които потребителят може да извърши на екрана.

Отделно заслужава да се спомене приложението на sealed class в Clean Architecture. Всеки слой (data, domain, presentation) използва sealed class за своите типове грешки, а mapper-ите преобразуват един sealed class в друг. Например DataError от слоя данни се мапва към DomainError за бизнес логиката, а след това към UiState за презентационния слой. Това запазва типовата безопасност на всички нива на приложението и гарантира, че никоя грешка няма да остане необработена.

Тестване на sealed class йерархии

Тестването на sealed class изисква специален подход, тъй като всеки наследник е отделен тип със собствено състояние. Препоръчва се писане на параметризирани тестове, които преминават през всички наследници на sealed class. Това гарантира, че when изразите покриват всички варианти, включително новите, добавени при разширяване на йерархията.

За UI тестове sealed class като UiState позволява проверка на визуализацията на всяко състояние: Loading показва спинър, Content — данни, Error — съобщение за грешка. Тъй като sealed class е краен, тестовото покритие на всички състояния дава пълна увереност в коректността на UI логиката.

Типични грешки при работа с Sealed Class

Въпреки простотата на концепцията, програмистите редовно допускат грешки при проектирането на sealed class йерархии. Нека разгледаме основните проблеми и начините за избягването им.

• Наследници в различни файлове — компилаторът няма да позволи деклариране на sealed class, ако наследниците са извън файла. Това ограничение гарантира изчерпателен when.
• Смесване на sealed и open — sealed class не може да бъде едновременно open. Ако е необходима разширяема йерархия, използвайте обикновен abstract class, но ще пожертвате изчерпателността.
• Прекомерно влагане — sealed class в sealed class създава дълбока йерархия, която е трудна за поддръжка. За прости сценарии две нива са достатъчни.
• Забравен else в when — ако sealed class от библиотека няма изчерпателност, компилаторът няма да предупреди за пропуснато разклонение. Добавяйте else само съзнателно.