修订代码，注释，示例

grpc/client.go

@@ -3,7 +3,7 @@ package grpc
 import (
 	"context"
 	"net"
-	sync "sync"
+	"sync"
 	"time"
 
 	"github.com/hahahrfool/v2ray_simple/netLayer"
@@ -21,11 +21,11 @@ var (
 type ClientConn *grpc.ClientConn
 
 /*
-调用过程
+建立新客户端连接的调用过程：
 
 先用 GetEstablishedConnFor 看看有没有已存在的 clientConn
 
-没有已存在的话，自己先拨号tcp，然后拨号tls，然后把tls连接 传递给 ClientHandshake, 生成一个 clientConn
+没有 已存在的 时，自己先拨号tcp，然后拨号tls，然后把tls连接 传递给 ClientHandshake, 生成一个 clientConn
 
 然后把获取到的 clientConn传递给 DialNewSubConn, 获取可用的一条 grpc 连接
 
@@ -34,16 +34,18 @@ type ClientConn *grpc.ClientConn
 //获取与 某grpc服务器的 已存在的grpc连接
 func GetEstablishedConnFor(addr *netLayer.Addr) ClientConn {
 	clientconnMutex.RLock()
-	clieintconn := clientconnMap[addr.GetHashable()]
+	clientconn := clientconnMap[addr.GetHashable()]
 	clientconnMutex.RUnlock()
 
-	if clieintconn == nil {
+	if clientconn == nil {
 		return nil
 	}
 
-	if (*grpc.ClientConn)(clieintconn).GetState() != connectivity.Shutdown {
-		return clieintconn
+	if (*grpc.ClientConn)(clientconn).GetState() != connectivity.Shutdown {
+		return clientconn
 	}
+	//如果state是shutdown的话，我们也不用特地清除map，因为下一次申请就会覆盖map中的该项.
+	//如果底层tcp被关闭，state就会为 Shutdown
 	return nil
 }
 
@@ -51,10 +53,11 @@ func GetEstablishedConnFor(addr *netLayer.Addr) ClientConn {
 //该 underlay一般为 tls连接。 addr为实际的远程地址，我们不从 underlay里获取addr,避免转换.
 func ClientHandshake(underlay net.Conn, addr *netLayer.Addr) (ClientConn, error) {
 
-	//v2ray的实现中用到了一个  globalDialerMap[dest], 可以利用现有连接,
+	// 用到了一个  clientconnMap , 可以利用现有连接,
 	// 只有map里没有与对应目标远程地址的连接的时候才会拨号;
-	// 这 应该就是一种mux的实现
-	// 如果有之前播过的client的话，直接利用现有client进行 NewStream, 然后服务端的话, 实际上会获得到第二条连接;
+	// 这就是一种mux的实现
+	// 如果有之前拨号过的client的话，直接利用现有client进行 NewStream,
+	// 然后服务端的话, 实际上会获得到同一条tcp链接上的第二条子连接;
 
 	//也就是说，底层连接在客户端-服务端只用了一条，但是 服务端处理时却会抽象出 多条Stream连接进行处理
 
@@ -84,7 +87,8 @@ func ClientHandshake(underlay net.Conn, addr *netLayer.Addr) (ClientConn, error)
 //在一个已存在的grpc连接中 进行新的子连接申请
 func DialNewSubConn(path string, clientconn ClientConn, addr *netLayer.Addr) (net.Conn, error) {
 
-	//不像服务端需要自己写一个实现StreamServer接口的结构, 我们Client端直接可以调用函数生成 StreamClient
+	// 帮助理解：
+	// 不像服务端需要自己写一个实现StreamServer接口的结构, 我们Client端直接可以调用函数生成 StreamClient
 	// 这也是grpc的特点, 客户端只负责 “调用“ ”service“，而具体的service的实现 是在服务端.
 
 	streamClient := NewStreamClient((*grpc.ClientConn)(clientconn)).(StreamClient_withName)