Gonull: Пакет Go для удобной работы с нулевыми значениями

При работе с базами данных и JSON разработчики часто сталкиваются с проблемой управления нулевыми значениями. Нулевые значения могут быть очень неприятными. При неправильной обработке они могут приводить к неожиданным ошибкам и часто требуют дополнительных проверок в коде. Для решения этой проблемы был создан пакет gonull с открытым исходным кодом.

Что такое gonull?

Gonull предоставляет общий тип Nullable для приложений на языке Go. Его основное назначение - упростить процесс работы с нулевыми значениями, особенно при работе с базами данных и JSON.

Основные характеристики:

• Общий нулевой тип: В основе gonull лежит тип Nullable, который может хранить нулевое значение любого заданного типа. Этот тип имеет два поля:

1. Val: Удерживает фактическое значение.
2. Valid: Флаг, указывающий, было ли установлено значение или нет.
   

• Простота создания: С помощью функции NewNullable можно быстро создать новый Nullable с начальным значением. При этом также устанавливается флаг Valid на значение true.
• Интеграция с базами данных: gonull позволяет легко интегрировать нулевые значения с database/sql. Методы Scan и Value позволяют типу Nullable выступать в качестве нулевого поля в операциях с базами данных.
  
• Операции с JSON: Пакет предоставляет встроенные методы (UnmarshalJSON и MarshalJSON) для обработки сериализации и десериализации нулевых значений при работе с данными JSON.
  

Как это работает?

Рассмотрим сценарий, в котором необходимо представить человека (Person) с опциональными полями, такими как Age, Address и Height (возраст, адрес и рост). Эти поля могут иметь или не иметь значения, и при сериализации в JSON они должны быть представлены корректно (либо со своим значением, либо с null).

Приведем простой пример с использованием пакета gonull:

package main

import (
    "encoding/json"
    "fmt"

    "github.com/lomsa-dev/gonull"
)

type MyCustomInt int
type MyCustomFloat32 float32

type Person struct {
    Name    string
    Age     gonull.Nullable[MyCustomInt]
    Address gonull.Nullable[string]
    Height  gonull.Nullable[MyCustomFloat32]
}

func main() {
    jsonData := []byte(`{"Name":"Alice","Age":15,"Address":null,"Height":null}`)

    var person Person
    err := json.Unmarshal(jsonData, &person)
    if err != nil {
        panic(err)
    }
    fmt.Printf("Unmarshalled Person: %+v\n", person)

    marshalledData, err := json.Marshal(person)
    if err != nil {
        panic(err)
    }
    fmt.Printf("Marshalled JSON: %s\n", string(marshalledData))
}

В приведенном примере поля Age, Address и Height структуры Person имеют тип Nullable. Когда мы раскрываем JSON-данные, эти поля корректно интерпретируют значения JSON, в том числе распознают нулевые значения. При обратном маршалинге в JSON поля, которые не заданы (или недействительны), представляются как нулевые.