net.html

@@ -248,7 +248,8 @@
     <span class="c1">//获取客户端地址IP</span>
     <span class="kd">public</span> <span class="n">SocketAddress</span> <span class="nf">getRemoteAddress</span><span class="o">();</span>
 
-    <span class="c1">//获取客户端地址IP, 与getRemoteAddres() 的区别在于：本方法优先取header中指定为RemoteAddress名的值，没有则返回getRemoteAddres()的getHostAddress()。</span>
+    <span class="c1">//获取客户端地址IP, 与getRemoteAddres() 的区别在于：</span>
+    <span class="c1">//本方法优先取header中指定为RemoteAddress名的值，没有则返回getRemoteAddres()的getHostAddress()。</span>
     <span class="c1">//本方法适用于服务前端有如nginx的代理服务器进行中转，通过getRemoteAddres()是获取不到客户端的真实IP。</span>
     <span class="kd">public</span> <span class="n">String</span> <span class="nf">getRemoteAddr</span><span class="o">();</span>
 
@@ -273,6 +274,10 @@
     <span class="c1">//获取文件上传信息列表 等价于 getMultiContext().parts();</span>
     <span class="kd">public</span> <span class="n">Iterable</span><span class="o">&lt;</span><span class="n">MultiPart</span><span class="o">&gt;</span> <span class="nf">multiParts</span><span class="o">()</span> <span class="kd">throws</span> <span class="n">IOException</span><span class="o">;</span>
 
+    <span class="c1">//设置当前用户信息, 通常在HttpServlet.preExecute方法里设置currentUser</span>
+    <span class="c1">//数据类型由@HttpUserType指定</span>
+    <span class="kd">public</span> <span class="o">&lt;</span><span class="n">T</span><span class="o">&gt;</span> <span class="n">HttpRequest</span> <span class="nf">setCurrentUser</span><span class="o">(</span><span class="n">T</span> <span class="n">user</span><span class="o">);</span>
+    
     <span class="c1">//获取当前用户信息 数据类型由@HttpUserType指定</span>
     <span class="kd">public</span> <span class="o">&lt;</span><span class="n">T</span><span class="o">&gt;</span> <span class="n">T</span> <span class="nf">currentUser</span><span class="o">();</span>
     
@@ -417,6 +422,12 @@
     <span class="c1">// 获取time参数: double point = request.getRequstURIPath("point:", 0.0);</span>
     <span class="kd">public</span> <span class="kt">double</span> <span class="nf">getRequstURIPath</span><span class="o">(</span><span class="n">String</span> <span class="n">prefix</span><span class="o">,</span> <span class="kt">double</span> <span class="n">defvalue</span><span class="o">);</span>
 
+    <span class="c1">//获取所有的header名</span>
+    <span class="kd">public</span> <span class="n">AnyValue</span> <span class="nf">getHeaders</span><span class="o">();</span>
+    
+    <span class="c1">//将请求Header转换成Map</span>
+    <span class="kd">public</span> <span class="n">Map</span><span class="o">&lt;</span><span class="n">String</span><span class="o">,</span> <span class="n">String</span><span class="o">&gt;</span> <span class="nf">getHeadersToMap</span><span class="o">(</span><span class="n">Map</span><span class="o">&lt;</span><span class="n">String</span><span class="o">,</span> <span class="n">String</span><span class="o">&gt;</span> <span class="n">map</span><span class="o">);</span>
+    
     <span class="c1">//获取所有的header名</span>
     <span class="kd">public</span> <span class="n">String</span><span class="o">[]</span> <span class="nf">getHeaderNames</span><span class="o">();</span>
 
@@ -465,6 +476,21 @@
     <span class="c1">//获取指定的header的double值, 没有返回默认double值</span>
     <span class="kd">public</span> <span class="kt">double</span> <span class="nf">getDoubleHeader</span><span class="o">(</span><span class="n">String</span> <span class="n">name</span><span class="o">,</span> <span class="kt">double</span> <span class="n">defaultValue</span><span class="o">);</span>
 
+    <span class="c1">//获取请求参数总对象</span>
+    <span class="kd">public</span> <span class="n">AnyValue</span> <span class="nf">getParameters</span><span class="o">();</span>
+    
+    <span class="c1">//将请求参数转换成Map</span>
+    <span class="kd">public</span> <span class="n">Map</span><span class="o">&lt;</span><span class="n">String</span><span class="o">,</span> <span class="n">String</span><span class="o">&gt;</span> <span class="nf">getParametersToMap</span><span class="o">(</span><span class="n">Map</span><span class="o">&lt;</span><span class="n">String</span><span class="o">,</span> <span class="n">String</span><span class="o">&gt;</span> <span class="n">map</span><span class="o">);</span>
+    
+    <span class="c1">//将请求参数转换成String, 字符串格式为: bean1={}&amp;amp;id=13&amp;amp;name=xxx</span>
+    <span class="c1">//不会返回null，没有参数返回空字符串</span>
+    <span class="kd">public</span> <span class="n">String</span> <span class="nf">getParametersToString</span><span class="o">();</span>
+    
+    <span class="c1">//将请求参数转换成String, 字符串格式为: prefix + bean1={}&amp;amp;id=13&amp;amp;name=xxx</span>
+    <span class="c1">//拼接前缀， 如果无参数，返回的字符串不会含有拼接前缀</span>
+    <span class="c1">//不会返回null，没有参数返回空字符串</span>
+    <span class="kd">public</span> <span class="n">String</span> <span class="nf">getParametersToString</span><span class="o">(</span><span class="n">String</span> <span class="n">prefix</span><span class="o">);</span>
+    
     <span class="c1">//获取所有参数名</span>
     <span class="kd">public</span> <span class="n">String</span><span class="o">[]</span> <span class="nf">getParameterNames</span><span class="o">();</span>
 
@@ -545,7 +571,7 @@
     <span class="c1">//获取request创建时间</span>
     <span class="kd">public</span> <span class="kt">long</span> <span class="nf">getCreatetime</span><span class="o">();</span>
 <span class="o">}</span>
-                </pre></div>
+</pre></div>
 
 
             <p id="net_httpresponse">&nbsp;&nbsp;<b>. HttpResponse 对象</b> </p>
@@ -562,7 +588,10 @@
 
     <span class="c1">//传入的CompletionHandler子类必须是public，且保证其子类可被继承且completed、failed可被重载且包含空参数的构造函数</span>
     <span class="kd">public</span> <span class="o">&lt;</span><span class="n">H</span> <span class="kd">extends</span> <span class="n">CompletionHandler</span><span class="o">&gt;</span> <span class="n">H</span> <span class="nf">createAsyncHandler</span><span class="o">(</span><span class="n">Class</span><span class="o">&lt;</span><span class="n">H</span><span class="o">&gt;</span> <span class="n">handlerClass</span><span class="o">);</span>
-    
+
+    <span class="c1">//获取ByteBuffer生成器</span>
+    <span class="kd">public</span> <span class="n">Supplier</span><span class="o">&lt;</span><span class="n">ByteBuffer</span><span class="o">&gt;</span> <span class="nf">getBufferSupplier</span><span class="o">();</span>
+
     <span class="c1">//设置状态码</span>
     <span class="kd">public</span> <span class="kt">void</span> <span class="nf">setStatus</span><span class="o">(</span><span class="kt">int</span> <span class="n">status</span><span class="o">);</span>
 
@@ -599,7 +628,7 @@
 
     <span class="c1">//异步输出指定内容</span>
     <span class="kd">public</span> <span class="o">&lt;</span><span class="n">A</span><span class="o">&gt;</span> <span class="kt">void</span> <span class="nf">sendBody</span><span class="o">(</span><span class="n">ByteBuffer</span><span class="o">[]</span> <span class="n">buffers</span><span class="o">,</span> <span class="n">A</span> <span class="n">attachment</span><span class="o">,</span> <span class="n">CompletionHandler</span><span class="o">&lt;</span><span class="n">Integer</span><span class="o">,</span> <span class="n">A</span><span class="o">&gt;</span> <span class="n">handler</span><span class="o">);</span>
-    
+
     <span class="c1">//关闭HTTP连接，如果是keep-alive则不强制关闭</span>
     <span class="kd">public</span> <span class="kt">void</span> <span class="nf">finish</span><span class="o">();</span>
 
@@ -609,9 +638,17 @@
     <span class="c1">//将对象以JSON格式输出</span>
     <span class="kd">public</span> <span class="kt">void</span> <span class="nf">finishJson</span><span class="o">(</span><span class="n">Object</span> <span class="n">obj</span><span class="o">);</span>
 
+    <span class="c1">//将对象数组用Map的形式以JSON格式输出</span>
+    <span class="c1">//例如: finishMap("a",2,"b",3) 输出结果为 {"a":2,"b":3}</span>
+    <span class="kd">public</span> <span class="kt">void</span> <span class="nf">finishMapJson</span><span class="o">(</span><span class="kd">final</span> <span class="n">Object</span><span class="o">...</span> <span class="n">objs</span><span class="o">);</span>
+
     <span class="c1">//将对象以JSON格式输出</span>
     <span class="kd">public</span> <span class="kt">void</span> <span class="nf">finishJson</span><span class="o">(</span><span class="n">JsonConvert</span> <span class="n">convert</span><span class="o">,</span> <span class="n">Object</span> <span class="n">obj</span><span class="o">);</span>
 
+    <span class="c1">//将对象数组用Map的形式以JSON格式输出</span>
+    <span class="c1">//例如: finishMap("a",2,"b",3) 输出结果为 {"a":2,"b":3}</span>
+    <span class="kd">public</span> <span class="kt">void</span> <span class="nf">finishMapJson</span><span class="o">(</span><span class="kd">final</span> <span class="n">JsonConvert</span> <span class="n">convert</span><span class="o">,</span> <span class="kd">final</span> <span class="n">Object</span><span class="o">...</span> <span class="n">objs</span><span class="o">);</span>
+
     <span class="c1">//将对象以JSON格式输出</span>
     <span class="kd">public</span> <span class="kt">void</span> <span class="nf">finishJson</span><span class="o">(</span><span class="n">Type</span> <span class="n">type</span><span class="o">,</span> <span class="n">Object</span> <span class="n">obj</span><span class="o">);</span>
 
@@ -638,16 +675,25 @@
 
     <span class="c1">//将HttpResult的结果对象以JSON格式输出</span>
     <span class="kd">public</span> <span class="kt">void</span> <span class="nf">finishJson</span><span class="o">(</span><span class="kd">final</span> <span class="n">HttpResult</span> <span class="n">result</span><span class="o">);</span>
-    
+
     <span class="c1">//将HttpResult的结果对象以JSON格式输出</span>
-    <span class="kd">public</span> <span class="kt">void</span> <span class="nf">finishJson</span><span class="o">(</span><span class="kd">final</span> <span class="n">JsonConvert</span> <span class="n">convert</span><span class="o">,</span> <span class="kd">final</span> <span class="n">HttpResult</span> <span class="n">result</span><span class="o">)</span> <span class="o">;</span>
-    
+    <span class="kd">public</span> <span class="kt">void</span> <span class="nf">finishJson</span><span class="o">(</span><span class="kd">final</span> <span class="n">JsonConvert</span> <span class="n">convert</span><span class="o">,</span> <span class="kd">final</span> <span class="n">HttpResult</span> <span class="n">result</span><span class="o">);</span>
+
     <span class="c1">//将指定字符串以响应结果输出</span>
     <span class="kd">public</span> <span class="kt">void</span> <span class="nf">finish</span><span class="o">(</span><span class="n">String</span> <span class="n">obj</span><span class="o">);</span>
 
     <span class="c1">//以指定响应码附带内容输出, message 可以为null</span>
     <span class="kd">public</span> <span class="kt">void</span> <span class="nf">finish</span><span class="o">(</span><span class="kt">int</span> <span class="n">status</span><span class="o">,</span> <span class="n">String</span> <span class="n">message</span><span class="o">);</span>
 
+    <span class="c1">//将结果对象输出</span>
+    <span class="kd">public</span> <span class="kt">void</span> <span class="nf">finish</span><span class="o">(</span><span class="kd">final</span> <span class="n">Object</span> <span class="n">obj</span><span class="o">);</span>
+
+    <span class="c1">//将结果对象输出</span>
+    <span class="kd">public</span> <span class="kt">void</span> <span class="nf">finish</span><span class="o">(</span><span class="kd">final</span> <span class="n">Convert</span> <span class="n">convert</span><span class="o">,</span> <span class="kd">final</span> <span class="n">Object</span> <span class="n">obj</span><span class="o">);</span>
+
+    <span class="c1">//将结果对象输出</span>
+    <span class="kd">public</span> <span class="kt">void</span> <span class="nf">finish</span><span class="o">(</span><span class="kd">final</span> <span class="n">Convert</span> <span class="n">convert</span><span class="o">,</span> <span class="kd">final</span> <span class="n">Type</span> <span class="n">type</span><span class="o">,</span> <span class="kd">final</span> <span class="n">Object</span> <span class="n">obj</span><span class="o">);</span>
+
     <span class="c1">//以304状态码输出</span>
     <span class="kd">public</span> <span class="kt">void</span> <span class="nf">finish304</span><span class="o">();</span>
 
@@ -681,7 +727,7 @@
     <span class="kd">public</span> <span class="kt">void</span> <span class="nf">recycleListener</span><span class="o">(</span><span class="n">BiConsumer</span><span class="o">&lt;</span><span class="n">HttpRequest</span><span class="o">,</span> <span class="n">HttpResponse</span><span class="o">&gt;</span> <span class="n">recycleListener</span><span class="o">);</span>
 
 <span class="o">}</span>
-                </pre></div>
+</pre></div>
 
 
             <p id="net_websocket">&nbsp;&nbsp;<b>. WebSocket 对象</b> </p>