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>
  
 
 
 
 
  • 2d324cc7-638f-3509-8b35-f4d9178e5c90-thumb.png
  • 大小: 73.7 KB
  • 3c59120d-a2ad-365b-a8d0-cb02a74e7824-thumb.png
  • 大小: 21.7 KB
阅读更多
想对作者说点什么?

博主推荐

换一批

没有更多推荐了,返回首页