はじめに

Go言語向けクライアントライブラリRedigoの使い方を見ます。
Redigoでは、簡潔なコーディングのための様々なユーティリティ関数が提供されています。主なものの使い方を紹介します。

環境

OS: Windows 10
Redis: win-3.2.100
Go言語: 1.11

変数へ変換

サーバからの応答をGoの様々な型に変換する関数です。

整数型に変換するにはIntやInt64やUint64を用います。例えばRedisの文字列型で保存した数値をGETでとるときや、LLENなどの応答に使います。また、浮動小数点型に変換するにはFloat64、文字列型に変換するにはString、バイトスライスに変換するにはBytesを使います。

    var n int
    _, _ = conn.Do("SET", "money", "1000")
    n, _ = redis.Int(conn.Do("GET", "money"))
    fmt.Println(n) // 1000

    _, _ = conn.Do("RPUSH", "city", "tokyo")
    n, _ = redis.Int(conn.Do("LLEN", "city"))
    fmt.Println(n) // 1

    var f float64
    _, _ = conn.Do("SET", "temperature", "25.6")
    f, _ = redis.Float64(conn.Do("GET", "temperature"))
    fmt.Println(f) // 25.6

    var s string
    _, _ = conn.Do("SET", "weather", "rainy")
    s, _ = redis.String(conn.Do("GET", "weather"))
    fmt.Println(s) // rainy

    var b []byte
    _, _ = conn.Do("SET", "alphabet", "abc")
    b, _ = redis.Bytes(conn.Do("GET", "alphabet"))
    fmt.Println(b) // [97 98 99]

スライスへ変換

Redisサーバからの複数のリプライ（Multi bulk reply）をスライスに変換します。全てを同じ型に変換したいときは、Ints、Float64s、Strings、ByteSlicesなどが使えます。IntsやFloat64sは、一つでも型変換に失敗すればエラーが返ります。

    var n []int
    _, _ = conn.Do("MSET", "width", "640", "height", "480")
    n, err = redis.Ints(conn.Do("MGET", "width", "height"))
    fmt.Println(n) // [640 480]

    var f []float64
    _, _ = conn.Do("MSET", "temperature", "25.6", "humidity", "10.3")
    f, _ = redis.Float64s(conn.Do("MGET", "temperature", "humidity"))
    fmt.Println(f) // [25.6 10.3]

    var s []string
    _, _ = conn.Do("RPUSH", "city", "tokyo")
    _, _ = conn.Do("RPUSH", "city", "osaka")
    s, _ = redis.Strings(conn.Do("LRANGE", "city", 0, -1))
    fmt.Println(s) // [tokyo osaka]

    var b [][]byte
    _, _ = conn.Do("RPUSH", "alphabet", "abc")
    _, _ = conn.Do("RPUSH", "alphabet", "def")
    b, _ = redis.ByteSlices(conn.Do("LRANGE", "alphabet", 0, -1))
    fmt.Println(b) // [[97 98 99] [100 101 102]]

また異なる型が混ざっているときは、Valuesでinterface{}のスライスに変換させることができます。さらにまとめて変換するにはScanが便利です。

    var weight int
    var eyesight float64
    var blood string
    var v []interface{}
    _, _ = conn.Do("SET", "weight", "60")
    _, _ = conn.Do("SET", "eyesight", "1.5")
    _, _ = conn.Do("SET", "blood", "A")
    v, _ = redis.Values(conn.Do("MGET", "weight", "eyesight", "blood"))
    v, _ = redis.Scan(v, &weight, &eyesight, &blood)
    fmt.Println(weight, eyesight, blood) // 60 1.5 A

マップへ変換

HGETALL（ハッシュ型の全てのフィールド名と値のペアを得る）の応答では、フィールド名と値が交互に現れます。これをマップに変換するための関数も用意されています。

    var m map[string]string
    _, _ = conn.Do("HSET", "profile", "name", "yamada")
    _, _ = conn.Do("HSET", "profile", "age", "30")
    _, _ = conn.Do("HSET", "profile", "country", "america")
    m, _ = redis.StringMap(conn.Do("HGETALL", "profile"))
    fmt.Println(m) // map[name:yamada age:30 country:america]

    var p map[string]int
    _, _ = conn.Do("HSET", "cpu", "sys", "10")
    _, _ = conn.Do("HSET", "cpu", "usr", "20")
    _, _ = conn.Do("HSET", "cpu", "wai", "30")
    p, _ = redis.IntMap(conn.Do("HGETALL", "cpu"))
    fmt.Println(p) // map[usr:20 wai:30 sys:10]

構造体へ変換

HGETALLの結果を構造体に変換することもできます。構造体の定義のところで「redis」タグでフィールド名を指定し、Valuesで得た結果をScanStructに与えます。

    var v []interface{}
    var p struct {
        Name    string `redis:"name"`
        Age     int    `redis:"age"`
        Country string `redis:"country"`
    }
    _, _ = conn.Do("HSET", "profile", "name", "yamada")
    _, _ = conn.Do("HSET", "profile", "age", "30")
    _, _ = conn.Do("HSET", "profile", "country", "america")
    v, _ = redis.Values(conn.Do("HGETALL", "profile"))
    _ = redis.ScanStruct(v, &p)
    fmt.Println(p) // {yamada 30 america}

おわりに

Redigoの様々なユーティリティ関数の使い方を見ました。