From 4fc2dbd224bd49d4d8ed97982e29470429a8fb35 Mon Sep 17 00:00:00 2001
From: xiehan <52160700+Barenboim@users.noreply.github.com>
Date: Fri, 15 Sep 2023 17:55:30 +0800
Subject: [PATCH] Update tutorial-05-http_proxy.md

---
 docs/tutorial-05-http_proxy.md | 40 ++++++++++++++++++++++++++++++++++
 1 file changed, 40 insertions(+)

diff --git a/docs/tutorial-05-http_proxy.md b/docs/tutorial-05-http_proxy.md
index cdc23cba..438776f6 100644
--- a/docs/tutorial-05-http_proxy.md
+++ b/docs/tutorial-05-http_proxy.md
@@ -192,3 +192,43 @@ server任务的callback和client一样，是在http交互完成之后被调用
 这里需要说明一下，回复消息的时机是在series里所有其它任务被执行完后，自动回复，所以并没有task->reply()接口。  
 但是，有task->noreply()调用，如果对server任务执行了这个调用，在原本回复的时刻，直接关闭连接。但callback依然会被调用（状态为NOREPLY）。  
 在server任务的callback里，同样可以通过series_of()操作获得任务的series。那么，我们依然可以往这个series里追加新任务，虽然回复已经完成。  
+
+# 另外一种实现异步Server的便利方法
+
+由于很多用户会直观的觉得，server的process函数结束server处理流程就结束并回复了。所以，经常有用户在process里使用wait group进行等待：
+~~~cpp
+int process(WFHttpTask *server_task)
+{
+    WFFacilities::WaitGroup wait_group(1);
+    WFHttpTask *task = WFTaskFactory::create_http_task(..., [&wait_group, server_task]{WFHttpTask *task) {
+        *server_task->get_resp() = std::move(*task->get_resp());
+        wait_group.done();
+    });
+    task->start();
+    wait_group.wait();
+}
+~~~
+我们需要强调，以上的代码是一种不高效的写法，因为这会让一个线程进入等待。等价的高效写法是：
+~~~cpp
+int process(WFHttpTask *server_task)
+{
+    WFHttpTask *task = WFTaskFactory::create_http_task(..., [server_task]{WFHttpTask *task) {
+        *server_task->get_resp() = std::move(*task->get_resp());
+    });
+    series_of(server_task)->push_back(task);
+}
+~~~
+但鉴于很多用户不想了解series用法，我们加入一个便利类ReplyGuard，让用户可以在任何时候回复请求，用法如下：
+~~~cpp
+int process(WFHttpTask *server_task)
+{
+    auto *guard = new WFFacilities::ReplyGuard(server_task);
+    WFHttpTask *task = WFTaskFactory::create_http_task(..., [guard, server_task]{WFHttpTask *task) {
+        *server_task->get_resp() = std::move(*task->get_resp());
+        delete guard;  // 此时server才会回复。
+    });
+    task->start();
+}
+~~~
+WFFacilities::ReplyGuard用于阻止一个server task的回复，只有这个guard被析构，才会触发回复。  
+使用ReplyGuard一般不影响原server task series的使用，用户依然可以push_back任务。但**避免再调用series的cancel()**。