From 311eac27948c461ce1f17242a6aa08d0cfe0804b Mon Sep 17 00:00:00 2001 From: wentch <22250530@qq.com> Date: Tue, 5 Jan 2016 10:22:20 +0800 Subject: [PATCH] --- convert.html | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/convert.html b/convert.html index 609583513..ebebd2efd 100644 --- a/convert.html +++ b/convert.html @@ -30,7 +30,7 @@

Convert 快速上手

      本介绍仅以JSON为例(BSON与JSON使用方式雷同)。其操作类主要是JsonConvert，配置类主要是JsonFactory、ConvertColumn。

-

      JsonConvert 序列化Encode方法：

+

      JsonConvert 序列化encode方法：

    public String convertTo(Object value);
 
@@ -48,7 +48,7 @@
 
     public ByteBuffer[] convertTo(final Charset charset, final Supplier<ByteBuffer> supplier, Object value);
-

      JsonConvert 反解析Decode方法：

+

      JsonConvert 反解析decode方法：

    public <T> T convertFrom(final Type type, final String text);
 
     public <T> T convertFrom(final Type type, final char[] text);
@@ -65,7 +65,8 @@
         resp.setContentType("text/json; charset=UTF-8");
         resp.getOutputStream().write(json.getBytes("UTF-8"));
     }
-

      几乎所有的JSON框架提供的接口以String作为返回结果为主，其内在都是以char[]作为JsonWriter的载体。以Gson为例，Gson拼接JSON默认使用的是StringWriter，StringWriter的扩容策略是翻倍。为了方便计算，假设一个对象转换成JSON字符串大小为了10K。Gson在转换过程中产生的临时的char[]的大小: 16 + 32 + 64 + 128 + 256 + 512 + 1K + 2K + 4K + 8K + 16K = 32K, char[]转换成最终的String结果又会产生10K的char[], 最后在response输出时又回产生10K的byte[]（方便计算不考虑双字节）,也就是说整个对象输出过程中会产生52K的临时数据。同时常见的HTTP服务器(如实现java-servlet规范的服务器)不会把底层的ByteBuffer对象池暴露给上层。所以目前所有使用其他JSON框架输出数据都会产生5倍于数据体积大小的垃圾数据。而RedKale框架的HTTP服务内置了Convert的JSON接口，避免了这么大量的垃圾数据产生。

+

      几乎所有的JSON框架提供的接口以String作为返回结果为主，其内在都是以char[]作为JsonWriter的载体。以Gson为例，Gson拼接JSON默认使用的是StringWriter，StringWriter的扩容策略是翻倍。为了方便计算，假设一个对象转换成JSON字符串大小为了10K。Gson在转换过程中产生的临时的char[]的大小: 16 + 32 + 64 + 128 + 256 + 512 + 1K + 2K + 4K + 8K + 16K = 32K, char[]转换成最终的String结果又会产生10K的char[], 最后在response输出时又回产生10K的byte[]（方便计算不考虑双字节）,也就是说整个对象输出过程中会产生52K的临时数据。而且常见的HTTP服务器(如实现java-servlet规范的服务器)不会把底层的ByteBuffer对象池暴露给上层。所以目前所有使用其他JSON框架输出数据都会产生至少5倍于数据体积大小(其他低于1倍扩容策略的框架会产生更多)的垃圾数据。
+       RedKale框架的HTTP服务内置了Convert的JSON接口，避免了这么大量的垃圾数据产生。finishJson方法将HTTP服务的ByteBuffer对象池传给Convert， 使Convert在序列化过程中直接以UTF-8编码方式输出到ByteBuffer里。

    protected void execute(HttpRequest req, HttpResponse resp) throws IOException {
         resp.finishJson(record);
     }