FastJson-JSONField

学习摘要自
https://github.com/alibaba/fastjson
http://blog.csdn.net/zimo2013/article/details/10474107

Maven依赖
仓库地址
http://repo1.maven.org/maven2/com/alibaba/fastjson/
选择版本、建议使用最新版本

<dependency>    <groupId>com.alibaba</groupId>    <artifactId>fastjson</artifactId>    <version>1.1.37</version></dependency>

最常用的工具类和两个方法

JSON 序列化对象为json文本，包括普遍Javabean,Map,List,嵌套对象JSON.toJSONString(Object object) 序列化对象JSON.toJSONString(Object object, boolean prettyFormat)，序列化对象，并以良好的格式呈现

例如

    @Test    public void testJSonBean() throws Exception {        Model m = new Model(); //普通Java VO        m.setName("xiele");        m.setDate(new Date());        m.setIg(1);        m.setLg(1000L);        System.out.println(JSON.toJSONString(m));    }    输出的文本：    {"name":"xiele","date":1437487740477,"lg":1000,"ig":1}    如果带上prettyFormat为true    JSON.toJSONString(m,true)    {    "name":"xiele",    "date":1437487867654,    "lg":1000,    "ig":1}

配置一些辅助的序列化功能（SerialFeature）

public static final String toJSONString(Object object, SerializerFeature... features)参考源码public enum SerializerFeature {    QuoteFieldNames, //序列化输出含引号的字段,默认    UseSingleQuotes, //使用单引号而不是双引号序列化    WriteMapNullValue, //空值是否输出，默认不输出null    WriteEnumUsingToString,Enum输出为枚举值    UseISO8601DateFormat, //Date使用ISO8601格式输出日期    WriteNullListAsEmpty,//list字段如果为null，输出为[]，而不是null,默认不输出null    WriteNullStringAsEmpty,//字符串类型为null,输出""（空串）    WriteNullNumberAsZero, //数值字段如果为null，输出为0，而不是null    WriteNullBooleanAsFalse, //Boolean字段如果为null，输出为false，而不是null    SkipTransientField, //忽略@Transient注解过的字段    SortField //按字段名称排序后输出  }

用法

JSON.toJSONString(m,SerializerFeature.UseISO8601DateFormat)

定制序列化
在做网关开发时，为移动端提供的很多数据都需要简化处理，比如VO的key需要定制输出，可使用FastJson提供的@JSONField注解。
@JSONField有两种方式
1.在字段上
2.在属性getter方法上
例如

 public class VO {      @JSONField(name="ID")      private int id; } public class VO {      private int id;      @JSONField(name="ID")      public int getId() { return id;} }

但是
在使用FastJson的@JSONField做定制时，偶尔不生效，也包含了继承的情况，有时候会出现结果不一致。
官方给出的解释是版本过低，升级到fastjson-1.1.42及其以后即可。
https://github.com/alibaba/fastjson/issues/176

需求是变化的，尽管有时候需要定制，有的终端需要定制，但是又需要复用发布出去的VO，但是需要解除由@JSONField定制带来的困扰。
解决办法，是通过反射找到VO的字段Field，然后得到其注解，并获取到注解的值，最后存入Map中，使得定制的名称和原来的字段名形成Key-Value绑定。再通过FastJson提供的NameFilter名称过滤器来过滤序列的名称。

获取注解的值

    @Test    public void testGetFieldAnno() throws Exception {        Map<String, String> map = Maps.newHashMap();        Model m = new Model();        Field[] fs =  m.getClass().getDeclaredFields();        for (Field f : fs) {            if (f.isAnnotationPresent(JSONField.class)) {                JSONField jf = f.getAnnotation(JSONField.class);                map.put(jf.name(), f.getName());            }        }        System.out.println(JSON.toJSONString(map,true));    }

过滤名称

 @Test    public void testMapJSonField()  {        Model m = new Model();        m.setName("xiele");        m.setDate(new Date());        m.setIg(1);        m.setLg(1000L);        final  Map<String, String> map = Maps.newHashMap();        Field[] fs =  m.getClass().getDeclaredFields();        for (Field f : fs) {            if (f.isAnnotationPresent(JSONField.class)) {                JSONField jf = f.getAnnotation(JSONField.class);                map.put(jf.name(), f.getName());            }        }        System.out.println(JSON.toJSONString(map,true));        NameFilter filter = new NameFilter() {            @Override            public String process(Object source, String name, Object value) {                // source是当前对象， name是key， value实在值                return map.get(name);            }        };        JSONSerializer jsonSerializer = new JSONSerializer();        jsonSerializer.getNameFilters().add(filter); // 通过增加一个过滤器，为name和值进行过滤        jsonSerializer.write(m);        System.out.println(jsonSerializer.toString());    }

除此之外，FastJson还提供了属性过滤器PropertyFilter、值过滤器ValueFilter，用法类似。