JSON|JSON
#
// Go предлагает встроенную поддержку кодирования и
// декодирования JSON, в том числе встроенных и
// пользовательских типов данных.
package main
import (
"encoding/json"
"fmt"
"os"
)
// Мы будем использовать эти две структуры, для демонстрации
// кодирования и декодирования.
type response1 struct {
Page int
Fruits []string
}
// Только экспортируемые поля могут быть кодированы и
// декодированы в JSON. Поля должны начинаться с
// заглавной буквы.
type response2 struct {
Page int `json:"page"`
Fruits []string `json:"fruits"`
}
func main() {
// Для начала мы рассмотрим кодирование данных в
// JSON строку. Вот несколько примеров для простых
// типов данных.
bolB, _ := json.Marshal(true)
fmt.Println(string(bolB))
intB, _ := json.Marshal(1)
fmt.Println(string(intB))
fltB, _ := json.Marshal(2.34)
fmt.Println(string(fltB))
strB, _ := json.Marshal("gopher")
fmt.Println(string(strB))
// А вот примеры для срезов и карт, которые кодируются
// в JSON массивы и объекты, как мы и ожидаем.
slcD := []string{"apple", "peach", "pear"}
slcB, _ := json.Marshal(slcD)
fmt.Println(string(slcB))
mapD := map[string]int{"apple": 5, "lettuce": 7}
mapB, _ := json.Marshal(mapD)
fmt.Println(string(mapB))
// Пакет JSON может автоматически кодировать ваши
// пользовательские типы данных. Он будет включать
// только экспортируемые поля в закодированный
// вывод и по умолчанию будет использовать эти
// имена в качестве ключей JSON.
res1D := &response1{
Page: 1,
Fruits: []string{"apple", "peach", "pear"}}
res1B, _ := json.Marshal(res1D)
fmt.Println(string(res1B))
// Вы можете использовать теги в объявлениях
// структурных полей для настройки кодированных имен
// ключей JSON. Проверьте определение `response2`
// выше, чтобы увидеть пример таких тегов.
res2D := &response2{
Page: 1,
Fruits: []string{"apple", "peach", "pear"}}
res2B, _ := json.Marshal(res2D)
fmt.Println(string(res2B))
// Теперь давайте рассмотрим декодирование данных
// JSON в значения Go. Вот пример для общей
// структуры данных.
byt := []byte(`{"num":6.13,"strs":["a","b"]}`)
// Нам нужно предоставить переменную, в которую пакет
// JSON может поместить декодированные данные.
// `map[string]interface{} будет содержать карту
// строк для произвольных типов данных.
var dat map[string]interface{}
// Вот фактическое декодирование и проверка на наличие
// ошибок.
if err := json.Unmarshal(byt, &dat); err != nil {
panic(err)
}
fmt.Println(dat)
// Чтобы использовать значения в декодированной карте,
// нам нужно преобразовать их в соответствующий тип.
// Например, здесь мы конвертируем значение из `num`
// в ожидаемый тип `float64`.
num := dat["num"].(float64)
fmt.Println(num)
// Доступ к вложенным данным требует ряда преобразований.
strs := dat["strs"].([]interface{})
str1 := strs[0].(string)
fmt.Println(str1)
// Мы также можем декодировать JSON в пользовательские
// типы данных. Это дает преимущество добавления
// дополнительной безопасности типов в наши программы
// и устранения необходимости в определении типрв
// при доступе к декодированным данным.
str := `{"page": 1, "fruits": ["apple", "peach"]}`
res := response2{}
json.Unmarshal([]byte(str), &res)
fmt.Println(res)
fmt.Println(res.Fruits[0])
// В приведенных выше примерах мы всегда использовали
// байты и строки в качестве промежуточных звеньев между
// данными и представлением JSON на стандартном выходе.
// Мы также можем транслировать JSON-кодировки напрямую
// в `os.Writer`, такие как `os.Stdout` или даже HTTP-тела
// ответа.
enc := json.NewEncoder(os.Stdout)
d := map[string]int{"apple": 5, "lettuce": 7}
enc.Encode(d)
}
$ go run json.go
true
1
2.34
"gopher"
["apple","peach","pear"]
{"apple":5,"lettuce":7}
{"Page":1,"Fruits":["apple","peach","pear"]}
{"page":1,"fruits":["apple","peach","pear"]}
map[num:6.13 strs:[a b]]
6.13
a
{1 [apple peach]}
apple
{"apple":5,"lettuce":7}
# Мы рассмотрели основы JSON в Go, но ознакомьтесь с
# публикацией в блоге [JSON and Go](http://blog.golang.org/2011/01/json-and-go.html)
# и документацией по [пакету JSON](http://golang.org/pkg/encoding/json/).