Use the methods in the System.JSON class to perform round-trip JSON serialization and deserialization of Apex objects.
The following are methods for JSON. All methods are static.
public static System.JSONGenerator createGenerator(Boolean prettyPrint)
Type: System.JSONGenerator
public static System.JSONParser createParser(String jsonString)
Type: System.JSONParser
public static Object deserialize(String jsonString, System.Type apexType)
Type: Object
If the JSON content contains attributes not present in the System.Type argument, such as a missing field or object, deserialization fails in some circumstances. When deserializing JSON content into a custom object or an sObject using Salesforce API version 34.0 or earlier, this method throws a runtime exception when passed extraneous attributes. When deserializing JSON content into an Apex class in any API version, or into an object in API version 35.0 or later, no exception is thrown. When no exception is thrown, this method ignores extraneous attributes and parses the rest of the JSON content.
Decimal n = (Decimal)JSON.deserialize( '100.1', Decimal.class); System.assertEquals(n, 100.1);
public static Object deserializeStrict(String jsonString, System.Type apexType)
Type: Object
public class Car { public String make; public String year; } public void parse() { Car c = (Car)JSON.deserializeStrict( '{"make":"SFDC","year":"2020"}', Car.class); System.assertEquals(c.make, 'SFDC'); System.assertEquals(c.year, '2020'); }
public static Object deserializeUntyped(String jsonString)
Type: Object
String jsonInput = '{\n' + ' "description" :"An appliance",\n' + ' "accessories" : [ "powerCord", ' + '{ "right":"door handle1", ' + '"left":"door handle2" } ],\n' + ' "dimensions" : ' + '{ "height" : 5.5 , ' + '"width" : 3.0 , ' + '"depth" : 2.2 },\n' + ' "type" : null,\n' + ' "inventory" : 2000,\n' + ' "price" : 1023.45,\n' + ' "isShipped" : true,\n' + ' "modelNumber" : "123"\n' + '}'; Map<String, Object> m = (Map<String, Object>) JSON.deserializeUntyped(jsonInput); System.assertEquals( 'An appliance', m.get('description')); List<Object> a = (List<Object>)m.get('accessories'); System.assertEquals('powerCord', a[0]); Map<String, Object> a2 = (Map<String, Object>)a[1]; System.assertEquals( 'door handle1', a2.get('right')); System.assertEquals( 'door handle2', a2.get('left')); Map<String, Object> dim = (Map<String, Object>)m.get('dimensions'); System.assertEquals( 5.5, dim.get('height')); System.assertEquals( 3.0, dim.get('width')); System.assertEquals( 2.2, dim.get('depth')); System.assertEquals(null, m.get('type')); System.assertEquals( 2000, m.get('inventory')); System.assertEquals( 1023.45, m.get('price')); System.assertEquals( true, m.get('isShipped')); System.assertEquals( '123', m.get('modelNumber'));
public static String serialize(Object objectToSerialize)
Type: String
Datetime dt = Datetime.newInstance( Date.newInstance( 2011, 3, 22), Time.newInstance( 1, 15, 18, 0)); String str = JSON.serialize(dt); System.assertEquals( '"2011-03-22T08:15:18.000Z"', str);
public static String serializePretty(Object objectToSerialize)
Type: String