salesforce 零基础开发入门学习(十三)salesforce中JSON的使用

JSON作为一种目前流行的轻量级数据交换格式,salesforce也对其有良好的类对其进行封装处理。salesforce中前后台交互时,使用JSON可以将apex的Object对象进行序列化和反序列化。

主要有三个类处理JSON:1.System.JSON;2.System.JSONGenerator;3.System.JSONParser

这些方法如果调用出现错误则抛出JSONException异常。

一) System.JSON

使用JSON类和方法执行往返的序列化和反序列化JSON内容,这些方法允许你将Object对象序列化成JSON内容,也允许将JSON内容反序列化成Object对象;

主要方法如下:

1.public static String serialize(Object objectToSerialize):此方法用于将Object对象序列化成JSON内容。

2.public static String serializePretty(Object objectToSerialize:此方法用于将Object对象序列化成JSON内容,和上面方法的区别仅为此方法以精美的输出格式输出。

下面通过一个例子说明:

List<Goods__c> goods = [select Id,Name,GoodsName__c from Goods__c limit 1];
//通过Serialize方法序列化 String goodsToJson = JSON.serialize(goods);
//通过serializePretty方法序列化 String goodsToJsonPretty = JSON.serializePretty(goods); System.debug(goodsToJson); System.debug(goodsToJsonPretty);

输出结果如下:

[{"attributes":{"type":"Goods__c","url":"/services/data/v36.0/sobjects/Goods__c/a002800000VGxdqAAD"},"Id":"a002800000VGxdqAAD","Name":"a002800000VGxdq",
"GoodsName__c":"魅蓝note3"}] [ { "attributes" : { "type" : "Goods__c", "url" : "/services/data/v36.0/sobjects/Goods__c/a002800000VGxdqAAD" }, "Id" : "a002800000VGxdqAAD", "Name" : "a002800000VGxdq", "GoodsName__c" : "魅蓝note3" } ]

3.public static Object deserialize(String jsonString, System.Type apexType):此方法用于将JSON内容反序列化成Apex的Object对象

//接上面Serialize的Sample
List<Goods__c> goodsList = (List<Goods__c>)JSON.deserialize(goodsToJson,List<Goods__c>.class);
for(Goods__c goodsItem : goodsList) {
	if(goodsItem.GoodsName__c != null) {
		System.debug(goodsItem.GoodsName__c);
	}
}

4.public static Object deserializeUntyped(String jsonString):此方法用于将指定的JSON内容反序列化成基本数据类型的集合,如果不是基本数据类型,则在反序列化时报异常:System.TypeException: Invalid conversion from runtime type List<ANY> to List<XXX>。eg:

String jsonList = '[{"2":"object2","1":"object1"}]';
List<Object> listJson = (List<Object>)JSON.deserializeUntyped(jsonList);
for(Object listItem : listJson) {
   if(listItem instanceof Map<String,Object>) {
   	System.debug('通过json 的反序列化(Map)' + (Map<String,Object>)listItem);
   } else {
   	System.debug('通过json 的反序列化' + listItem);
   }
}

注:通过deserializeUntyped方法不能反序列化sObject类型,只允许反序列化基本数据类型。

5.public static System.JSONGenerator createGenerator(Boolean prettyPrint):返回JSONGenerator对象,其中形参prettyPrint代表JSONGenerator创建JSON内容是否遵循缩进格式,设置为true则遵循。

6.public static System.JSONParser createParser(String jsonString):返回JSONParser对象,其中形参jsonString代表要解析的json的内容。

二) JSONGenerator

此类包含的方法用来通过标准的JSON编码将object对象序列化成JSON内容,方法主要作用为将各种类型的值写入JSON content中(相当于实例化JSON content value)。方法如下所示:

1.public void close():当JSON Generator关闭以后,无法再写入内容。

2.public Boolean isClosed():判断JSON Generator是否关闭,如果关闭返回true,否则返回false。

3.public String getAsString():返回生成的JSON的内容;

4.public Void writeBoolean(Boolean blobValue):写入指定的布尔类型值;

5.public void writeXXX:详情请看API

JSONGenerator jsonGenerator = JSON.createGenerator(true);
jsonGenerator.writeStartArray();
jsonGenerator.writeStartObject();
jsonGenerator.writeBooleanField('isStatus',true);
jsonGenerator.writeEndObject();    	
jsonGenerator.writeEndArray();
jsonGenerator.close();
System.debug(jsonGenerator.getAsString());

运行结果:

[ {
  "isStatus" : true
} ] 

三)JSONParser

 使用System.JSONParser类用来解析一个调用了外部服务的JSON格式的返回的响应内容,例如WEB service callout的json格式相应。主要方法如下:

1.public Void clearCurrentToken():此方法用于清除当前的Token。此方法执行以后,hasCurrentToken方法返回false,getCurrentToken返回null,想要恢复此token可以调用getLastClearedToken方法;

2.public System.JSONToken getCurrentToken():获取当前的Token;

String JSONContent = '{"firstName":"John"}'; 
JSONParser parser = JSON.createParser(JSONContent); 
// Advance to the next token. 
while (parser.nextToken() != null) { 
    System.debug('Current token: ' + parser.getCurrentToken()); 
}

3.public Boolean getBooleanValue();获取Boolean的值;

4.public Boolean getXXX():详情请看API文档;

1 String JSONContent = '{"isActive":true}';
2  JSONParser parser = JSON.createParser(JSONContent); 
3 // Advance to the start object marker. 
4 parser.nextToken(); 
5 // Advance to the next value. 
6 parser.nextValue(); 
7 // Get the Boolean value. 
8 Boolean isActive = parser.getBooleanValue();

5.public System.JSONToken nextToken():返回下一个Token,如果已经到达了输入流最后,则返回null;

四)JSONToken Enum

此枚举类定义一些用于解析JSON内容的Token值。

总结:如果正常的使用JSON的序列化和反序列化,System.JSON类里的serialize以及deserialize方法就足够使用了。如果需要自定义JSON样式,则可以使用JSON.Generate类来自定义JSON内容(项目中很少会遇见此种情况,通常JSON类的两种便搞定)。

本篇只是列举一部分的方法, 详情请自行查看api。如果有内容写错的地方欢迎批评指正,如果有问题欢迎留言共同探讨,转载请注明出处。  

你可能感兴趣的:(salesforce 零基础开发入门学习(十三)salesforce中JSON的使用)