在Java世界中,JSON已成为事实上的XML数据交换格式标准,因为它的易用性和传输效率高。
如果您不了解JSON,那就是Javascript对象表示法,这是一种基于文本的数据交换格式,是名称-值的集合,其中名称严格是字符串类型,值可以是int,布尔值,数组或其他json对象。
GSON是Google开发的开源Java库。 它是用于将Java对象与json表示形式转换的API。
为什么要使用它?
- 将任何Java对象(即新对象或任何现有/旧版对象)转换为JSON,反之亦然。
- 对通用对象的最佳支持
- 简单方便的转换方法
- 无需任何注释的字段进行转换
- 默认情况下,所有字段(包括私有字段)都包含在转化中
- 如果不想在转换中包含该字段,请对该字段使用瞬变修饰符
- 它通过不将其包含在序列化输出中,而在反序列化期间将其初始化回null,从而优雅地处理null字段。
如何将其添加到项目中?
使用以下方法之一将其添加为依赖项
使用Maven
将以下依赖项添加到项目的pom.xml中
<dependency><groupId>com.google.code.gson</groupId><artifactId>gson</artifactId><version>2.2.4</version>
</dependency>
使用Gradle
在项目的build.gradle中添加以下内容
repositories {mavenCentral()
}dependencies {compile 'com.google.code.gson:gson:2.2.4'
}
用作非托管依赖项
如果不使用任何构建工具,则可以将gson jar添加到直接classpath或构建路径中。
从GSON项目的下载页面下载最新的jar。 下载的zip文件包含3个jar文件-二进制文件,源代码和javadoc。 抓取二进制jar文件并将其添加到您的项目类路径中。
如何使用它 ?
为了将对象与json相互转换,您需要使用Gson类及其以下2种方法。
toJson() =>将提供的对象转换为json字符串,将要转换的对象作为参数并返回json表示字符串
fromJSon() =>将json字符串转换为object,将第一个参数作为json字符串作为object和目标对象的类文字,并返回目标对象
您可以多次使用Gson实例/对象,因为它不会保持任何状态。
以下是一些说明GSON API用法的示例。
示例1:对于简单对象
考虑以下模型对象以进行转换,但是请记住,您可以转换任何对象
模型对象
package in.ajduke.ap012;
/**
* An model for gson demo
*
* @author ajduke
*/
public class ModelObject {String name;int val;boolean status;double f;public ModelObject(String name, int val, boolean status, double f) {super();this.name = name;this.val = val;this.status = status;this.f = f;}@Overridepublic String toString() {return "ModelObject [name=" + name + ",val=" + val + ", status="+ status + ", f=" + f + "]";}}
以下是将转换对象转换为json表示形式的清单,
Example1.java
final Gson gson = new Gson();
// original object instantiation
ModelObject modelObject = new ModelObject("myname", 12, true, 2.3);
System.out.println("toJson ---");
System.out.println("Original Java object : " + modelObject);
// converting an object to json object
String json = gson.toJson(modelObject);
System.out.println("Converted JSON string is : " + json);System.out.println("fromJson----");
// getting object from json representation
System.out.println("Original JSON string is : " + json);
// converting json to object
ModelObject modelObject1 = gson.fromJson(json, ModelObject.class);
System.out.println("Converted Java object : " + modelObject1);
请注意fromJson()的签名,它使用第二个参数作为目标对象的类文字。
输出如下,
示例1-输出
toJson ---
Original Java object : ModelObject [name=myname, val=12, status=true, f=2.3]
Converted JSON string is : {"name":"myname","val":12,"status":true,"f":2.3}
fromJson----
Original JSON string is : {"name":"myname","val":12,"status":true,"f":2.3}
Converted Java object : ModelObject [name=myname, val=12, status=true, f=2.3]
示例2:对于通用对象
为了将通用对象从json表示形式转换回java对象,我们需要使用use extra对象,如下所示
类型collectionType = new TypeToken <{带类型信息的通用对象}>(){}。getType();
您需要向TypeToken类型参数信息提供目标类类型,如上所示。 这是形成Type实例,我们需要将它作为第二个参数传递给fromJson()方法。
以下清单显示了将通用类或类从集合框架转换为json或从json转换的示例
GenericModel.java
package in.ajduke.ap012;
/**
* An generified model for demo of gson conversion
* @author ajduke
*/
public class GenericModel<T> {T value;public GenericModel(T value) {super();this.value = value;}@Overridepublic String toString() {return "Model2 [value=" + value + "]";}
}
Example2.java
Gson gson = new Gson();System.out.println("A generic object demo");
// a generified object
GenericModel<Integer> model = new GenericModel<>(12);// converting to json representation
String json = gson.toJson(model);
System.out.println("json representation :" + json);// converting back to object
Type collectionType = new TypeToken<GenericModel<Integer>>() {
}.getType();
GenericModel<Integer> modelObj = gson.fromJson(json, collectionType);
System.out.println("converted object representation: " + modelObj);System.out.println("\nA object from collection framework\n");
// for collection framework objects
List<String> listOfString = new ArrayList<>();
listOfString.add("ajduke");
listOfString.add("ajduchess");// conversion to json
String jsonStr = gson.toJson(listOfString);
System.out.println("json representation :" + jsonStr);Type collectionType2 = new TypeToken<List<String>>() {
}.getType();
List<String> listObj = gson.fromJson(jsonStr, collectionType2);
System.out.println("converted object representation: " + listObj);
输出如下
例2-输出
A generic object demo
json representation :{"value":12}
converted object representation: Model2 [value=12]A object from collection frameworkjson representation :["ajduke","ajduchess"]
converted object representation: [ajduke, ajduchess]
示例3:使用瞬态
如果您不想在json表示形式中包含某些字段,则可以对变量声明使用transient修饰符,然后在将其转换为json表示形式时,GSON会忽略该变量。 但是,当从json字符串转换回对象时,它会根据变量类型初始化其默认值 。
考虑我们的ModelObject,让我们从json表示中跳过整数val,因此,将其声明修改为transient,如下面的清单所示
ModelObject2.java
package in.ajduke.ap012;
/**
* An model for demo of gson conversion
*
* @author ajduke
*/
public class ModelObject {String name;transient int val;boolean status;double f;public ModelObject(String name, int val, boolean status, double f) {super();this.name = name;this.val = val;this.status = status;this.f = f;}@Overridepublic String toString() {return "ModelObject [name=" + name + ",val=" + val + ", status="+ status + ", f=" + f + "]";}
}
以下是清单
Example3.java
Gson gson = new Gson();
// original object
ModelObject modelObject = new ModelObject("namesake", 50, true, 4.3);
System.out.print("Original Java object : ");
System.out.println(modelObject);// converting to an json representation
String json = gson.toJson(modelObject);
System.out.print("Converted JSON string is : ");
System.out.println(json);// getting back the object from json representation
ModelObject modelObject3 = gson.fromJson(json, ModelObject.class);
System.out.print("Converted Java object : ");
System.out.println(modelObject3);
因此,在进行转换时,GSON忽略了上述内容并输出如下
example3-输出
Original Java object : ModelObject [name=namesake, val=50, status=true, f=4.3]
Converted JSON string is : {"name":"namesake","status":true,"f":4.3}
Converted Java object : ModelObject [name=namesake, val=0, status=true, f=4.3]
Thats all folks, for GSON introduction !!
注意:我已经为所有示例提供了小段代码,要访问完整列表,请访问github上的要点
下一步是什么 ?
在接下来的几篇文章中,我将向您展示GSON库的一些额外好处,
所以,请继续关注!!!
翻译自: https://www.javacodegeeks.com/2013/08/getting-started-with-google-gson.html