Jedis入门教程

Jedis

Java有很多优秀的Redis客户端，使用较为广泛的是客户端Jedis，官方推荐的操作Redis的中间件。

使用步骤：

• 导入jedis的jar包（依赖：redis.clients.jedis.3.3.0）
• 建立连接：Jedis jedis = new Jedis("localhost",6379);
• 操作：jedis.set("key","value");
• 关闭连接，或者直接就使用jedis连接池：jedis.close();

直接连接与连接池方式的比较：

	优点	缺点
直连	简单方便，适用与少量长期连接的场景	存在每次新建/关闭TCP连接的开销，资源无法控制，可能出现连接泄露。并且Jedis对象处于线程不安全的状态
连接池	无需每次都生成Jdeis对象，降低开销，并且连接池的形式可以有效的保护和控制系统资源	相对于直连，使用相对麻烦，在资源管理上需要很多参数来保证，一旦规划不合理会出现问题

搭建工程：

引入依赖：

<dependency>
    <groupId>redis.clients</groupId>
    <artifactId>jedis</artifactId>
    <version>3.3.0</version>
</dependency>
<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>fastjson</artifactId>
    <version>1.2.58</version>
</dependency>

测试连接：

public class Ping {
    public static void main(String[] args) {
        Jedis jedis = new Jedis("127.0.0.1",6379);
        System.out.println("连接成功");
        //查看服务是否运行
        System.out.println("服务正在运行: "+jedis.ping());
    }
}

运行结果：连接成功

Jedis中的API接口名和操作名一样，根据API文档使用就行：

基本测试：

public class TestJedis {
    public static void main(String[] args) {
        Jedis jedis = new Jedis("127.0.0.1", 6379);

        System.out.println("清空数据："+jedis.flushDB());
        System.out.println("判断某个键是否存在："+jedis.exists("username"));
        System.out.println("新增<'username','ly'>的键值对："+jedis.set("username", "ly"));
        System.out.println("新增<'password','123456'>的键值对："+jedis.set("password", "123456"));
        System.out.print("系统中所有的键如下：");
        Set<String> keys = jedis.keys("*");
        System.out.println(keys);

        System.out.println("删除键password:"+jedis.del("password"));
        System.out.println("判断键password是否存在："+jedis.exists("password"));
        System.out.println("查看键username所存储的值的类型："+jedis.type("username"));
        System.out.println("随机返回key空间的一个："+jedis.randomKey());
        System.out.println("重命名key："+jedis.rename("username","name"));
        System.out.println("取出改后的name："+jedis.get("name"));
        System.out.println("按索引查询："+jedis.select(0));
        System.out.println("删除当前选择数据库中的所有key："+jedis.flushDB());
        System.out.println("返回当前数据库中key的数目："+jedis.dbSize());
        System.out.println("删除所有数据库中的所有key："+jedis.flushAll());
    }
}

运行结果：

Jedis实现事务控制：

import com.alibaba.fastjson.JSONObject;
import redis.clients.jedis.Jedis;
import redis.clients.jedis.Transaction;

public class TestMulti {
    public static void main(String[] args) {
        //创建客户端连接服务端，redis服务端需要被开启
        Jedis jedis = new Jedis("127.0.0.1", 6379);
        jedis.flushDB();

        JSONObject jsonObject = new JSONObject();
        jsonObject.put("user1", "xiaoming");
        jsonObject.put("user2", "xiaohong");
        //开启事务
        Transaction multi = jedis.multi();
        String result = jsonObject.toJSONString();
        try{
            //向redis存入一条数据
            multi.set("json", result);
            //再存入一条数据
            multi.set("json2", result);
            //这里引发了异常，用0作为被除数
            //int i = 10/0;
            //如果没有引发异常，执行进入队列的命令
            multi.exec();
        }catch(Exception e){
            e.printStackTrace();
            //如果出现异常，回滚
            multi.discard();
        }finally{
            System.out.println(jedis.get("json"));
            System.out.println(jedis.get("json2"));
            //最终关闭客户端
            jedis.close();
        }
    }
}

运行结果：

在开启事务期间添加异常，用0作为被除数int i = 10/0;，再次测试结果：

Jedis连接池： JedisPool

之前通过直连的方式使用Jedis，由于Redis客户端使用的是TCP协议，所有每次都需要我们新建TCP连接，使用后在断开连接，对于频繁访问Redis的场景显然并不高效，在实际生产环境中一般使用连接池的方式对Jedis连接进行管理。

使用步骤：

Jedis提供了JedisPool这个类作为对Jedis的连接池，使用时首先需要我们创建一个JedisPool连接池对象，之后通过调用方法 getResource()获取Jedis连接。

1.Jedis连接池，通常JedisPool是单例的。

//0.创建一个配置对象
JedisPoolConfig config = new JedisPoolConfig();
config.setMaxTotal(50);
config.setMaxIdle(10);

//1.创建Jedis连接池对象
JedisPool jedisPool = new JedisPool(config,"localhost",6379);

相关参数：

参数名	含义	默认值
MaxTotal	最大连接数	8
MaxIdle	最大空闲连接数	8
MinIdle	最小空闲连接数	0
MinEvictableIdleTimeMillis	逐出连接的最小空闲时间	1800000毫秒(30分钟)
MaxWaitMillis	获取连接时的最大等待毫秒数如果超时就抛异常, 小于零:阻塞不确定的时间	-1
TimeBetweenEvictionRunsMillis	逐出扫描的时间间隔(毫秒) 如果为负数,则不运行逐出线程	-1
NumTestsPerEvictionRun	每次逐出检查时 逐出的最大数目 如果为负数就是 : 1/abs(n)	3
Lifo	是否启用后进先出	true
TestOnBorrow	在获取连接的时候检查有效性	false
TestWhileIdle	在空闲时检查有效性	false
JmxEnabled	是否启用pool的jmx管理功能	true
EvictionPolicyClassName	设置的逐出策略类名，默认当连接超过最大空闲时间，或连接数超过最大空闲连接数逐出	DefaultEvictionPolicy
SoftMinEvictableIdleTimeMillis	对象空闲多久后逐出, 当空闲时间>该值 且 空闲连接>最大空闲数 时直接逐出,不再根据MinEvictableIdleTimeMillis判断	逐出策略
BlockWhenExhausted	连接耗尽时是否阻塞, false报异常,ture阻塞直到超时	true

2.从连接池获取对象，并使用：

//2.获取连接
Jedis jedis = jedisPool.getResource();

//3. 使用
jedis.set("key1","value1");

//4. 关闭 归还到连接池中
jedis.close();

自定义工具类：

在resources目录下新建jedis.properties配置文件：

host = 127.0.0.1
port = 6379
maxTotal= 50
maxIdle = 10

编写工具类：

public class JedisPoolUtils {

    private static JedisPool jedisPool;

    static{
        //读取配置文件
        InputStream is = JedisPoolUtils.class.getClassLoader().getResourceAsStream("jedis.properties");
        //创建Properties对象
        Properties pro = new Properties();
        //关联文件
        try {
            pro.load(is);
        } catch (IOException e) {
            e.printStackTrace();
        }
        //获取数据，设置到JedisPoolConfig中
        JedisPoolConfig config = new JedisPoolConfig();
        config.setMaxTotal(Integer.parseInt(pro.getProperty("maxTotal")));
        config.setMaxIdle(Integer.parseInt(pro.getProperty("maxIdle")));

        //初始化JedisPool
        jedisPool = new JedisPool(config,pro.getProperty("host"),Integer.parseInt(pro.getProperty("port")));

    }

    /**
     * 获取连接方法
     */
    public static Jedis getJedis(){
        return jedisPool.getResource();
    }
}