在 DotNetty 中实现同步请求

一、背景

DotNetty 本身是一个优秀的网络通讯框架，不过它是基于异步事件驱动来处理另一端的响应，需要在单独的 Handler 去处理相应的返回结果。而在我们的实际使用当中，尤其是 客户端程序 基本都是 请求-响应 模型，在发送了数据时候需要等待服务器的响应才能进行下一步操作，如果服务器返回的是错误信息，则需要进行特殊的处理。

类似于下面这种方式：

public async void Button1_Click()
{
    var result = await DotNettyClient.SendData("Hello");
    if(result == "Error")
    {
        throw new Exception("服务器返回错误!");
    }
    Console.WriteLine($"Hello {result}");
}

二、解决思路

参阅了大部分资料之后，发现在 Java 的 Netty 当中可以使用 Future / Promise 来实现，那么 C# 是否有类似的组件呢？答案是有的，他们对应的就是 Task 和 TaskCompletionSource，前者是给调用者的任务，而后者则是用于设置响应任务的结果。

那么我们就可以这么来处理，当客户端发送请求时，附带唯一的一个请求 ID，并将 TaskCompletionSource 放在一个请求字典当中，请求 ID 作为字典的 Key，值是 TaskCompletionSource，之后返回一个 Task。当客户端接收到服务器响应的时候，通过 TaskCompletionSource 设置之前那个 Task 的结果，这样我们接收到响应之后，就会从之前 await 的地方继续执行。

这里我自己的需求仅仅是类似于 同步阻塞式 的操作，所以我直接使用一个队列来做简单处理，并没有用唯一的请求 ID 来表示不同的请求，也没有使用字典，因为我可以 保证在同一时间内有且仅有一个客户端请求被发起，而且也做了响应的超时处理机制。

三、代码实现

实现起来超级简单，只需要在发起请求的时候，创建一个 TaskCompletionSource<TResponse> 对象。这个泛型参数指的是你想要的返回值类型，这里我以 TResponse 代替，下面的 DEMO 我会用 string 类型进行演示。

创建好一个 TaskCompletionSource<TResponse> 之后，在发送方法里面，我们可以将其对象放在一个先进先出的队列当中，然后将其 Task 属性作为发送方法的返回值。

我们再来到处理服务器响应的 Handler 当中，从队列里面拿去之前存放的 TaskCompletionSource<TResponse> 对象，调用其 SetResult() 方法，将具体响应进行设置。

通过以上的操作，我们在发送数据的时候，就可以使用 await 关键字等待服务端的响应，但不会阻塞线程，当客户端接收到服务端响应时，就会恢复到之前 await 的位置继续执行。

数据发送方法：

public static class DotNettyClient
{
    static DotNettyClient()
    {
        RequestQueue = new Queue<TaskCompletionSource<string>>();
    }
    public static Queue<TaskCompletionSource<string>> RequestQueue { get; set; }
    public static async Task<string> SendData(string data)
    {
        var resultTask = new TaskCompletionSource<string>();
        var buffer = new Unpooled.Buffer();
        buffer.WriteBytes(Encoding.UTF8.GetBytes(data));
        await _clientChannel.WriteAndFlushAsync(buffer);
        RequestQueue.Enqueue(resultTask);
        return await resultTask.Task;
    }
}

服务端响应处理：

public class ProtocolHandler : ChannelHandlerAdapter
{
	public override void ChannelRead(IChannelHandlerContext context, object message)
	{
		if(message is string response)
		{
			if(!DotNettyClient.RequestQueue.TryDequeue(out TaskCompletionSource<string> result)) return;
			result.SetResult(response);
		}
	}
}

这里我就不再编写解析器，主要说明一下代码的思路，下面在使用的时候就如同第一节说的一样，直接使用 await 关键字等待响应结果即可。

四、缺陷

在这里我并没有展示多个异步请求的情况，如果是用户同时发起多个请求的时候，你可以通过数据的唯一 ID 来标识每一个请求，读取时根据唯一 ID 从字典获取数据，这样在接收服务端响应的时候就能处理这种情况了。

五、参考资料