Jedis 作为 Redis 官方推荐的三个客户端之一,相比于其他两个(Lettuce,Redisson)而言,它提供最基本的客户端功能,也因此使得它具备简单和轻量的特性。此外,它也是线程不安全的客户端,因此不适用在多线程场景中。本篇我们通过对其源码的阅读来了解 Redis 的客户端是如何进行工作的,同时也去找出它线程不安全的原因。
版本说明:本片源码解读基于 Jedis-3.3.0,请注意区分。
1. 初始化
首先我们从 Jedis 的基本使用说起,最简单的使用方式如下:
Jedis jedis = new Jedis("localhost", 6379);// 初始化客户端
jedis.auth("foobared");// 密码认证
jedis.dbSize();// 查询字典的数据量
jedis.close();// 关闭连接
了解了基本的用法之后,我们就从客户端的初始化开始,在开始之前不妨先了解一下 Jedis 类的结构:
- BinaryJedisCommands: 定义各种数据类型的基本的操作指令;
- BasicCommands: 定义基本的数据库操作指令;
- AdvancedBinaryJedisCommands: 定义高级的操作指令;
- BinaryScriptingCommands: 定义 Lua 脚本相关的操作指令;
- MultiKeyBinaryCommands: 定义多键值操作的指令;
- BinaryJedis: 实现了上面这些操作接口;
- Jedis: 我们所使用的客户端,不同于 BinaryJedis 的地方在于其方法参数是字符串,而 BinaryJedis 参数是字节数组。
上面这些带 Binary 的接口或类,其参数均为字节数组,这正是其使用 Binary 修饰的原因。
Jedis 的初始化:
public BinaryJedis(final String host, final int port) {
client = new Client(host, port);
}
Client 的类图如下:
public Client(final String host, final int port) {
// 调用父类 BinaryClient 的初始化
super(host, port);
}
public BinaryClient(final String host, final int port) {
// 调用父类 Connection 的初始化
super(host, port);
}
public Connection(final String host, final int port) {
this(host, port, false);
}
public Connection(final String host, final int port, final boolean ssl) {
this(host, port, ssl, null, null, null);
}
public Connection(final String host, final int port, final boolean ssl,
SSLSocketFactory sslSocketFactory, SSLParameters sslParameters,
HostnameVerifier hostnameVerifier) {
this(new DefaultJedisSocketFactory(host, port, Protocol.DEFAULT_TIMEOUT,
Protocol.DEFAULT_TIMEOUT, ssl, sslSocketFactory, sslParameters, hostnameVerifier));
}
public Connection(final JedisSocketFactory jedisSocketFactory) {
this.jedisSocketFactory = jedisSocketFactory;
}
DefaultJedisSocketFactory–套接字工厂
public class DefaultJedisSocketFactory implements JedisSocketFactory {
private String host;
private int port;
private int connectionTimeout;
private int soTimeout;
private boolean ssl;
private SSLSocketFactory sslSocketFactory;
private SSLParameters sslParameters;
private HostnameVerifier hostnameVerifier;
public DefaultJedisSocketFactory(String host, int port, int connectionTimeout, int soTimeout,
boolean ssl, SSLSocketFactory sslSocketFactory, SSLParameters sslParameters,
HostnameVerifier hostnameVerifier) {
this.host = host;
this.port = port;
this.connectionTimeout = connectionTimeout;
this.soTimeout = soTimeout;
this.ssl = ssl;
this.sslSocketFactory = sslSocketFactory;
this.sslParameters = sslParameters;
this.hostnameVerifier = hostnameVerifier;
}
@Override
public Socket createSocket() throws IOException {
Socket socket = null;
try {
socket = new Socket();
// ->@wjw_add
socket.setReuseAddress(true);
socket.setKeepAlive(true); // Will monitor the TCP connection is
// valid
socket.setTcpNoDelay(true); // Socket buffer Whetherclosed, to
// ensure timely delivery of data
socket.setSoLinger(true, 0); // Control calls close () method,
// the underlying socket is closed
// immediately
// <-@wjw_add
socket.connect(new InetSocketAddress(getHost(), getPort()), getConnectionTimeout());
socket.setSoTimeout(getSoTimeout());
if (ssl) {
if (null == sslSocketFactory) {
sslSocketFactory = (SSLSocketFactory) SSLSocketFactory.getDefault();
}
socket = sslSocketFactory.createSocket(socket, getHost(), getPort(), true);
if (null != sslParameters) {
((SSLSocket) socket).setSSLParameters(sslParameters);
}
if (