• alibaba fastjson的使用总结和心得


     
    最初接触alibaba fastjson是由于其性能上的优势,对比原来采用codehause.jackson的解析,在hadoop平台上的手动转换对象有着将近1/3的性能提升,但随着开发应用越来越多,渐渐地也发现了在其他方面的强大之处,例如直接转化泛型(jackson对泛型的支持相对来说就比较差)。
     
    Fastjson会自动处理对象中的泛型,将其解析成原来定义好的对象,建议一定要将泛型类型定义精确,以避免出现歧义,例如如果使用Map<String, Object> 就并不是一个定义良好的泛型,我们也并不知道Object对象真正表示的是什么,而fastjson解析Object时,由于不知道其具体类型,只能将其转化成JSONObject(结构类似一个Map,有着key和value)。
     

    泛型类型解析

     
    如果顶层类型中存在泛型,就会出现不知道确切类型的状况,因为Class是无法携带泛型信息的,Java中不存在一个类型为List<String>.class,如果这样使用,Fastjson会将对象解析成JSONObject。
     
    alibaba fastjson提供了一套TypeReference相关的方法来解决这个问题,从源代码来看定义不是很长:
     
    public class TypeReference<T> {
    
        private final Type type;
    
        protected TypeReference(){
            Type superClass = getClass().getGenericSuperclass();
    
            type = ((ParameterizedType) superClass).getActualTypeArguments()[0];
        }
    
        public Type getType() {
            return type;
        }
    
        public final static Type LIST_STRING = new TypeReference<List<String>>() {}.getType();
    }
    
     
     
    构造函数中做了两件事,先从当前的Class.getGenericSuperclass,返回该Class表示的实体或直接超类的Type,重点在与,如果是参数化类型,返回的Type中会带上该类型,我们看一下这个方法的定义及其作用:
     

    getGenericSuperclass

    public Type getGenericSuperclass()
    
    
    返回表示此 Class 所表示的实体(类、接口、基本类型或 void)的直接超类的 Type

    如果超类是参数化类型,则返回的 Type 对象必须准确反映源代码中所使用的实际类型参数。如果以前未曾创建表示超类的参数化类型,则创建这个类型。有关参数化类型创建过程的语义,请参阅 ParameterizedType 声明。如果此 Class 表示 Object 类、接口、基本类型或 void,则返回 null。如果此对象表示一个数组类,则返回表示 Object 类的 Class 对象。

    返回:
    此对象所表示的类的超类
    抛出:
    GenericSignatureFormatError - 如果常规类签名不符合 Java Virtual Machine Specification, 3rd edition 规定的格式
    TypeNotPresentException - 如果常规超类引用不存在的类型声明
    MalformedParameterizedTypeException - 如果常规超类引用的参数化类型由于某种原因无法实例化
    从以下版本开始:
    1.5
     
    从文档中可以看出,如果其超类是参数化类型,返回的Type就为sun.reflect.generics.reflectiveObjects.ParameterizedTypeImpl类型,其继承自java.lang.reflect.ParameterizedType,用来表示参数化类型。
     
    参数化类型中就可以从getActualTypeArguments中获取,因为TypeReference只有一个参数化类型定义,因此可以确定返回的数组肯定有一个元素(如果是Map就存在两个元素),这样type就为其参数化类型了,我们通过这个定义将对象的泛型传入至后续的json处理逻辑中。
     

    getActualTypeArguments

    Type[] getActualTypeArguments()
    
    
    返回表示此类型实际类型参数的 Type 对象的数组。

    注意,在某些情况下,返回的数组为空。如果此类型表示嵌套在参数化类型中的非参数化类型,则会发生这种情况。

    返回:
    表示此类型的实际类型参数的 Type 对象的数组
    抛出:
    TypeNotPresentException - 如果任何实际类型参数引用不存在的类型声明
    MalformedParameterizedTypeException - 如果任何实际类型参数引用参数化类型,该类型出于某种原因无法被实例化
    从以下版本开始:
    1.5
     
    所以使用该类的方法只有一种,就是继承,因此其构造方法为protected,只能允许子类来调用,在构造该对象时,就需要在声明最后加上{}来表示继承关系。
     
    java.util.Map<java.lang.String, com.xxx.commons.json.test.JsonTest$InnerObj>
    
     
     
     
     

    关于类型转换

     
    如果是数组,由于某种对象的数组是存在对应的Class类型信息的,也就是说可以直接直接以Class的方式转换成功。
     
    当时如果没有指定类型,就会转换成JSONObject,在其中以key/value的方式(类似Map)存储。
     
    如果是数组,转成JSONArray,在其中包装JSONObject
     



     
     
     
    如果我们使用TypeReference,指定其为List<String>,而List中其实是对象,那么直接转换成String,此时字符串就为json字符串。
     
    如果事先不知道该json串的类型信息(json事先也无法知道其类型信息,而Java的序列化,是带类型信息的,因此携带的内容也要比json串丰富地多,耗费网络带宽也大),或者在Map中写不出统一的泛型,那么就会发生隐性的类型转换过程。在codehaus jackson中会将无法识别的json对象直接转换成Map(key,value)格式,如果是fastjson,则转换成JSONObject(其实也类似于json)。如果需要将该对象仍然转换成json格式,不会有任何问题,但如果想要以原来的对象方式操作它,就会出现问题了(因为没有对象信息,除非手动将其转换,但每部分都需要手写代码,比较麻烦)。
     
     
    Map中字段为null不被持久化的问题
     
    如果Map中的某个属性为null,并不会被持久化,可以参考
     
     
    如果想让Map中的字段能够正常输出(这也是我们需要的),就需要在转换toJSONString时设置特殊的Feature来完成该功能:
     
    JSON.toJSONString(object, SerializerFeature.WriteMapNullValue)
     
     

    关于Feature

     
     
    Fastjson中存在多种SerializerFeature,可以按照需要使用,例如
     
    • SerializerFeature.UseSingleQuotes,//支持单引号
    • SerializerFeature.WriteDateUseDateFormat,//日期格式化 
    • SerializerFeature.WriteMapNullValue, // 输出空置字段
    • SerializerFeature.WriteNullListAsEmpty, // list字段如果为null,输出为[],而不是null
    • SerializerFeature.WriteNullNumberAsZero, // 数值字段如果为null,输出为0,而不是null
    • SerializerFeature.WriteNullBooleanAsFalse, // Boolean字段如果为null,输出为false,而不是null
    • SerializerFeature.WriteNullStringAsEmpty // 字符类型字段如果为null,输出为"",而不是null
     
    很多场景中,我们需要序列化的对象中存在循环引用,在许多的json库中,这会导致stackoverflow。在功能强大的fastjson中,你不需要担心这个问题。
     
    使用@JSONField Annotation来定制化序列化字段的名称,还可以使用@JSONCreator来指定构造函数来创建对象,配合@JSONField来确定字段的名称。
     
    如果使用新特性SerializerFeature.WriteClassName,可以在序列化的文本中加入@type信息,这样就可以进行合理的反序列化,因为知道了类型信息,可以通过默认的构造以及属性名称自动设置,此时反序列化的结果类似下面:
     
    {"@type":"java.awt.Color","r":255,"g":0,"b":0,"alpha":255}
     
     
    此时就可以进行自动识别,但此时输出的文本就会多出一倍的空间,因此如果有着明确的类型,不建议使用这种方式。
     
    String text = ...; // {"@type":"java.awt.Color","r":255,"g":0,"b":0,"alpha":255}
    Color color = (Color) JSON.parse(text);
     
     
    这样可以解决一些序列化泛型中接口的问题,
     
    还举例说明了可以使用组合类型,fastjson对这种结构的反序列化有专门支持:
     
    String text = ...; // [{/* header */}, {/* body */}]
    Type[] types = new  Type[] {Header.class, Body.class};
    List<Object> list = JSON.parseArray(text, types);
    Header header = (Header) list.get(0);
    Body body = (Body) list.get(1);
     
     
    在使用WriteClassName这个Feature来进行写Map等操作时,有一个问题,其中的List以及数组在被转化回来时无法识别,会被自动转换成JSONArray而不是原始的List,数组对象。如果用户原来使用的List,这个问题可以得到完美的解决,看一下JSONArray的定义,
     
    /**
     * @author wenshao[szujobs@hotmail.com]
     */
    public class JSONArray extends JSON implements List<Object>, Cloneable, RandomAccess, Serializable { 
    
     
    可以对其进行强制转换List即可。
     
    但是如果原始类型为数组类型,则只能够通过toArray方法,至于网友提出的能否直接使用Object[],其开发者给出了预期(只不过在1.2.9上也并未见其实现)。
     


     
     
    但在1.2.9版本并没有看到这个Feature,所以还是拭目以待吧。
     
    <!--?xml version="1.0" encoding="UTF-8" standalone="no"?-->
    此外,我们在使用SpringMVC时,默认使用的json格式RequestMapper转换实现应该是jackson实现的,当然可以将其替换成fastjson的实现:
     
    <bean
            class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping" />
        <!-- HandlerAdapter -->
        <bean
            class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter">
            <property name="messageConverters">
                <list>
                    <bean
                        class="com.alibaba.fastjson.support.spring.FastJsonHttpMessageConverter">
                        <property name="features">
                            <array value-type="com.alibaba.fastjson.serializer.SerializerFeature">
                                <value>WriteDateUseDateFormat</value>
                                <value>WriteMapNullValue</value>
                            </array>
                        </property>
                    </bean>
                </list>
            </property>
        </bean>
      
     
     
     
     
  • 相关阅读:
    2013第38周日Java文件上传下载收集思考
    2013年第38周六这一刻,行动
    2013年9月20日突然的焦虑
    2013中秋
    2013第38周三
    2013年第38周二
    2013第38周一电话开会邮件
    for循环中一个不容小觑的问题
    NPOI 创建Excel,数据读取与写入
    linux下mysql数据的导出和导入
  • 原文地址:https://www.cnblogs.com/mmaa/p/5789866.html
Copyright © 2020-2023  润新知