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

1. Использование toString() и fromString():
   Самый простой способ сериализации перечисления — использование методов toString()и fromString(). Метод toString()преобразует значение перечисления в строковое представление, а метод fromString()выполняет обратную операцию, преобразуя строку обратно в соответствующее значение перечисления. Вот пример:

enum class Color {
    RED, GREEN, BLUE
}
fun main() {
    val colorString = Color.RED.toString()
    println(colorString) // Output: "RED"

    val colorEnum = Color.valueOf("GREEN")
    println(colorEnum) // Output: Color.GREEN
}

1. Использование порядковых значений.
   Свойство ordinalперечисления представляет его положение в классе перечисления. Мы можем сериализовать перечисление, сохранив его порядковый номер, и десериализовать его, получив значение перечисления на основе сохраненного порядкового значения. Однако важно отметить, что порядковые значения могут измениться, если изменить порядок объявления перечисления. Вот пример:

enum class Size {
    SMALL, MEDIUM, LARGE
}
fun main() {
    val sizeOrdinal = Size.MEDIUM.ordinal
    println(sizeOrdinal) // Output: 1

    val sizeEnum = Size.values()[2]
    println(sizeEnum) // Output: Size.LARGE
}

1. Использование пользовательских свойств.
   Перечисления в Kotlin могут иметь свойства, как и классы. Мы можем определить пользовательское свойство для перечисления, которое содержит значение, подходящее для сериализации. Это позволяет нам лучше контролировать сериализованное представление. Вот пример:

enum class Planet(val mass: Double, val radius: Double) {
    EARTH(5.97e24, 6.37e6),
    MARS(6.39e23, 3.37e6)
}
fun main() {
    val earthMass = Planet.EARTH.mass
    println(earthMass) // Output: 5.97e24

    val marsRadius = Planet.valueOf("MARS").radius
    println(marsRadius) // Output: 3.37e6
}

1. Использование внешних библиотек.
   Если вам требуются более сложные параметры сериализации, вы можете использовать внешние библиотеки, такие как Gson, Jackson или kotlinx.serialization. Эти библиотеки предоставляют мощные функции для сериализации и десериализации перечислений, включая настройку и обработку вложенных объектов. Вот пример использования Gson:

import com.google.gson.Gson
enum class Country {
    USA, CANADA, INDIA
}
fun main() {
    val gson = Gson()

    val countryJson = gson.toJson(Country.USA)
    println(countryJson) // Output: "USA"

    val countryEnum = gson.fromJson("\"INDIA\"", Country::class.java)
    println(countryEnum) // Output: Country.INDIA
}

Сериализация перечислений Kotlin является общим требованием во многих приложениях. В этой статье мы рассмотрели несколько методов достижения этой цели: от базовых строковых представлений до расширенных библиотек сериализации. Понимая эти методы, вы сможете эффективно сериализовать и десериализовать перечисления в соответствии с вашими конкретными потребностями.