关键字：Netty开发redis客户端，Netty发送redis命令，netty解析redis消息,netty redis,redis RESP协议。redis客户端，netty redis协议

我们可以使用redis-cli这个客户端来操作redis，也可以使用window的命令行telnet连接redis。本文，我们的目标是使用netty来实现redis客户端，实现目标为：

1. 启动netty程序
2. 在命令行输入 set mykey hello，由netty发送给redis服务器
3. 在命令行输入 get mykey hello，得到结果：hello
4. 在命令行输入 quit，程序退出

前言

Redis在TCP端口6379（默认，可修改端口）上监听到来的连接，客户端连接到来时，Redis服务器为此创建一个TCP连接。在客户端与服务器端之间传输的每个Redis命令或者数据都以\r\n结尾。当redis服务启动之后，我们可以使用TCP与之链接，连接之后便可以发消息，也会受到redis服务器的消息。而这个消息是有格式的，这个格式是事先商量好的，我们称之为协议，redis的协议叫做RESP，比方说我们有一条redis命令 set hello 123,这条命令我们知道它是一条设置命令，通过RESP协议“翻译”一下，他就是这样的:

*3\r\n$3\r\nSET\r\n$5\r\nhello\r\n$3\r\n123\r\n

然后，这条协议通过网络传输(二进制形式)，传到redis服务器，被redis服务器解析，最后完成设置。关于RESP协议的详细介绍可以看这里.

思路

上面我们介绍了redis是基于TCP传输，并使用了其自己的协议——RESP。RESP其实是数据交换可解析的协议，你可以理解为数据交换的格式，按照此格式组装好要传输的命令，并以二进制的形式由client端发往redis服务端。服务端接收这个消息之后，解析消息，执行命令，并将结果以协议好的格式组装好，传输给client端。client端接收到响应，解释成人类可以看懂的结果展示。

因此，我们可以整理一下思路：

1. 我们需要连接redis服务端，因此需要编写一个netty client端（此处联想一下netty client端的样板代码）。
2. 我们需要向redis服务端发送redis命令，很简单，获取channel，然后write。即channel.write(...)
3. 我们所编写的直白的命令，如set xx,get xx之类的需要编码之后才能传输给redis服务器。
   因此，我们需要 **编码器**。很荣幸netty自带了，可以直接使用。
   这里是 【输出】 所以要有  outbound handler.
4. redis会响应结果给我们，因此我们需要在 chanelRead方法中处理数据。
   这里是 【输入】 所以要有  inbound  handler.

编写代码

上的思路整理好了之后，我们可以写代码了。得益于netty的良好设计，我们只需要把netty client的“样板代码”拷贝过来生成一个client端代码即可。剩下的就是 handler ，decoder ，encoder 。我们需要编写的类有：

RedisClient 见名知义，我们的主类，包含client bootstrap信息。接收用户控制台输入redis命令。
RedisClientInitializer 初始化器，在此添加 handler，decoder，encoder
RedisClientHandler 核心逻辑，需要处理 inbound ，outbound 两种类型事件。

RedisClient 代码如下：

public class RedisClient {

    String host;    //   目标主机
    int port;       //   目标主机端口

    public RedisClient(String host,int port){
        this.host = host;
        this.port = port;
    }

    public void start() throws Exception{
        EventLoopGroup group = new NioEventLoopGroup();
        try {
            Bootstrap bootstrap = new Bootstrap();
            bootstrap.group(group)
                    .channel(NioSocketChannel.class)
                    .handler(new RedisClientInitializer());

            Channel channel = bootstrap.connect(host,port).sync().channel();
            System.out.println(" connected to host : " + host + ",port : " + port);
            System.out.println(" type redis's command to communicate with redis-server or type 'quit' to shutdown ");
            BufferedReader in = new BufferedReader(new InputStreamReader(System.in));
            ChannelFuture lastWriteFuture = null;
            for (;;) {
                String s = in.readLine();
                if(s.equalsIgnoreCase("quit")) {
                    break;
                }
                System.out.print(">");
                lastWriteFuture = channel.writeAndFlush(s);
                lastWriteFuture.addListener(new GenericFutureListener<ChannelFuture>() {
                    @Override
                    public void operationComplete(ChannelFuture future) throws Exception {
                        if (!future.isSuccess()) {
                            System.err.print("write Failed: ");
                            future.cause().printStackTrace(System.err);
                        }
                    }
                });
            }
            if (lastWriteFuture != null) {
                lastWriteFuture.sync();
            }
            System.out.println(" bye ");
        }finally {
            group.shutdownGracefully();
        }
    }

    public static void main(String[] args) throws Exception{
        RedisClient client = new RedisClient("redis-cache2.228",5001);
        client.start();
    }

}

上面代码很长，但是，我们要熟悉netty的套路，它的样板代码就是如此。我们只需要看handler(new RedisClientInitializer()); 这一行，下面的就是一个 for(;;)循环，用来接收我们在控制台输入的redis命令。

RedisClientInitializer代码如下：

public class RedisClientInitializer extends ChannelInitializer<Channel>{

    @Override
    protected void initChannel(Channel ch) throws Exception {
        ChannelPipeline pipeline = ch.pipeline();
        pipeline.addLast(new RedisDecoder());
        pipeline.addLast(new RedisBulkStringAggregator());
        pipeline.addLast(new RedisArrayAggregator());
        pipeline.addLast(new RedisEncoder());
        pipeline.addLast(new RedisClientHandler());
    }
}

这个类，很简单，上面的几个addLast方法，除了最后一个外，其他都是netty自带的redis协议实现相关的编解码。最后一个是我们自定义的业务逻辑处理器。源码如下：

public class RedisClientHandler extends ChannelDuplexHandler {


    // 发送 redis 命令
    @Override
    public void write(ChannelHandlerContext ctx,Object msg,ChannelPromise promise) {
        String[] commands = ((String) msg).split("\\s+");
        List<RedisMessage> children = new ArrayList<>(commands.length);
        for (String cmdString : commands) {
            children.add(new FullBulkStringRedisMessage(ByteBufUtil.writeUtf8(ctx.alloc(),cmdString)));
        }
        RedisMessage request = new ArrayRedisMessage(children);
        ctx.write(request,promise);
    }


    // 接收 redis 响应数据
    @Override
    public void channelRead(ChannelHandlerContext ctx,Object msg) {
        RedisMessage redisMessage = (RedisMessage) msg;
        // 打印响应消息
        printAggregatedRedisResponse(redisMessage);
        // 是否资源
        ReferenceCountUtil.release(redisMessage);
    }


    @Override
    public void exceptionCaught(ChannelHandlerContext ctx,Throwable cause) {
        System.err.print("exceptionCaught: ");
        cause.printStackTrace(System.err);
        ctx.close();
    }


    private static void printAggregatedRedisResponse(RedisMessage msg) {
        if (msg instanceof SimpleStringRedisMessage) {
            System.out.println(((SimpleStringRedisMessage) msg).content());
        } else if (msg instanceof ErrorRedisMessage) {
            System.out.println(((ErrorRedisMessage) msg).content());
        } else if (msg instanceof IntegerRedisMessage) {
            System.out.println(((IntegerRedisMessage) msg).value());
        } else if (msg instanceof FullBulkStringRedisMessage) {
            System.out.println(getString((FullBulkStringRedisMessage) msg));
        } else if (msg instanceof ArrayRedisMessage) {
            for (RedisMessage child : ((ArrayRedisMessage) msg).children()) {
                printAggregatedRedisResponse(child);
            }
        } else {
            throw new CodecException("unknown message type: " + msg);
        }
    }

    private static String getString(FullBulkStringRedisMessage msg) {
        if (msg.isNull()) {
            return "(null)";
        }
        return msg.content().toString(CharsetUtil.UTF_8);
    }

}

注意，上面我们讨论过，我们需要两个handler，分别是inbound handler 和outbound handler 。这里我们使用的是ChannelDuplexHandler。这个ChannelDuplexHandler 支持处理 inbound 和 outbound，其定义如下：

public class ChannelDuplexHandler extends ChannelInboundHandlerAdapter implements ChannelOutboundHandler {
  ....
}

运行演示

按照开篇的思路分析，上面我们已经编写好了netty redis client所需要的代码。下面我们需要运行看看。main函数如下：

    public static void main(String[] args) throws Exception{
        RedisClient client = new RedisClient("your-redis-server-ip",6379);
        client.start();
    }

我在本地运行了一下，演示了一些命令：

get,set 以及错误的命令
expire命令设置超时时间，及 ttl 命令查看超时时间
del 命令删除可以
quit退出程序。

结果如下：

 connected to host : 192.168.2.120,port : 6379
 type redis's command to communicate with redis-server or type 'quit' to shutdown 
get hello
>(null)
set hello
>ERR wrong number of arguments for 'set' command
set hello 123
>OK
expire hello 10
>1
ttl hello
>6
ttl hello
>4
get hello
>(null)
set hello world
>OK
get hello
>world
del hello
>1
quit
 bye 

Process finished with exit code 0

如此，我们便用netty实现了redis的client端。代码下载

如果你觉得还可以，给点个推荐吧！

使用Netty实现HTTP服务器

Netty实现心跳机制

Netty系列

spring如何启动的？这里结合spring源码描述了启动过程

SpringMVC是怎么工作的,SpringMVC的工作原理

spring 异常处理。结合spring源码分析400异常处理流程及解决方法

Mybatis Mapper接口是如何找到实现类的-源码分析

Lua脚本在redis分布式锁场景的运用

redis单点、redis主从、redis集群cluster配置搭建与使用

CORS详解，CORS原理分析