Transport 改版

src/META-INF/application-template.xml

@@ -26,16 +26,25 @@
 <application port="6560" lib="">   
     
     <!-- 所有服务所需的资源 -->      
-    <resources>        
-         <!--
+    <resources>  
+        <!--
+            transport节点只能有一个，用于配置所有Transport的池参数，没配置该节点将自动创建一个。
+            threads： 线程总数， 默认: <group>节点数*CPU核数*8
+            bufferCapacity: ByteBuffer的初始化大小， 默认: 8K; 
+            bufferPoolSize： ByteBuffer池的大小，默认: <group>节点数*CPU核数*8
+        -->
+        <transport capacity="8192" bufferPoolSize="32" threads="32"/>
+        <!--
             一个组包含多个NODE， 同一Service服务可以由多个进程提供，这些进程称为一个GROUP，且同一GROUP内的进程必须在同一机房或局域网内
-            name: 服务组ID，长度不能超过11个字节. 默认为空字符串。
+            一个group节点对应一个 Transport 对象。
+            name: 服务组ID，长度不能超过11个字节. 默认为空字符串。 注意: name不能包含$符号。
             protocol：值只能是UDP TCP， 默认TCP
             注意: 一个node只能所属一个group。只要存在protocol=SNCP的Server节点信息， 就必须有group节点信息。
         -->
         <group name="" protocol="TCP">
             <!--
                 需要将本地node的addr与port列在此处。
+                同一个<node>节点值只能存在一个<group>节点内，即同一个addr+port只能属于一个group。
                 addr: required IP地址
                 port: required 端口
                 clients: 连接池数， 默认: CPU核数*4
@@ -73,7 +82,7 @@
         backlog:  默认10K
         threads： 线程总数， 默认: CPU核数*16
         maxbody: request.body最大值， 默认: 64K
-        capacity: ByteBuffer的初始化大小， 默认: 8K;  如果是HTTP协议则默认: 16K + 8B (兼容HTTP 2.0)
+        bufferCapacity: ByteBuffer的初始化大小， 默认: 8K;  如果是HTTP协议则默认: 16K + 8B (兼容HTTP 2.0)
         bufferPoolSize： ByteBuffer池的大小，默认: CPU核数*512
         responsePoolSize： Response池的大小，默认: CPU核数*256
         readTimeoutSecond: 读操作超时秒数， 默认0， 表示永久不超时
@@ -98,7 +107,7 @@
             <!-- 显著加载指定的Service的接口类 -->
             <service value="com.xxx.XXX1Service"/>
             <!-- 
-               name:   显式指定name，覆盖默认的空字符串值。
+               name:   显式指定name，覆盖默认的空字符串值。 注意: name不能包含$符号。
                groups: 显式指定groups，覆盖<services>节点的groups默认值。
             -->
             <service value="com.xxx.XXX2Service" name="" groups="xxx;yyy"/>
@@ -113,7 +122,7 @@
            当Server为HTTP协议时, request节点才有效。
            remoteaddr 节点: 替换请求方节点的IP地址， 通常请求方是由nginx等web静态服务器转发过的则需要配置该节点。
            且value值只能是以request.headers.开头，表示从request.headers中获取对应的header值。
-           例如下面例子获取request.getRemoteAddr()值，如果header存在X-RemoteAddress值则返回X-RemoteAddress值，不存在返回request.getRemoteAddress()。
+           例如下面例子获取request.getRemoteAddr()值，如果header存在X-RemoteAddress值则返回X-RemoteAddress值，不存在返回getRemoteAddress()。
         -->
         <request>
             <remoteaddr value="request.headers.X-RemoteAddress"/>