Go によるサンプル: JSON

Go では、組み込みデータ型およびカスタムデータ型との間での JSON のエンコーディングとデコードが組み込みでサポートされています。

 
package main
 
import (
    "encoding/json"
    "fmt"
    "os"
)

カスタムタイプのエンコーディングとデコードを以下に示す 2 つの構造体を使用します。

 
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.Writable` (例: `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}

ここでは Go における JSON の基本について説明しましたが、JSON and Go のブログ投稿と JSON パッケージのドキュメント でさらに詳細をご覧ください。

次のサンプル: XML。

by Mark McGranaghan および Eli Bendersky | ソース | ライセンス