Методы файлового ввода-вывода

Processor предоставляет методы чтения/записи JSON-файлов и потоковой загрузки, охватывающие файлы, io.Reader и io.Writer.

Загрузка из файла

LoadFromFile

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

Загружает JSON-данные из файла и возвращает исходную строку.

data, err := p.LoadFromFile("config.json")
if err != nil {
    panic(err)
}
fmt.Println(data) // Исходная строка JSON

LoadFromFileAsData (приватизировано)

Изменение API

LoadFromFileAsData преобразован во внутренний метод (loadFromFileAsData) и больше не экспортируется как публичный API. Используйте комбинацию LoadFromFile + Parse:

jsonStr, err := p.LoadFromFile("data.json")
if err != nil {
    panic(err)
}
var data any
err = p.Parse(jsonStr, &data)
// data имеет тип map[string]any или []any
if obj, ok := data.(map[string]any); ok {
    fmt.Println(obj["name"])
}

Загрузка из Reader

LoadFromReader

Сигнатура: func (p *Processor) LoadFromReader(reader io.Reader, cfg ...Config) (string, error)

Загружает JSON-данные из Reader и возвращает исходную строку.

file, _ := os.Open("data.json")
defer file.Close()

data, err := p.LoadFromReader(file)
if err != nil {
    panic(err)
}

LoadFromReaderAsData (приватизировано)

Изменение API

LoadFromReaderAsData преобразован во внутренний метод (loadFromReaderAsData) и больше не экспортируется как публичный API. Используйте комбинацию LoadFromReader + Parse:

file, _ := os.Open("data.json")
defer file.Close()

jsonStr, err := p.LoadFromReader(file)
if err != nil {
    panic(err)
}
var data any
err = p.Parse(jsonStr, &data)

Запись в файл

SaveToFile

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

Сохраняет данные как JSON-файл. Автоматически создаёт родительские каталоги.

err := p.SaveToFile("data.json", map[string]any{"name": "CyberGo"})

// Сохранение с форматированием используя PrettyConfig
err = p.SaveToFile("data.json", data, json.PrettyConfig())

MarshalToFile

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

Кодирует данные в JSON и записывает в файл. Автоматически создаёт родительские каталоги.

err := p.MarshalToFile("output.json", data)

// Форматированное сохранение
err = p.MarshalToFile("output.json", data, json.PrettyConfig())

UnmarshalFromFile

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

Читает JSON из файла и декодирует в целевую переменную.

var config Config
err := p.UnmarshalFromFile("config.json", &config)
if err != nil {
    panic(err)
}

SaveToWriter

Сигнатура: func (p *Processor) SaveToWriter(writer io.Writer, data any, cfg ...Config) error

Кодирует данные в JSON и записывает в io.Writer.

var buf bytes.Buffer
err := p.SaveToWriter(&buf, data, json.PrettyConfig())

Выбор метода

Сценарий	Рекомендуемый метод
Нужна исходная строка	LoadFromFile / LoadFromReader
Нужны распарсенные данные	LoadFromFile + Parse / LoadFromReader + Parse
Сохранение данных в файл	SaveToFile / MarshalToFile
Запись в Writer	SaveToWriter
Чтение из файла и декодирование	UnmarshalFromFile

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

• Парсинг и валидация - методы Parse/Valid
• Файловые функции - файловые функции уровня пакета