Методы парсинга и валидации

Processor предоставляет функциональность парсинга JSON и проверки валидности. Чтение/запись файлов и потоковая загрузка описаны в разделе Файловый ввод-вывод.

Методы валидации

Valid

Сигнатура: func (p *Processor) Valid(jsonStr string, cfg ...Config) (bool, error)

Проверяет, является ли строка JSON валидной.

valid, err := p.Valid(data)
if valid && err == nil {
    // Валидный JSON
}

ValidBytes

Сигнатура: func (p *Processor) ValidBytes(data []byte) bool

Проверяет, является ли байтовый срез валидным JSON.

if p.ValidBytes([]byte(data)) {
    // Валидный JSON
}

Методы парсинга

Parse

Сигнатура: func (p *Processor) Parse(jsonStr string, target any, cfg ...Config) error

Парсит строку JSON в целевую переменную. Поддерживает стандартный режим и режим сохранения чисел.

// Парсинг в map
var obj map[string]any
err := p.Parse(`{"name":"Alice"}`, &obj)

// Парсинг в структуру
type User struct { Name string }
var user User
err = p.Parse(`{"name":"Alice"}`, &user)

// Использование режима сохранения чисел
cfg := json.DefaultConfig()
cfg.PreserveNumbers = true
var data any
err = p.Parse(`{"price":19.99}`, &data, cfg)

ParseAny

Сигнатура: func (p *Processor) ParseAny(jsonStr string, cfg ...Config) (any, error)

Парсит строку JSON в тип any.

data, err := p.ParseAny(`{"name": "test"}`)
if err != nil {
    panic(err)
}

PreParse

Сигнатура: func (p *Processor) PreParse(jsonStr string, cfg ...Config) (*ParsedJSON, error)

Предварительно парсит JSON-данные для последующих многократных запросов к одним и тем же данным без повторного парсинга.

parsed, err := p.PreParse(jsonStr)
if err != nil {
    panic(err)
}

// Многократные запросы к распарсенным данным
name, _ := p.GetFromParsed(parsed, "user.name")
age, _ := p.GetFromParsed(parsed, "user.age")

GetFromParsed

Сигнатура: func (p *Processor) GetFromParsed(parsed *ParsedJSON, path string, cfg ...Config) (any, error)

Получает значение из предварительно распарсенных данных. Используется вместе с PreParse для повышения производительности многократных запросов.

SetFromParsed

Сигнатура: func (p *Processor) SetFromParsed(parsed *ParsedJSON, path string, value any, cfg ...Config) (*ParsedJSON, error)

Устанавливает значение в предварительно распарсенных данных, возвращает новый ParsedJSON.

parsed, _ := p.PreParse(jsonStr)
newParsed, err := p.SetFromParsed(parsed, "user.name", "Bob")

Выбор метода

Сценарий	Рекомендуемый метод
Только проверка валидности	Valid / ValidBytes
Парсинг в целевую переменную	Parse
Многократные запросы к одним данным	PreParse + GetFromParsed

Связанные разделы

• Файловый ввод-вывод - файловые методы LoadFromFile/SaveToFile
• Методы вывода - методы кодирования Encode/EncodePretty
• Запросы по пути - Методы Get