はじめに

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の様々なユーティリティ関数の使い方を見ました。