Java实现操作JSON的便捷工具类完整实例【重写Google的Gson】

 更新时间:2017年10月31日 10:52:25   作者:岁寒松柏  
这篇文章主要介绍了Java实现操作JSON的便捷工具类,基于重写Google的Gson实现,涉及java针对json数据的各种常见转换操作实现技巧,需要的朋友可以参考下

本文实例讲述了Java实现操作JSON的便捷工具类。分享给大家供大家参考,具体如下:

对于JSON数据格式的处理,自开发Java以来,已用过多种JSON的开源工具,用得最好,也用得最High的恐怕要属Google的Gson了。

特别为它写了一个工具类,放入常备工具中,方便使用。下面是为GSON 1.5版本重写的工具类。

依赖包:

slf4j-api-1.6.0.jar
slf4j-log4j12-1.6.0.jar
log4j-1.2.15.jar
gson-1.5.jar

/**
 * Copyright 2010 Fuchun.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *   http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package my.tools;
import java.lang.reflect.Type;
import java.util.Collection;
import java.util.Enumeration;
import java.util.Iterator;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import com.google.gson.Gson;
import com.google.gson.GsonBuilder;
import com.google.gson.reflect.TypeToken;
import org.apache.commons.lang.StringUtils;
/**
 * 包含操作 {@code JSON} 数据的常用方法的工具类。
 * <p />
 * 该工具类使用的 {@code JSON} 转换引擎是 <a href="http://code.google.com/p/google-gson/" rel="external nofollow" rel="external nofollow" mce_href="http://code.google.com/p/google-gson/" rel="external nofollow" rel="external nofollow" target="_blank">
 * {@code Google Gson}</a>。 下面是工具类的使用案例:
 *
 * <pre>
 * public class User {
 *   @SerializedName("pwd")
 *   private String password;
 *   @Expose
 *   @SerializedName("uname")
 *   private String username;
 *   @Expose
 *   @Since(1.1)
 *   private String gender;
 *   @Expose
 *   @Since(1.0)
 *   private String sex;
 *
 *   public User() {}
 *   public User(String username, String password, String gender) {
 *     // user constructor code... ... ...
 *   }
 *
 *   public String getUsername()
 *   ... ... ...
 * }
 * List<User> userList = new LinkedList<User>();
 * User jack = new User("Jack", "123456", "Male");
 * User marry = new User("Marry", "888888", "Female");
 * userList.add(jack);
 * userList.add(marry);
 * Type targetType = new TypeToken<List<User>>(){}.getType();
 * String sUserList1 = JSONUtils.toJson(userList, targetType);
 * sUserList1 ----> [{"uname":"jack","gender":"Male","sex":"Male"},{"uname":"marry","gender":"Female","sex":"Female"}]
 * String sUserList2 = JSONUtils.toJson(userList, targetType, false);
 * sUserList2 ----> [{"uname":"jack","pwd":"123456","gender":"Male","sex":"Male"},{"uname":"marry","pwd":"888888","gender":"Female","sex":"Female"}]
 * String sUserList3 = JSONUtils.toJson(userList, targetType, 1.0d, true);
 * sUserList3 ----> [{"uname":"jack","sex":"Male"},{"uname":"marry","sex":"Female"}]
 * </pre>
 *
 * @author Fuchun
 * @since ay-commons-lang 1.0
 * @version 1.1.0
 */
public class JSONUtils {
  private static final Logger LOGGER = LoggerFactory.getLogger(JSONUtils.class);
  /** 空的 {@code JSON} 数据 - <code>"{}"</code>。 */
  public static final String EMPTY_JSON = "{}";
  /** 空的 {@code JSON} 数组(集合)数据 - {@code "[]"}。 */
  public static final String EMPTY_JSON_ARRAY = "[]";
  /** 默认的 {@code JSON} 日期/时间字段的格式化模式。 */
  public static final String DEFAULT_DATE_PATTERN = "yyyy-MM-dd HH:mm:ss SSS";
  /** {@code Google Gson} 的 <code>@Since</code> 注解常用的版本号常量 - {@code 1.0}。 */
  public static final double SINCE_VERSION_10 = 1.0d;
  /** {@code Google Gson} 的 <code>@Since</code> 注解常用的版本号常量 - {@code 1.1}。 */
  public static final double SINCE_VERSION_11 = 1.1d;
  /** {@code Google Gson} 的 <code>@Since</code> 注解常用的版本号常量 - {@code 1.2}。 */
  public static final double SINCE_VERSION_12 = 1.2d;
  /** {@code Google Gson} 的 <code>@Until</code> 注解常用的版本号常量 - {@code 1.0}。 */
  public static final double UNTIL_VERSION_10 = SINCE_VERSION_10;
  /** {@code Google Gson} 的 <code>@Until</code> 注解常用的版本号常量 - {@code 1.1}。 */
  public static final double UNTIL_VERSION_11 = SINCE_VERSION_11;
  /** {@code Google Gson} 的 <code>@Until</code> 注解常用的版本号常量 - {@code 1.2}。 */
  public static final double UNTIL_VERSION_12 = SINCE_VERSION_12;
  /**
   * <p>
   * <code>JSONUtils</code> instances should NOT be constructed in standard programming. Instead,
   * the class should be used as <code>JSONUtils.fromJson("foo");</code>.
   * </p>
   * <p>
   * This constructor is public to permit tools that require a JavaBean instance to operate.
   * </p>
   */
  public JSONUtils() {
    super();
  }
  /**
   * 将给定的目标对象根据指定的条件参数转换成 {@code JSON} 格式的字符串。
   * <p />
   * <strong>该方法转换发生错误时,不会抛出任何异常。若发生错误时,曾通对象返回 <code>"{}"</code>; 集合或数组对象返回 <code>"[]"</code>
   * </strong>
   *
   * @param target 目标对象。
   * @param targetType 目标对象的类型。
   * @param isSerializeNulls 是否序列化 {@code null} 值字段。
   * @param version 字段的版本号注解。
   * @param datePattern 日期字段的格式化模式。
   * @param excludesFieldsWithoutExpose 是否排除未标注 {@literal @Expose} 注解的字段。
   * @return 目标对象的 {@code JSON} 格式的字符串。
   * @since 1.0
   */
  public static String toJson(Object target, Type targetType, boolean isSerializeNulls, Double version,
      String datePattern, boolean excludesFieldsWithoutExpose) {
    if (target == null) return EMPTY_JSON;
    GsonBuilder builder = new GsonBuilder();
    if (isSerializeNulls) builder.serializeNulls();
    if (version != null) builder.setVersion(version.doubleValue());
    if (StringUtils.isBlank(datePattern)) datePattern = DEFAULT_DATE_PATTERN;
    builder.setDateFormat(datePattern);
    if (excludesFieldsWithoutExpose) builder.excludeFieldsWithoutExposeAnnotation();
    return toJson(target, targetType, builder);
  }
  /**
   * 将给定的目标对象转换成 {@code JSON} 格式的字符串。<strong>此方法只用来转换普通的 {@code JavaBean} 对象。</strong>
   * <ul>
   * <li>该方法只会转换标有 {@literal @Expose} 注解的字段;</li>
   * <li>该方法不会转换 {@code null} 值字段;</li>
   * <li>该方法会转换所有未标注或已标注 {@literal @Since} 的字段;</li>
   * <li>该方法转换时使用默认的 日期/时间 格式化模式 - {@code yyyy-MM-dd HH:mm:ss SSS};</li>
   * </ul>
   *
   * @param target 要转换成 {@code JSON} 的目标对象。
   * @return 目标对象的 {@code JSON} 格式的字符串。
   * @since 1.0
   */
  public static String toJson(Object target) {
    return toJson(target, null, false, null, null, true);
  }
  /**
   * 将给定的目标对象转换成 {@code JSON} 格式的字符串。<strong>此方法只用来转换普通的 {@code JavaBean} 对象。</strong>
   * <ul>
   * <li>该方法只会转换标有 {@literal @Expose} 注解的字段;</li>
   * <li>该方法不会转换 {@code null} 值字段;</li>
   * <li>该方法会转换所有未标注或已标注 {@literal @Since} 的字段;</li>
   * </ul>
   *
   * @param target 要转换成 {@code JSON} 的目标对象。
   * @param datePattern 日期字段的格式化模式。
   * @return 目标对象的 {@code JSON} 格式的字符串。
   * @since 1.0
   */
  public static String toJson(Object target, String datePattern) {
    return toJson(target, null, false, null, datePattern, true);
  }
  /**
   * 将给定的目标对象转换成 {@code JSON} 格式的字符串。<strong>此方法只用来转换普通的 {@code JavaBean} 对象。</strong>
   * <ul>
   * <li>该方法只会转换标有 {@literal @Expose} 注解的字段;</li>
   * <li>该方法不会转换 {@code null} 值字段;</li>
   * <li>该方法转换时使用默认的 日期/时间 格式化模式 - {@code yyyy-MM-dd HH:mm:ss SSS};</li>
   * </ul>
   *
   * @param target 要转换成 {@code JSON} 的目标对象。
   * @param version 字段的版本号注解({@literal @Since})。
   * @return 目标对象的 {@code JSON} 格式的字符串。
   * @since 1.0
   */
  public static String toJson(Object target, Double version) {
    return toJson(target, null, false, version, null, true);
  }
  /**
   * 将给定的目标对象转换成 {@code JSON} 格式的字符串。<strong>此方法只用来转换普通的 {@code JavaBean} 对象。</strong>
   * <ul>
   * <li>该方法不会转换 {@code null} 值字段;</li>
   * <li>该方法会转换所有未标注或已标注 {@literal @Since} 的字段;</li>
   * <li>该方法转换时使用默认的 日期/时间 格式化模式 - {@code yyyy-MM-dd HH:mm:ss SSS};</li>
   * </ul>
   *
   * @param target 要转换成 {@code JSON} 的目标对象。
   * @param excludesFieldsWithoutExpose 是否排除未标注 {@literal @Expose} 注解的字段。
   * @return 目标对象的 {@code JSON} 格式的字符串。
   * @since 1.0
   */
  public static String toJson(Object target, boolean excludesFieldsWithoutExpose) {
    return toJson(target, null, false, null, null, excludesFieldsWithoutExpose);
  }
  /**
   * 将给定的目标对象转换成 {@code JSON} 格式的字符串。<strong>此方法只用来转换普通的 {@code JavaBean} 对象。</strong>
   * <ul>
   * <li>该方法不会转换 {@code null} 值字段;</li>
   * <li>该方法转换时使用默认的 日期/时间 格式化模式 - {@code yyyy-MM-dd HH:mm:ss SSS};</li>
   * </ul>
   *
   * @param target 要转换成 {@code JSON} 的目标对象。
   * @param version 字段的版本号注解({@literal @Since})。
   * @param excludesFieldsWithoutExpose 是否排除未标注 {@literal @Expose} 注解的字段。
   * @return 目标对象的 {@code JSON} 格式的字符串。
   * @since 1.0
   */
  public static String toJson(Object target, Double version, boolean excludesFieldsWithoutExpose) {
    return toJson(target, null, false, version, null, excludesFieldsWithoutExpose);
  }
  /**
   * 将给定的目标对象转换成 {@code JSON} 格式的字符串。<strong>此方法通常用来转换使用泛型的对象。</strong>
   * <ul>
   * <li>该方法只会转换标有 {@literal @Expose} 注解的字段;</li>
   * <li>该方法不会转换 {@code null} 值字段;</li>
   * <li>该方法会转换所有未标注或已标注 {@literal @Since} 的字段;</li>
   * <li>该方法转换时使用默认的 日期/时间 格式化模式 - {@code yyyy-MM-dd HH:mm:ss SSSS};</li>
   * </ul>
   *
   * @param target 要转换成 {@code JSON} 的目标对象。
   * @param targetType 目标对象的类型。
   * @return 目标对象的 {@code JSON} 格式的字符串。
   * @since 1.0
   */
  public static String toJson(Object target, Type targetType) {
    return toJson(target, targetType, false, null, null, true);
  }
  /**
   * 将给定的目标对象转换成 {@code JSON} 格式的字符串。<strong>此方法通常用来转换使用泛型的对象。</strong>
   * <ul>
   * <li>该方法只会转换标有 {@literal @Expose} 注解的字段;</li>
   * <li>该方法不会转换 {@code null} 值字段;</li>
   * <li>该方法转换时使用默认的 日期/时间 格式化模式 - {@code yyyy-MM-dd HH:mm:ss SSSS};</li>
   * </ul>
   *
   * @param target 要转换成 {@code JSON} 的目标对象。
   * @param targetType 目标对象的类型。
   * @param version 字段的版本号注解({@literal @Since})。
   * @return 目标对象的 {@code JSON} 格式的字符串。
   * @since 1.0
   */
  public static String toJson(Object target, Type targetType, Double version) {
    return toJson(target, targetType, false, version, null, true);
  }
  /**
   * 将给定的目标对象转换成 {@code JSON} 格式的字符串。<strong>此方法通常用来转换使用泛型的对象。</strong>
   * <ul>
   * <li>该方法不会转换 {@code null} 值字段;</li>
   * <li>该方法会转换所有未标注或已标注 {@literal @Since} 的字段;</li>
   * <li>该方法转换时使用默认的 日期/时间 格式化模式 - {@code yyyy-MM-dd HH:mm:ss SSS};</li>
   * </ul>
   *
   * @param target 要转换成 {@code JSON} 的目标对象。
   * @param targetType 目标对象的类型。
   * @param excludesFieldsWithoutExpose 是否排除未标注 {@literal @Expose} 注解的字段。
   * @return 目标对象的 {@code JSON} 格式的字符串。
   * @since 1.0
   */
  public static String toJson(Object target, Type targetType, boolean excludesFieldsWithoutExpose) {
    return toJson(target, targetType, false, null, null, excludesFieldsWithoutExpose);
  }
  /**
   * 将给定的目标对象转换成 {@code JSON} 格式的字符串。<strong>此方法通常用来转换使用泛型的对象。</strong>
   * <ul>
   * <li>该方法不会转换 {@code null} 值字段;</li>
   * <li>该方法转换时使用默认的 日期/时间 格式化模式 - {@code yyyy-MM-dd HH:mm:ss SSS};</li>
   * </ul>
   *
   * @param target 要转换成 {@code JSON} 的目标对象。
   * @param targetType 目标对象的类型。
   * @param version 字段的版本号注解({@literal @Since})。
   * @param excludesFieldsWithoutExpose 是否排除未标注 {@literal @Expose} 注解的字段。
   * @return 目标对象的 {@code JSON} 格式的字符串。
   * @since 1.0
   */
  public static String toJson(Object target, Type targetType, Double version, boolean excludesFieldsWithoutExpose) {
    return toJson(target, targetType, false, version, null, excludesFieldsWithoutExpose);
  }
  /**
   * 将给定的 {@code JSON} 字符串转换成指定的类型对象。
   *
   * @param <T> 要转换的目标类型。
   * @param json 给定的 {@code JSON} 字符串。
   * @param token {@code com.google.gson.reflect.TypeToken} 的类型指示类对象。
   * @param datePattern 日期格式模式。
   * @return 给定的 {@code JSON} 字符串表示的指定的类型对象。
   * @since 1.0
   */
  public static <T> T fromJson(String json, TypeToken<T> token, String datePattern) {
    if (StringUtils.isBlank(json)) {
      return null;
    }
    GsonBuilder builder = new GsonBuilder();
    if (StringUtils.isBlank(datePattern)) {
      datePattern = DEFAULT_DATE_PATTERN;
    }
    Gson gson = builder.create();
    try {
      return gson.fromJson(json, token.getType());
    } catch (Exception ex) {
      LOGGER.error(json + " 无法转换为 " + token.getRawType().getName() + " 对象!", ex);
      return null;
    }
  }
  /**
   * 将给定的 {@code JSON} 字符串转换成指定的类型对象。
   *
   * @param <T> 要转换的目标类型。
   * @param json 给定的 {@code JSON} 字符串。
   * @param token {@code com.google.gson.reflect.TypeToken} 的类型指示类对象。
   * @return 给定的 {@code JSON} 字符串表示的指定的类型对象。
   * @since 1.0
   */
  public static <T> T fromJson(String json, TypeToken<T> token) {
    return fromJson(json, token, null);
  }
  /**
   * 将给定的 {@code JSON} 字符串转换成指定的类型对象。<strong>此方法通常用来转换普通的 {@code JavaBean} 对象。</strong>
   *
   * @param <T> 要转换的目标类型。
   * @param json 给定的 {@code JSON} 字符串。
   * @param clazz 要转换的目标类。
   * @param datePattern 日期格式模式。
   * @return 给定的 {@code JSON} 字符串表示的指定的类型对象。
   * @since 1.0
   */
  public static <T> T fromJson(String json, Class<T> clazz, String datePattern) {
    if (StringUtils.isBlank(json)) {
      return null;
    }
    GsonBuilder builder = new GsonBuilder();
    if (StringUtils.isBlank(datePattern)) {
      datePattern = DEFAULT_DATE_PATTERN;
    }
    Gson gson = builder.create();
    try {
      return gson.fromJson(json, clazz);
    } catch (Exception ex) {
      LOGGER.error(json + " 无法转换为 " + clazz.getName() + " 对象!", ex);
      return null;
    }
  }
  /**
   * 将给定的 {@code JSON} 字符串转换成指定的类型对象。<strong>此方法通常用来转换普通的 {@code JavaBean} 对象。</strong>
   *
   * @param <T> 要转换的目标类型。
   * @param json 给定的 {@code JSON} 字符串。
   * @param clazz 要转换的目标类。
   * @return 给定的 {@code JSON} 字符串表示的指定的类型对象。
   * @since 1.0
   */
  public static <T> T fromJson(String json, Class<T> clazz) {
    return fromJson(json, clazz, null);
  }
  /**
   * 将给定的目标对象根据{@code GsonBuilder} 所指定的条件参数转换成 {@code JSON} 格式的字符串。
   * <p />
   * 该方法转换发生错误时,不会抛出任何异常。若发生错误时,{@code JavaBean} 对象返回 <code>"{}"</code>; 集合或数组对象返回
   * <code>"[]"</code>。 其本基本类型,返回相应的基本值。
   *
   * @param target 目标对象。
   * @param targetType 目标对象的类型。
   * @param builder 可定制的{@code Gson} 构建器。
   * @return 目标对象的 {@code JSON} 格式的字符串。
   * @since 1.1
   */
  public static String toJson(Object target, Type targetType, GsonBuilder builder) {
    if (target == null) return EMPTY_JSON;
    Gson gson = null;
    if (builder == null) {
      gson = new Gson();
    } else {
      gson = builder.create();
    }
    String result = EMPTY_JSON;
    try {
      if (targetType == null) {
        result = gson.toJson(target);
      } else {
        result = gson.toJson(target, targetType);
      }
    } catch (Exception ex) {
      LOGGER.warn("目标对象 " + target.getClass().getName() + " 转换 JSON 字符串时,发生异常!", ex);
      if (target instanceof Collection<?> || target instanceof Iterator<?> || target instanceof Enumeration<?>
          || target.getClass().isArray()) {
        result = EMPTY_JSON_ARRAY;
      }
    }
    return result;
  }
}

PS:关于json操作,这里再为大家推荐几款比较实用的json在线工具供大家参考使用:

在线JSON代码检验、检验、美化、格式化工具:
http://tools.jb51.net/code/json

JSON在线格式化工具:
http://tools.jb51.net/code/jsonformat

在线XML/JSON互相转换工具:
http://tools.jb51.net/code/xmljson

json代码在线格式化/美化/压缩/编辑/转换工具:
http://tools.jb51.net/code/jsoncodeformat

在线json压缩/转义工具:
http://tools.jb51.net/code/json_yasuo_trans

更多关于java相关内容感兴趣的读者可查看本站专题:《Java操作json格式数据技巧总结》、《Java数组操作技巧总结》、《Java字符与字符串操作技巧总结》、《Java数学运算技巧总结》、《Java数据结构与算法教程》及《Java操作DOM节点技巧总结

希望本文所述对大家java程序设计有所帮助。

相关文章

  • 实例详解Java8函数式接口

    实例详解Java8函数式接口

    本文给大家分析了Java8默认方法和函数式接口实例其它创建方式,需要的朋友跟着学习下吧。
    2017-11-11
  • MyBatis-Plus使用ActiveRecord(AR)实现CRUD

    MyBatis-Plus使用ActiveRecord(AR)实现CRUD

    本文将结合实例代码,介绍MyBatis-Plus使用ActiveRecord(AR)实现CRUD,文中通过示例代码介绍的非常详细,需要的朋友们下面随着小编来一起学习学习吧
    2021-07-07
  • Mybatis中使用万能的Map传参实现

    Mybatis中使用万能的Map传参实现

    在编程中,有可能遇到我们的实体类或者数据库中表的字段或参数过多的情况,那这时候用Map传参是比较理想的选择,本文就详细的介绍一下如何使用,感兴趣的可以了解下
    2021-07-07
  • Java多线程——基础概念

    Java多线程——基础概念

    这篇文章主要介绍了java多线程编程实例,分享了几则多线程的实例代码,具有一定参考价值,加深多线程编程的理解还是很有帮助的,需要的朋友可以参考下,希望可以帮到你
    2021-07-07
  • mybatis plus怎么忽略映射字段

    mybatis plus怎么忽略映射字段

    这篇文章主要介绍了mybatis plus怎么忽略映射字段,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2020-10-10
  • 深入了解Java核心类库--String类

    深入了解Java核心类库--String类

    这篇文章主要为大家详细介绍了java String类定义与使用的相关资料,具有一定的参考价值,感兴趣的小伙伴们可以参考一下,希望能给你带来帮助
    2021-07-07
  • Java跨平台原理与虚拟机相关简介

    Java跨平台原理与虚拟机相关简介

    这篇文章主要介绍了Java跨平台原理与虚拟机的相关资料,帮助大家更好的理解和学习使用Java,感兴趣的朋友可以了解下
    2021-03-03
  • 浅谈Spring Boot: 接口压测及简要优化策略

    浅谈Spring Boot: 接口压测及简要优化策略

    这篇文章主要介绍了浅谈Spring Boot: 接口压测及简要优化策略,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2020-09-09
  • Springboot如何设置静态资源缓存一年

    Springboot如何设置静态资源缓存一年

    这篇文章主要介绍了Springboot如何设置静态资源缓存一年,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2019-11-11
  • java 字符串反转的实例详解

    java 字符串反转的实例详解

    这篇文章主要介绍了java 字符串反转的实例详解的相关资料,这里提供实现代码帮助大家学习参考这部分内容,需要的朋友可以参考下
    2017-08-08

最新评论