Redis X Java入門。RedisのインストールからクライアントライブラリJedisの使い方まで

Redistとは、永続化機能を備えたKVSです。
http://redis.io/
インターフェースはmemcachedとほぼ同じですが、Redisの方が永続化も含めてできることが多いので摘要できるところはいろいろありそうです。
とりあえず、co-meetingのセッション管理に使うことにしたので、Hello Worldまでのメモを残しておきます。

インストール方法

2011年9月1日現在のUbuntu 10.10のリポジトリでインストールされるRedisのバージョンは2.0.0-rc2-1です。
rcなのが気になりますが、古くはないのでとりあえずapt-getでインストールしてみました。

$　sudo apt-get install redis-server

telnetで動作を確認

Redisの動作をすぐに確認するには、telnetでコマンドを打つの手っ取り早いです。
http://try.redis-db.com/でもコマンドを試せます。

コマンドの一覧はこちら
http://redis.io/commands

文字列の追加/削除をtelnetから試してみます。Redisのデフォルトポートは6379です。

$ telnet localhost 6379

set mykey 5   <- setコマンドで文字列を保存します。パラメータに文字列長を指定していますが、
Hello            新しいバージョンでは直接文字列を指定できるようになっています。(http://redis.io/commands/set)
+OK
keys *        <- keysコマンドは保存されているキーを確認することができます。 
*1　　　　　　　　　ここではすべてのキーを表示しています。(http://redis.io/commands/keys)
$5
mykey
get mykey     <- getにキーを指定して文字列を取得。(http://redis.io/commands/get)
$5
Hello
del mykey     <- getで削除。(http://redis.io/commands/del)
:1
keys *
*0

Javaのクライアントライブラリ

クライアントライブラリは非常にたくさんあります。
http://redis.io/clients
Javaだけでも4つ

• Jedis: ★ Repository xetorthio
• JRedis: Repository Homepage SunOf27
• JDBC-Redis: Repository Homepage mavcunha
• RJC: Repository e_mzungu

スターがついているのがおすすめだそうなので、今回、おすすめにもなっているJedisを試してみました。

また、stackoverflowのQA「Best Redis library for Java」でも、JDBCは遅いからJedisかJRedisを使った方がいいと書いてあります。

Jedisの入手と環境構築

JedisはGithubにて公開されています。
https://github.com/xetorthio/jedis
[Downloads]からjedis-2.0.0.jarをダウンロードできます。

Jedisのpom.xmlを見ると以下の2つ依存ライブラリがあります。

• junit 4.8.1
• commons-pool 1.5.5

実行時にはcommons-poolのみクラスパスに含める必要があります。

Jedisの使い方

ライブラリの使い方はWikiに詳しく載っています。
telnetで試した操作を一通り再現するとこんな感じです。

import redis.clients.jedis.Jedis;
import redis.clients.jedis.JedisPool;
import redis.clients.jedis.JedisPoolConfig;

public class HelloJedis {

	/**
	 * @param args
	 */
	public static void main(String[] args) {
		JedisPool pool = new JedisPool(new JedisPoolConfig(), "localhost");
		Jedis jedis = pool.getResource();
		try {
		  jedis.set("mykey", "Hello");
		  System.out.println(jedis.keys("*"));
		  System.out.println(jedis.get("mykey"));
		  jedis.del("mykey");
		  System.out.println(jedis.keys("*"));
		} finally {
		  pool.returnResource(jedis);
		}
		pool.destroy();
	}

}

実行結果

[mykey]
Hello
[]