让Jackson JSON生成的数据包含的中文以unicode方式编码

时间  2019-11-08
标签 jackson json 生成 数据 包含 中文 unicode 方式 编码 栏目 JavaScript 繁體版
原文   原文链接
 
本文出处：http://blog.csdn.net/chaijunkun/article/details/8257209，转载请注明。因为本人不按期会整理相关博文，会对相应内容做出完善。所以强烈建议在原始出处查看此文。

在年初的时候，我曾经写过一篇文章介绍非关系型数据库MongoDB和Jackson JSON框架相结合实现接口敏捷开发的文章（http://blog.csdn.net/chaijunkun/article/details/7263804），被可爱的CSDN小编推到了首页。在此本人对小编表示感谢。事隔10个月，随着手头一些项目的进行，对Jackson JSON框架用得愈来愈多。以为有必要再写点什么补充出来。做为和广大同仁的一个经验的分享。


咱们都知道，Jackson JSON以高速、方便和灵活著称。以前的文章中介绍过使用注解的形式来规定如何将一个对象序列化成JSON的方法，以及如何将一个JSON数据反序列化到一个对象上。可是美中不足的一点就是对于中文的处理。固然我说的美中不足是在默认状况下，Jackson JSON不会将中文等非ASCII字符转换为\uFFFF这样的形式来显示。也就是说默认状况下会显示为{"name":"张三"}而不是{"name":"\u5F20\u4E09"}。那么为何有这样的需求呢？在HTTP协议中，咱们能够指定数据头部分的内容编码。如：“GBK”、“UTF-8”等等。若是你设置正确了，那么OK，前者所表示的数据您能够正确处理。然而若是设置错误，对于中文字符将会产生乱码。两套应用系统对接，有可能两边使用的默认编码不一样，若是一方修改默认编码将会对应用形成不可预知的后果。所以若能以长远的眼光开发，那么不管您设置成什么编码方式，都不会使数据产生乱码。由于，这里用到了万国编码——Unicode。


好的，问题出来了，咱们如何解决呢？使其经过实验，Jackson JSON其实在默认设置下已经具有了对Unicode编码的JSON数据进行解析。所欠缺的就是在序列化对象时缺乏相应的步骤。好在Jackson JSON框架容许咱们自定义序列化方法。那么咱们就来写一个序列化类：java

 

[java]  view plain  copy
 
 在CODE上查看代码片派生到个人代码片
  1. package net.csdn.blog.chaijunkun.util;  
  2.   
  3. import java.io.IOException;  
  4.   
  5. import org.codehaus.jackson.JsonGenerationException;  
  6. import org.codehaus.jackson.JsonGenerator;  
  7. import org.codehaus.jackson.JsonProcessingException;  
  8. import org.codehaus.jackson.impl.JsonWriteContext;  
  9. import org.codehaus.jackson.map.JsonSerializer;  
  10. import org.codehaus.jackson.map.SerializerProvider;  
  11. import org.codehaus.jackson.util.CharTypes;  
  12.   
  13. public class StringUnicodeSerializer extends JsonSerializer<String> {  
  14.   
  15.     private final char[] HEX_CHARS = "0123456789ABCDEF".toCharArray();  
  16.     private final int[] ESCAPE_CODES = CharTypes.get7BitOutputEscapes();  
  17.   
  18.     private void writeUnicodeEscape(JsonGenerator gen, char c) throws IOException {  
  19.         gen.writeRaw('\\');  
  20.         gen.writeRaw('u');  
  21.         gen.writeRaw(HEX_CHARS[(c >> 12) & 0xF]);  
  22.         gen.writeRaw(HEX_CHARS[(c >> 8) & 0xF]);  
  23.         gen.writeRaw(HEX_CHARS[(c >> 4) & 0xF]);  
  24.         gen.writeRaw(HEX_CHARS[c & 0xF]);  
  25.     }  
  26.   
  27.     private void writeShortEscape(JsonGenerator gen, char c) throws IOException {  
  28.         gen.writeRaw('\\');  
  29.         gen.writeRaw(c);  
  30.     }  
  31.   
  32.     @Override  
  33.     public void serialize(String str, JsonGenerator gen,  
  34.             SerializerProvider provider) throws IOException,  
  35.             JsonProcessingException {  
  36.         int status = ((JsonWriteContext) gen.getOutputContext()).writeValue();  
  37.         switch (status) {  
  38.           case JsonWriteContext.STATUS_OK_AFTER_COLON:  
  39.             gen.writeRaw(':');  
  40.             break;  
  41.           case JsonWriteContext.STATUS_OK_AFTER_COMMA:  
  42.             gen.writeRaw(',');  
  43.             break;  
  44.           case JsonWriteContext.STATUS_EXPECT_NAME:  
  45.             throw new JsonGenerationException("Can not write string value here");  
  46.         }  
  47.         gen.writeRaw('"');//写入JSON中字符串的开头引号  
  48.         for (char c : str.toCharArray()) {  
  49.           if (c >= 0x80){  
  50.               writeUnicodeEscape(gen, c); // 为全部非ASCII字符生成转义的unicode字符  
  51.           }else {  
  52.             // 为ASCII字符中前128个字符使用转义的unicode字符  
  53.             int code = (c < ESCAPE_CODES.length ? ESCAPE_CODES[c] : 0);  
  54.             if (code == 0){  
  55.                 gen.writeRaw(c); // 此处不用转义  
  56.             }else if (code < 0){  
  57.                 writeUnicodeEscape(gen, (char) (-code - 1)); // 通用转义字符  
  58.             }else {  
  59.                 writeShortEscape(gen, (char) code); // 短转义字符 (\n \t ...)  
  60.             }  
  61.           }  
  62.         }  
  63.         gen.writeRaw('"');//写入JSON中字符串的结束引号  
  64.     }  
  65.   
  66. }  

这个序列化类将要对应用中全部使用Jackson JSON的地方全都用一种方法来处理字符串类型。光有了方法还不行，还要对它进行注册。让Jackson JSON在序列化对象的时候使用刚刚定义好的方法：

 

 

[java]  view plain  copy
 
 在CODE上查看代码片派生到个人代码片
  1. if (objectMapper== null){  
  2.     objectMapper= new ObjectMapper();  
  3.     //当找不到对应的序列化器时 忽略此字段  
  4.     objectMapper.configure(SerializationConfig.Feature.FAIL_ON_EMPTY_BEANS, false);  
  5.     //使Jackson JSON支持Unicode编码非ASCII字符  
  6.     CustomSerializerFactory serializerFactory= new CustomSerializerFactory();  
  7.     serializerFactory.addSpecificMapping(String.class, new StringUnicodeSerializer());  
  8.     objectMapper.setSerializerFactory(serializerFactory);  
  9.     //支持结束  
  10. }  

 

2014年5月13日补充：最近被问到不少次关于单例模式的实现。上面的写法真的很不安全，没有加锁，也没有对objectMapper进行volatile修饰（即所谓的“双检索”货“双重检查”），所以最简单的可靠的方法应该使用“枚举单例法”。数据库

 

2014年11月21日补充：因为Jackson 2的版本变化，CustomSerializerFactory已经被去掉了，通过实验，可使用这种方式代替：apache

 

[java]  view plain  copy
 
 在CODE上查看代码片派生到个人代码片
  1. if (objectMapper== null){  
  2.     objectMapper= new ObjectMapper();  
  3.     //当找不到对应的序列化器时 忽略此字段  
  4.     objectMapper.configure(SerializationFeature.FAIL_ON_EMPTY_BEANS, false);  
  5.     //使Jackson JSON支持Unicode编码非ASCII字符  
  6.     SimpleModule module = new SimpleModule();  
  7.     module.addSerializer(String.class, new StringUnicodeSerializer());  
  8.     objectMapper.registerModule(module);  
  9.     //设置null值不参与序列化(字段不被显示)  
  10.     objectMapper.setSerializationInclusion(Include.NON_NULL);  
  11.     //支持结束  
  12. }  


 

 

接下来咱们来作一个测试用的对象，验证咱们的代码：json

 

[java]  view plain  copy
 
 在CODE上查看代码片派生到个人代码片
  1. package net.csdn.blog.chaijunkun.json;  
  2.   
  3. import java.util.Date;  
  4.   
  5. import net.csdn.blog.chaijunkun.util.DateDeserializer;  
  6. import net.csdn.blog.chaijunkun.util.DateSerializer;  
  7. import net.csdn.blog.chaijunkun.util.DateTimeDeserializer;  
  8. import net.csdn.blog.chaijunkun.util.DateTimeSerializer;  
  9.   
  10. import org.codehaus.jackson.annotate.JsonPropertyOrder;  
  11. import org.codehaus.jackson.map.annotate.JsonDeserialize;  
  12. import org.codehaus.jackson.map.annotate.JsonSerialize;  
  13.   
  14. @JsonPropertyOrder(alphabetic= false)  
  15. public class DemoObj {  
  16.       
  17.     private Integer sid;  
  18.       
  19.     private String stuName;  
  20.       
  21.     private Boolean sex;  
  22.       
  23.     @JsonSerialize(using= DateSerializer.class)  
  24.     @JsonDeserialize(using= DateDeserializer.class)  
  25.     private Date birthday;  
  26.       
  27.     @JsonSerialize(using= DateTimeSerializer.class)  
  28.     @JsonDeserialize(using= DateTimeDeserializer.class)  
  29.     private Date logTime;  
  30.   
  31.     //Getters and Setters  
  32.       
  33. }  

从代码上能够看出，咱们并无对String类型的属性强制指定用何种序列与反序列方法。而后咱们来构造测试用例：

 

 

[java]  view plain  copy
 
 在CODE上查看代码片派生到个人代码片
  1. package net.csdn.blog.chaijunkun.test;  
  2.   
  3. import java.text.SimpleDateFormat;  
  4. import java.util.Calendar;  
  5. import java.util.Date;  
  6.   
  7. import net.csdn.blog.chaijunkun.json.DemoObj;  
  8. import net.csdn.blog.chaijunkun.util.JSONUtil;  
  9.   
  10. import org.apache.log4j.Logger;  
  11.   
  12. public class JSONTest {  
  13.       
  14.     private static Logger logger= Logger.getLogger(JSONTest.class);  
  15.       
  16.     private static String json= "{\"sid\":2,\"stuName\":\"\u6C5F\u5357Style\",\"sex\":true,\"birthday\":\"2012-07-15\",\"logTime\":\"2012-12-04 19:22:36\"}";  
  17.       
  18.     public static void main(String[] args) {  
  19.         DemoObj objSrc= new DemoObj();  
  20.         objSrc.setSid(1);  
  21.         objSrc.setStuName("鸟叔");  
  22.         objSrc.setSex(true);  
  23.         Calendar calendar= Calendar.getInstance();  
  24.         calendar.set(1977, Calendar.DECEMBER, 31, 0, 0, 0);  
  25.         objSrc.setBirthday(calendar.getTime());  
  26.         objSrc.setLogTime(new Date());  
  27.         logger.info(String.format("转换为JSON后的数据:%s", JSONUtil.toJSON(objSrc)));  
  28.         DemoObj objDes= JSONUtil.fromJSON(json, DemoObj.class);  
  29.         if(objDes==null){  
  30.             logger.info("反序列化失败");  
  31.         }else{  
  32.             logger.info("反序列化成功");  
  33.             SimpleDateFormat sdf= new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");  
  34.             logger.info(String.format("标识：%d", objDes.getSid()));  
  35.             logger.info(String.format("姓名：%s", objDes.getStuName()));  
  36.             logger.info(String.format("性别：%s", objDes.getSex()==true?"男":"女"));  
  37.             logger.info(String.format("生日：%s", sdf.format(objDes.getBirthday())));  
  38.             logger.info(String.format("登陆日期：%s", sdf.format(objDes.getLogTime())));  
  39.         }  
  40.     }  
  41.   
  42. }  

 

看一下输出：安全

 

[plain]  view plain  copy
 
 在CODE上查看代码片派生到个人代码片
  1. 转换为JSON后的数据:{"sid":1,"stuName":"\u9E1F\u53D4","sex":true,"birthday":"1977-12-31","logTime":"2012-12-04 19:31:57"}  
  2. 反序列化成功  
  3. 标识：2  
  4. 姓名：江南Style  
  5. 性别：男  
  6. 生日：2012-07-15 00:00:00  
  7. 登陆日期：2012-12-04 19:22:36  

咱们看到，已经成功将中文字符显示成为了Unicode编码的数据。一样，咱们以前构造的Unicode编码的数据，在不通过任何修改的状况下成功显示出来了。

 

 

细心的朋友也许观察到了，在测试用的对象定义代码中，针对一样Date类型的属性“birthday”和“logTime”，咱们指定了不一样的序列化与反序列化方法。让咱们来看烂这两个有什么不一样：app

 

[java]  view plain  copy
 
 在CODE上查看代码片派生到个人代码片
  1. package net.csdn.blog.chaijunkun.util;  
  2.   
  3. import java.io.IOException;  
  4. import java.text.SimpleDateFormat;  
  5. import java.util.Date;  
  6.   
  7. import org.codehaus.jackson.JsonGenerator;  
  8. import org.codehaus.jackson.JsonProcessingException;  
  9. import org.codehaus.jackson.map.JsonSerializer;  
  10. import org.codehaus.jackson.map.SerializerProvider;  
  11.   
  12. public class DateTimeSerializer extends JsonSerializer<Date> {  
  13.   
  14.     @Override  
  15.     public void serialize(Date date, JsonGenerator gen, SerializerProvider provider)  
  16.             throws IOException, JsonProcessingException {  
  17.         SimpleDateFormat sdf=new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");  
  18.         String formattedDate= sdf.format(date);  
  19.         gen.writeString(formattedDate);  
  20.     }  
  21.   
  22. }  

[java]  view plain  copy
 
 在CODE上查看代码片派生到个人代码片
  1. package net.csdn.blog.chaijunkun.util;  
  2.   
  3. import java.io.IOException;  
  4. import java.text.SimpleDateFormat;  
  5. import java.util.Calendar;  
  6. import java.util.Date;  
  7.   
  8. import org.codehaus.jackson.JsonParser;  
  9. import org.codehaus.jackson.JsonProcessingException;  
  10. import org.codehaus.jackson.map.DeserializationContext;  
  11. import org.codehaus.jackson.map.JsonDeserializer;  
  12.   
  13. public class DateTimeDeserializer extends JsonDeserializer<Date> {  
  14.   
  15.     @Override  
  16.     public Date deserialize(JsonParser parser, DeserializationContext context)  
  17.     throws IOException, JsonProcessingException {  
  18.         String dateFormat= "yyyy-MM-dd HH:mm:ss";  
  19.         SimpleDateFormat sdf= new SimpleDateFormat(dateFormat);  
  20.         try{  
  21.             String fieldData= parser.getText();  
  22.             return sdf.parse(fieldData);  
  23.         }catch (Exception e) {  
  24.             Calendar ca= Calendar.getInstance();  
  25.             ca.set(1970, Calendar.JANUARY, 1, 0, 0, 0);  
  26.             return ca.getTime();  
  27.         }  
  28.     }  
  29. }  

[java]  view plain  copy
 
 在CODE上查看代码片派生到个人代码片
  1. package net.csdn.blog.chaijunkun.util;  
  2.   
  3. import java.io.IOException;  
  4. import java.text.SimpleDateFormat;  
  5. import java.util.Date;  
  6.   
  7. import org.codehaus.jackson.JsonGenerator;  
  8. import org.codehaus.jackson.JsonProcessingException;  
  9. import org.codehaus.jackson.map.JsonSerializer;  
  10. import org.codehaus.jackson.map.SerializerProvider;  
  11.   
  12. public class DateSerializer extends JsonSerializer<Date> {  
  13.   
  14.     @Override  
  15.     public void serialize(Date date, JsonGenerator gen, SerializerProvider provider)  
  16.             throws IOException, JsonProcessingException {  
  17.         SimpleDateFormat sdf=new SimpleDateFormat("yyyy-MM-dd");  
  18.         String formattedDate= sdf.format(date);  
  19.         gen.writeString(formattedDate);  
  20.     }  
  21.   
  22. }  

[java]  view plain  copy
 
 在CODE上查看代码片派生到个人代码片
  1. package net.csdn.blog.chaijunkun.util;  
  2.   
  3. import java.io.IOException;  
  4. import java.text.SimpleDateFormat;  
  5. import java.util.Calendar;  
  6. import java.util.Date;  
  7.   
  8. import org.codehaus.jackson.JsonParser;  
  9. import org.codehaus.jackson.JsonProcessingException;  
  10. import org.codehaus.jackson.map.DeserializationContext;  
  11. import org.codehaus.jackson.map.JsonDeserializer;  
  12.   
  13. public class DateDeserializer extends JsonDeserializer<Date> {  
  14.   
  15.     @Override  
  16.     public Date deserialize(JsonParser parser, DeserializationContext context)  
  17.     throws IOException, JsonProcessingException {  
  18.         String dateFormat= "yyyy-MM-dd";  
  19.         SimpleDateFormat sdf= new SimpleDateFormat(dateFormat);  
  20.         try{  
  21.             String fieldData= parser.getText();  
  22.             return sdf.parse(fieldData);  
  23.         }catch (Exception e) {  
  24.             Calendar ca= Calendar.getInstance();  
  25.             ca.set(1970, Calendar.JANUARY, 1, 0, 0, 0);  
  26.             return ca.getTime();  
  27.         }  
  28.     }  
  29. }  

从代码咱们能够看出，DateTimeSerializer和DateTimeDeserializer比DateSerializer和DateDeserializer细粒度更加高，加入了具体时间的属性。这在应用开发中是很常见的，生日信息咱们每每知道年月日就能够了，而登录时间每每须要得比较详细。从实例中咱们能够知道，即使是同一类型，经过制定不一样的序列与反序列方法，能够灵活地获得咱们想要的数据形态。以上测试用例已经打包，上传到了个人资源。欢迎你们下载，共同窗习。下载地址：http://download.csdn.net/detail/chaijunkun/4846394

 

 

2012年12月17日补充：框架

最近有一个需求，须要在序列化与反序列化对象的时候对数据进行修改，当发现数据源值为空时须要让生成的JSON显示改字段为“游客”。但是我不管如何指定序列化器与反序列化器都无效。程序根本走不到指定的代码中去。后来我得出结论，Jackson JSON在反序列化对象的时候，若JSON数据中对应属性为null，则不会走自定义的反序列化器；一样地，当你设置对象的某个属性值为null时，在将其序列化成JSON时，也不会走自定义的序列化器。所以如有相似的需求，请在序列化与反序列化以前经过硬代码形式判断和修改，千万不要什么事都期望着序列化器与反序列化器。ide


参考资料：来源于国外网站的一篇介绍如何转码的文章，原文有点错误。我将其改正了，并加入了一些中文注释：http://wiki.fasterxml.com/JacksonSampleQuoteChars学习

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程