Go Academy · Урок

Практическая рефлексия: сериализаторы

Создание простого сериализатора в стиле JSON с помощью reflect

«Практическая рефлексия: сериализаторы» — бесплатный урок Go Academy на CoddyKit. Это урок 4 из 4. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения Go Academy, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс Go Academy содержит 4 уроков всего.

Обзор пользовательского сериализатора JSON

Создание пользовательского сериализатора с помощью отражения демонстрирует практическое применение отражения: перебор полей структуры, чтение тегов, доступ к значениям и формирование результата — тот же подход используется внутри encoding/json.

Простое преобразование структуры в карту

Преобразуйте структуру в map[string]any с помощью отражения:

func StructToMap(v any) map[string]any {
    t := reflect.TypeOf(v)
    val := reflect.ValueOf(v)
    result := make(map[string]any, t.NumField())
    for i := 0; i < t.NumField(); i++ {
        f := t.Field(i)
        if !f.IsExported() { continue }
        key := f.Tag.Get("json")
        if key == "" { key = f.Name }
        result[key] = val.Field(i).Interface()
    }
    return result
}

Работа с указателями

Разыменовывайте поля-указатели перед чтением их значений:

fv := val.Field(i)
if fv.Kind() == reflect.Ptr {
    if fv.IsNil() { continue }
    fv = fv.Elem()
}

Работа с вложенными структурами

Рекурсивно обрабатывайте вложенные поля структур:

if fv.Kind() == reflect.Struct {
    result[key] = StructToMap(fv.Interface())
    continue
}

Поддержка omitempty

Пропускайте поля с нулевыми значениями, если тег содержит "omitempty":

if strings.Contains(tag, "omitempty") && fv.IsZero() { continue }

Преобразование карты в структуру (десериализация)

Заполните структуру из карты, сопоставляя ключи карты с тегами полей:

func MapToStruct(m map[string]any, dest any) {
    t := reflect.TypeOf(dest).Elem()
    v := reflect.ValueOf(dest).Elem()
    for i := 0; i < t.NumField(); i++ {
        key := t.Field(i).Tag.Get("json")
        if val, ok := m[key]; ok {
            v.Field(i).Set(reflect.ValueOf(val))
        }
    }
}

Приведение типов

Значения карт, полученных из JSON, для чисел часто имеют тип float64. При установке приводите их к типу целевого поля:

if f.Type.Kind() == reflect.Int && reflect.TypeOf(val).Kind() == reflect.Float64 {
    v.Field(i).SetInt(int64(val.(float64)))
}

Кэширование метаданных полей

Кэшируйте сопоставление полей и тегов в sync.Map с ключом reflect.Type, чтобы избежать повторного отражения при каждом вызове сериализации.

Альтернатива в виде генерации кода

Для критичных к производительности участков создавайте сериализаторы для конкретных типов с помощью таких инструментов, как easyjson или ffjson. Они полностью исключают отражение во время выполнения.

Когда создавать пользовательские сериализаторы

Пользовательские сериализаторы полезны для форматов, отличных от JSON (BSON, Avro, CSV), особых правил кодирования или жёстких требований к производительности. Для большинства сценариев достаточно encoding/json.

Тестирование сериализатора

Проверка полного цикла: сериализуйте структуру в карту, десериализуйте обратно и убедитесь, что значения совпадают с исходными:

u := User{Name: "Alice", Age: 30}
m := StructToMap(u)
var u2 User
MapToStruct(m, &u2)
assert.Equal(t, u, u2)

Быстрая проверка

Почему важно кэшировать метаданные полей при создании сериализатора на основе отражения?

Итоги: сериализаторы на основе отражения

Ключевые моменты:

Перебирайте поля с помощью NumField/Field; читайте теги с помощью Tag.Get
Обрабатывайте указатели, вложенные структуры и нулевые значения
Кэшируйте метаданные полей в sync.Map для повышения производительности
Для максимальной пропускной способности используйте генерацию кода

Часто задаваемые вопросы

Урок «Практическая рефлексия: сериализаторы» бесплатный?

Да — полный текст урока «Практическая рефлексия: сериализаторы» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс Go Academy, подпишись на CoddyKit PRO. Курс Go Academy содержит 4 уроков всего.

Чему я научусь в уроке «Практическая рефлексия: сериализаторы»?

Создание простого сериализатора в стиле JSON с помощью reflect Ты практикуешь Go Academy с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.

Нужен ли мне опыт, чтобы начать Go Academy?

Предыдущий опыт не требуется. Go Academy на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 4 из 4.

Сколько времени занимает урок «Практическая рефлексия: сериализаторы»?

Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.

Можно ли писать и запускать код в этом уроке Go Academy?

Да. Каждый урок Go Academy включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.

Все уроки этого курса

← Назад к Go Academy