この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。
英語に切り替える

逐次化と並列化の往復処理

JSON クラスのメソッドを使用して、JSON コンテンツの逐次化と並列化の往復処理を実行できます。

JSON クラスには、オブジェクトを JSON 形式の文字列に逐次化できるメソッドが含まれます。また、JSON 文字列をオブジェクトに並列化し直すメソッドも含まれます。

サンプル: 請求書リストの逐次化と並列化

次のサンプルは、InvoiceStatement オブジェクトのリストを作成して、リストを逐次化します。次に、逐次化された JSON 文字列を使用してリストを並列化し、元のリストに表示された請求書と同じ請求書が新しいリストに含まれることをサンプルで検証します。
1swfobject.registerObject("clippy.codeblock-0", "9");public class JSONRoundTripSample {
2  
3    public class InvoiceStatement {
4        Long invoiceNumber;
5        Datetime statementDate;
6        Decimal totalPrice;
7        
8        public InvoiceStatement(Long i, Datetime dt, Decimal price)
9        {
10            invoiceNumber = i;
11            statementDate = dt;
12            totalPrice = price;
13        }
14    }
15    
16    public static void SerializeRoundtrip() {
17        Datetime dt = Datetime.now(); 
18        // Create a few invoices.
19        InvoiceStatement inv1 = new InvoiceStatement(1,Datetime.valueOf(dt),1000);
20        InvoiceStatement inv2 = new InvoiceStatement(2,Datetime.valueOf(dt),500);
21        // Add the invoices to a list.
22        List<InvoiceStatement> invoices = new List<InvoiceStatement>();
23        invoices.add(inv1);
24        invoices.add(inv2);
25              
26        // Serialize the list of InvoiceStatement objects.
27        String JSONString = JSON.serialize(invoices);
28        System.debug('Serialized list of invoices into JSON format: ' + JSONString);
29        
30        // Deserialize the list of invoices from the JSON string.
31        List<InvoiceStatement> deserializedInvoices = 
32          (List<InvoiceStatement>)JSON.deserialize(JSONString, List<InvoiceStatement>.class);
33        System.assertEquals(invoices.size(), deserializedInvoices.size());
34        Integer i=0;
35        for (InvoiceStatement deserializedInvoice :deserializedInvoices) {
36            system.debug('Deserialized:' + deserializedInvoice.invoiceNumber + ',' 
37            + deserializedInvoice.statementDate.formatGmt('MM/dd/yyyy  HH:mm:ss.SSS')
38            + ', ' + deserializedInvoice.totalPrice); 
39            system.debug('Original:' + invoices[i].invoiceNumber + ',' 
40            + invoices[i].statementDate.formatGmt('MM/dd/yyyy  HH:mm:ss.SSS') 
41            + ', ' + invoices[i].totalPrice); 
42            i++;
43        }
44    }
45}

JSON 逐次化の考慮事項

次に、serialize メソッドの動作の相違を説明します。これらの相違は、保存された Apex コードの Salesforce.com API バージョンによって異なります���

追加項目セットのあるクエリ対象の sObject の逐次化
Salesforce.com API バージョン 27.0 以前を使用して保存された Apex の場合、クエリ対象の sObject に追加項目セットがある場合、これらの項目は serialize メソッドによって返される逐次化された JSON 文字列に含まれません。Salesforce.com API バージョン 28.0 以降を使用して保存された Apex で開始する場合は、逐次化される JSON 文字列に追加項目が含まれます。
次の例では、クエリされた後に項目が取引先責任者に追加され、その後取引先責任者が逐次化されます。アサーションステートメントは、JSON 文字列に追加項目が含まれていることを検証します。このアサーションは、Salesforce.com API バージョン 28.0 以降を使用して保存された Apex に対して有効です。
1Contact con = [SELECT Id, LastName, AccountId FROM Contact LIMIT 1]
2// Set additional field
3con.FirstName = 'Joe'
4String jsonstring = Json.serialize(con)
5System.debug(jsonstring)
6System.assert(jsonstring.contains('Joe') == true);
集計クエリの結果項目の逐次化
Salesforce.com API バージョン 27.0 を使用して保存された Apex の場合、serialize メソッドを使用して逐次化すると、集計クエリの結果に SELECT ステートメントの項目は含まれません。API の以前のバージョン、または API バージョン 28.0 以降の場合、逐次化された集計クエリの結果に SELECT ステートメントのすべての項目が含まれます。
次に、2 つの項目 (ID 項目の数と取引先名) を返す集計クエリの例を示します。
1String jsonString = JSON.serialize(
2    Database.query('SELECT Count(Id),Account.Name FROM Contact WHERE Account.Name != null GROUP BY Account.Name LIMIT 1'));
3    System.debug(jsonString);
4
5// Expected output in API v 26 and earlier or v28 and later
6// [{"attributes":{"type":"AggregateResult"},"expr0":2,"Name":"acct1"}]