#1. Redis クライアントの概要
1.1. はじめに
Jedis Client は、Redis 公式 Web サイトが推奨する Java 指向のクライアントで、ライブラリ ファイルによってカプセル化と各種 API の呼び出しが実装されています。 Jedis ソース コード プロジェクト アドレス: https://github.com/xetorthio/jedis1.2.
Redis クライアントを使用するのが最善ですおよびサービス クライアントに対応するバージョン。この例では、Redis 2.8.19 が使用され、クライアントは jedis -2.6.3 を使用します。次の参照を Maven プロジェクトに追加するだけです。<dependency> <groupId>redis.clients</groupId> <artifactId>jedis</artifactId> <version>2.6.3</version> <type>jar</type> <scope>compile</scope> </dependency>
1.3. 注意事項
Redis クライアントには多くのドッキング バージョンがあります。このプロジェクトでは現在、公式に推奨される Java ドッキング クライアントとして Jedis を使用しています。 Redis: このバージョンは API とのドッキングをサポートしており、コーディングでは古いインターフェイスの使用を避けるようにしてください。 Redis は現在、新バージョンへの移行期間中です。バージョン 3.0 はまだ安定していません。ただし、バージョン 3.0 は最新のクラスター機能を提供するため、安定バージョンがリリースされた後、バージョン 3.0 にアップグレードされる可能性があります。現在使用されている Jedis は、現在のバージョンの 3.0. API をサポートしています。 #2. Redis クライアントで一般的に使用される API2.1. 環境要件
言語: Java
JDK :1.7
Redis : 2.8.19 (安定版)
2.2. システムの使用法2.2.1. 接続の確立
通常の接続
Jedis jedis = new Jedis("localhost"); jedis.set("foo", "bar"); String value = jedis.get("foo"); System.out.println(value);
接続プール構成の設定
このメソッドは、redis 接続プール接続で使用される接続プール構成を取得するために使用されます。 Spring を通じて注入することもできます 対応する構成を構成するために、接続プールは接続プール管理に一般的に使用される org.apache.commons.pool2.impl.GenericObjectPoolConfig を使用します
構成ファイルは次のとおりです
#redis服务器ip # redis.ip=172.30.5.117 #redis服务器端口号# redis.port=6379 ###jedis##pool##config### #jedis的最大分配对象# jedis.pool.maxActive=1024 #jedis最大保存idel状态对象数 # jedis.pool.maxIdle=200 #jedis池没有对象返回时,最大等待时间 # jedis.pool.maxWait=1000 #jedis调用borrowObject方法时,是否进行有效检查# jedis.pool.testOnBorrow=true #jedis调用returnObject方法时,是否进行有效检查 # jedis.pool.testOnReturn=true
接続プール構成のインスタンス化コード (スプリング インジェクションを通じて構成することもできます):
/** * 获取化连接池配置 * @return JedisPoolConfig * */ private JedisPoolConfig getPoolConfig(){ if(config == null){ config = new JedisPoolConfig(); //最大连接数 config.setMaxTotal(Integer.valueOf(getResourceBundle().getString("redis.pool.maxTotal"))); //最大空闲连接数 config.setMaxIdle(Integer.valueOf(getResourceBundle().getString("redis.pool.maxIdle"))); //获取连接时的最大等待毫秒数(如果设置为阻塞时BlockWhenExhausted),如果超时就抛异常, 小于零:阻塞不确定的时间, 默认-1 config.setMaxWaitMillis(Long.valueOf(getResourceBundle().getString("redis.pool.maxWaitMillis"))); //在获取连接的时候检查有效性, 默认false config.setTestOnBorrow(Boolean.valueOf(getResourceBundle().getString("redis.pool.testOnBorrow"))); //在获取返回结果的时候检查有效性, 默认false config.setTestOnReturn(Boolean.valueOf(getResourceBundle().getString("redis.pool.testOnReturn"))); } return config; }
通常の接続プール接続
这里展示的是普通的连接池方式链接redis的方案,跟普通的数据库连接池的操作方式类似; /** * 初始化JedisPool * */ private void initJedisPool(){ if(pool == null){ //获取服务器IP地址 String ipStr = getResourceBundle().getString("redis.ip"); //获取服务器端口 int portStr = Integer.valueOf(getResourceBundle() .getString("redis.port")); //初始化连接池 pool = new JedisPool(getPoolConfig(), ipStr,portStr); } }
Sentinel 接続プール接続
この接続プールはRedis の Sentinel のマスター/スレーブ切り替えメカニズムは、サーバーのダウンタイムによりサーバーが切り替えられたときに、正しいサーバー接続を正しく取得できます。サーバーがこのデプロイメント戦略を採用する場合、この接続プールを使用して運用することをお勧めします。
private void initJedisSentinelPool(){ if(sentinelpool == null){ //监听器列表 Set<String> sentinels = new HashSet<String>(); //监听器1 sentinels.add(new HostAndPort("192.168.50.236", 26379).toString()); //监听器2 sentinels.add(new HostAndPort("192.168.50.237", 26379).toString()); //实际使用的时候在properties里配置即可:redis.sentinel.hostandports =192.168.50.236:26379,192.168.50.237:26379 getResourceBundle().getString("redis.sentinel.hostandports") //mastername是服务器上的master的名字,在master服务器的sentinel.conf中配置: //[sentinel monitor server-1M 192.168.50.236 6379 2] //中间的server-1M即为这里的masterName String masterName = getResourceBundle() .getString("redis.sentinel.masterName"); //初始化连接池 sentinelpool = new JedisSentinelPool(masterName, sentinels, getPoolConfig()); } }
ShardedJedisPool 接続プールのシャード接続
/** * 初始化ShardedJedisPool * Redis在容灾处理方面可以通过服务器端配置Master-Slave模式来实现。 * 而在分布式集群方面目前只能通过客户端工具来实现一致性哈希分布存储,即key分片存储。 * Redis可能会在3.0版本支持服务器端的分布存储 * */ private void initShardedJedisPool() { if (shardPool == null) { // 创建多个redis共享服务 String redis1Ip = getResourceBundle().getString("redis1.ip"); int redis1Port = Integer.valueOf(bundle.getString("redis.port")); JedisShardInfo jedisShardInfo1 = new JedisShardInfo(redis1Ip, redis1Port); String redis2Ip = getResourceBundle().getString("redis2.ip"); int redis2Port = Integer.valueOf(bundle.getString("redis.port")); JedisShardInfo jedisShardInfo2 = new JedisShardInfo(redis2Ip, redis2Port); List<JedisShardInfo> serverlist = new LinkedList<JedisShardInfo>(); serverlist.add(jedisShardInfo1); serverlist.add(jedisShardInfo2); // 初始化连接池 shardPool = new ShardedJedisPool(getPoolConfig(),serverlist); } }
読み取り/書き込み/削除操作
// 从池中获取一个Jedis对象 Jedis jedis = sentinelpool.getSentinelpoolResource(); String keys = "name"; // 删除key-value对象,如果key不存在则忽略此操作 jedis.del(keys); // 存数据 jedis.set(keys, "snowolf"); // 判断key是否存在,不存在返回false存在返回true jedis.exists(keys); // 取数据 String value = jedis.get(keys); // 释放对象池(3.0将抛弃该方法) sentinelpool.returnSentinelpoolResource(jedis);
3. サンプル コード
1. 文字列の単純な追加
// 从池中获取一个Jedis对象 JedisUtil.getInstance().STRINGS.append(key, value);
2. 価格時間ソート (価格と時間の SortSet が保存されている場合)
//レベル 2 ソート操作の実行 ()
String stPriceSet = “stPriceSet”;//stPriceSet价格的sortset列表名 String stTimeSet = “stTimeSet”; // stTimeSet时间的sortset列表名 Set<Tuple> sumSet = JedisUtilEx.getInstance() .getSortSetByPirceUpAndTimeDown(stPriceSet, stTimeSet); //排序以后可以重复获取上次排序结果(缓存时间10分钟) Set<Tuple> sumSet = JedisUtilEx.getInstance() getLastPirceUpAndTimeDownSet();
3. 価格時間ソート (提供される場合)価格と時間が保存されていること) SortSet)
//执行2级排序操作 String stPriceSet = “stPriceSet”;//stPriceSet价格的sortset列表名 String stTimeSet = “stTimeSet”; // stTimeSet时间的sortset列表名 Set<Tuple> sumSet = JedisUtilEx.getInstance() . getSortSetByPirceDownAndTimeDown (stPriceSet, stTimeSet); //排序以后可以重复获取上次排序结果(缓存时间10分钟) Set<Tuple> sumSet = JedisUtilEx.getInstance() getLastPirceDownAndTimeDownSet ();
4. JavaBeans をハッシュ テーブルに保存します
// bean继承至RedisBean JedisUtilEx.getInstance().setBeanToHash(bean);
5. ハッシュ テーブルから JavaBeans を読み取ります
//uuid为业务制定的唯一标识符规则(相当于主键) String uuid = “1”; //该ID是我们提前就知道的 //T继承至RedisBean; JedisUtilEx.getInstance().getBeanFromHash (uuid,Class<T> cls);
6. JavaBeanリストをハッシュにロード
//list中的bean继承至RedisBean List<T> beanList = …; JedisUtilEx.getInstance().setBeanListToHash(beanList); //异步版本的存储列表到hash JedisUtilEx.getInstance().setBeanListToHashSyn(beanList);
7. 共通操作処理例
//获取jedis引用 Jedis jedis = JedisUtil.getInstance().getJedis(); //执行业务以及调用jedis提供的接口功能 … jedis.hset(…); … //执行完成以后务必释放资源 JedisUtil.getInstance().returnJedis(jedis); //若以后不会使用JEDIS,需要关闭所有链接池 RedisConnetcion.destroyAllPools();
8. トランザクション実行処理
//获取连接资源 Jedis jd = JedisUtil.getInstance().getJedis(); //开启事务 Transaction ts = jd.multi(); //执行业务以及调用jedis提供的接口功能 … jedis.hset(…); … //执行事务 List<Object> list = ts.exec(); //释放资源 JedisUtil.getInstance().returnJedis(jd);
9. 非同期実行
//获取连接资源 Jedis jedis = JedisUtil.getInstance().getJedis(); //获取管道 Pipeline pipeline = jedis.pipelined(); //执行业务以及调用jedis提供的接口功能 … jedis.hset(…); … //提交并释放管道 pipeline.syncAndReturnAll(); //释放资源 JedisUtil.getInstance().returnJedis(jedis);
10. Jedis 命名規則の取得方法 Synthetic KEY
//获取类的唯一键值key,例如:User:1(User为class,1为uuid)其中user继承于Reidsbean JedisUtilEx.getInstance().getBeanKey(user); //另一种获取类的唯一键值key的方法 JedisUtilEx.getInstance().getBeanKey(String uuid,Class<T> cls); //获取bean对应的KEY(对应列的唯一键值key) JedisUtilEx.getInstance().getBeanKey(String uuid,Class<T> cls,String... fileds); //获取bean对应的KEY(集群key) JedisUtilEx.getInstance().getBeanKey(Class<T> cls,String... fileds);
4. jedis 操作コマンド:
1. 値操作のコマンド
exists(key):确认一个key是否存在 del(key):删除一个key type(key):返回值的类型 keys(pattern):返回满足给定pattern的所有key randomkey:随机返回key空间的一个key rename(oldname, newname):将key由oldname重命名为newname,若newname存在则删除newname表示的key dbsize:返回当前数据库中key的数目 expire:设定一个key的活动时间(s) ttl:获得一个key的活动时间 select(index):按索引查询 move(key, dbindex):将当前数据库中的key转移到有dbindex索引的数据库 flushdb:删除当前选择数据库中的所有key flushall:删除所有数据库中的所有key
2. 文字列操作のコマンド
set(key, value):给数据库中名称为key的string赋予值value get(key):返回数据库中名称为key的string的value getset(key, value):给名称为key的string赋予上一次的value mget(key1, key2,…, key N):返回库中多个string(它们的名称为key1,key2…)的value setnx(key, value):如果不存在名称为key的string,则向库中添加string,名称为key,值为value setex(key, time, value):向库中添加string(名称为key,值为value)同时,设定过期时间time mset(key1, value1, key2, value2,…key N, value N):同时给多个string赋值,名称为key i的string赋值value i msetnx(key1, value1, key2, value2,…key N, value N):如果所有名称为key i的string都不存在,则向库中添加string,名称key i赋值为value i incr(key):名称为key的string增1操作 incrby(key, integer):名称为key的string增加integer decr(key):名称为key的string减1操作 decrby(key, integer):名称为key的string减少integer append(key, value):名称为key的string的值附加value substr(key, start, end):返回名称为key的string的value的子串
3. リスト操作のコマンド
rpush(key, value):在名称为key的list尾添加一个值为value的元素 lpush(key, value):在名称为key的list头添加一个值为value的 元素 llen(key):返回名称为key的list的长度 lrange(key, start, end):返回名称为key的list中start至end之间的元素(下标从0开始,下同) ltrim(key, start, end):截取名称为key的list,保留start至end之间的元素 lindex(key, index):返回名称为key的list中index位置的元素 lset(key, index, value):给名称为key的list中index位置的元素赋值为value lrem(key, count, value):删除count个名称为key的list中值为value的元素。count为0,删除所有值为value的元素,count>0 从头至尾删除count个值为value的元素,count<0从尾到头删除|count|个值为value的元素。 lpop(key):返回并删除名称为key的list中的首元素 rpop(key):返回并删除名称为key的list中的尾元素 blpop(key1, key2,… key N, timeout):lpop 命令的block版本。即当timeout为0时,若遇到名称为key i的list不存在或该list为空,则命令结束。如果 timeout>0,则遇到上述情况时,等待timeout秒,如果问题没有解决,则对key i+1开始的list执行pop操作。 brpop(key1, key2,… key N, timeout):rpop的block版本。参考上一命令。 rpoplpush(srckey, dstkey):返回并删除名称为srckey的list的尾元素,并将该元素添加到名称为dstkey的list的头部
4. 集合操作のコマンド
sadd(key, member):向名称为key的set中添加元素member srem(key, member) :删除名称为key的set中的元素member spop(key) :随机返回并删除名称为key的set中一个元素 smove(srckey, dstkey, member) :将member元素从名称为srckey的集合移到名称为dstkey的集合 scard(key) :返回名称为key的set的基数 sismember(key, member) :测试member是否是名称为key的set的元素 sinter(key1, key2,…key N) :求交集 sinterstore(dstkey, key1, key2,…key N) :求交集并将交集保存到dstkey的集合 sunion(key1, key2,…key N) :求并集 sunionstore(dstkey, key1, key2,…key N) :求并集并将并集保存到dstkey的集合 sdiff(key1, key2,…key N) :求差集 sdiffstore(dstkey, key1, key2,…key N) :求差集并将差集保存到dstkey的集合 smembers(key) :返回名称为key的set的所有元素 srandmember(key) :随机返回名称为key的set的一个元素
5. zset (ソート セット) 操作のコマンド
zadd(key, score, member):向名称为key的zset中添加元素member,score用于排序。如果该元素已经存在,则根据score更新该元素的顺序。 zrem(key, member) :删除名称为key的zset中的元素member zincrby(key, increment, member) :如果在名称为key的zset中已经存在元素member,则该元素的score增加increment;否则向集合中添加该元素,其score的值为increment zrank(key, member) :返回名称为key的zset(元素已按score从小到大排序)中member元素的rank(即index,从0开始),若没有member元素,返回“nil” zrevrank(key, member) :返回名称为key的zset(元素已按score从大到小排序)中member元素的rank(即index,从0开始),若没有member元素,返回“nil” zrange(key, start, end):返回名称为key的zset(元素已按score从小到大排序)中的index从start到end的所有元素 zrevrange(key, start, end):返回名称为key的zset(元素已按score从大到小排序)中的index从start到end的所有元素 zrangebyscore(key, min, max):返回名称为key的zset中score >= min且score <= max的所有元素 zcard(key):返回名称为key的zset的基数 zscore(key, element):返回名称为key的zset中元素element的score zremrangebyrank(key, min, max):删除名称为key的zset中rank >= min且rank <= max的所有元素 zremrangebyscore(key, min, max) :删除名称为key的zset中score >= min且score <= max的所有元素 zunionstore / zinterstore(dstkeyN, key1,…,keyN, WEIGHTS w1,…wN, AGGREGATE SUM|MIN|MAX):对N个zset求并集和交集,并将最后的集合保存在dstkeyN中。对于集合中每一个元素的score,在进行AGGREGATE运算前,都要乘以对于的WEIGHT参数。如果没有提供WEIGHT,默认为1。默认的AGGREGATE是SUM,即结果集合中元素的score是所有集合对应元素进行 SUM运算的值,而MIN和MAX是指,结果集合中元素的score是所有集合对应元素中最小值和最大值。
6.ハッシュ操作 操作コマンド
hset(key, field, value):向名称为key的hash中添加元素field<—>value hget(key, field):返回名称为key的hash中field对应的value hmget(key, field1, …,field N):返回名称为key的hash中field i对应的value hmset(key, field1, value1,…,field N, value N):向名称为key的hash中添加元素field i<—>value i hincrby(key, field, integer):将名称为key的hash中field的value增加integer hexists(key, field):名称为key的hash中是否存在键为field的域 hdel(key, field):删除名称为key的hash中键为field的域 hlen(key):返回名称为key的hash中元素个数 hkeys(key):返回名称为key的hash中所有键 hvals(key):返回名称为key的hash中所有键对应的value hgetall(key):返回名称为key的hash中所有的键(field)及其对应的value
5. Redisの命名規則
すべてのRedisデータはキーと値のペア、つまりすべてのデータはキーと値(Key)を通じてのみ管理できるため、
命名規則を標準化するために、jedis クライアントは特別な命名規則作成関数をパッケージ化しています。それを呼び出すだけです。コードリファレンスサンプルコード:
6. 参考資料
API:
//m.sbmmt.com/dic/54.htmlその他の関数については、このドキュメントを参照して呼び出してください。
Redis 関連の技術記事の詳細については、
Redis チュートリアル以上がRedis にはどのような API がありますか?の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。