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

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

1swfobject.registerObject("clippy.codeblock-0", "9");
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17public class JSONRoundTripSample {
18  
19    public class InvoiceStatement {
20        Long invoiceNumber;
21        Datetime statementDate;
22        Decimal totalPrice;
23        
24        public InvoiceStatement(Long i, Datetime dt, Decimal price)
25        {
26            invoiceNumber = i;
27            statementDate = dt;
28            totalPrice = price;
29        }
30    }
31    
32    public static void SerializeRoundtrip() {
33        Datetime dt = Datetime.now(); 
34        // Create a few invoices.
35        InvoiceStatement inv1 = new InvoiceStatement(1,Datetime.valueOf(dt),1000);
36        InvoiceStatement inv2 = new InvoiceStatement(2,Datetime.valueOf(dt),500);
37        // Add the invoices to a list.
38        List<InvoiceStatement> invoices = new List<InvoiceStatement>();
39        invoices.add(inv1);
40        invoices.add(inv2);
41              
42        // Serialize the list of InvoiceStatement objects.
43        String JSONString = JSON.serialize(invoices);
44        System.debug('Serialized list of invoices into JSON format: ' + JSONString);
45        
46        // Deserialize the list of invoices from the JSON string.
47        List<InvoiceStatement> deserializedInvoices = 
48          (List<InvoiceStatement>)JSON.deserialize(JSONString, List<InvoiceStatement>.class);
49        System.assertEquals(invoices.size(), deserializedInvoices.size());
50        Integer i=0;
51        for (InvoiceStatement deserializedInvoice :deserializedInvoices) {
52            system.debug('Deserialized:' + deserializedInvoice.invoiceNumber + ',' 
53            + deserializedInvoice.statementDate.formatGmt('MM/dd/yyyy  HH:mm:ss.SSS')
54            + ', ' + deserializedInvoice.totalPrice); 
55            system.debug('Original:' + invoices[i].invoiceNumber + ',' 
56            + invoices[i].statementDate.formatGmt('MM/dd/yyyy  HH:mm:ss.SSS') 
57            + ', ' + invoices[i].totalPrice); 
58            i++;
59        }
60    }
61}

JSON 逐次化の考慮事項

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

追加項目セットのあるクエリ対象の sObject の逐次化

Salesforce API バージョン 27.0 以��を使用して保存された Apex の場合、クエリ対象の sObject に追加項目セットがある場合、これらの項目は serialize メソッドによって返される逐次化された JSON 文字列に含まれません。Salesforce API バージョン 28.0 以降を使用して保存された Apex で開始する場合は、逐次化される JSON 文字列に追加項目が含まれます。

次の例では、クエリされた後に項目が取引先責任者に追加され、その後取引先責任者が逐次化されます。アサーションステートメントは、JSON 文字列に追加項目が含まれていることを検証します。このアサーションは、Salesforce 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 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"}]

空の項目の逐次化

API バージョン 28.0 以降はそれまでのバージョンとは異なり、null 項目は逐次化されず、JSON 文字列には含まれません。この変更は、deserialize(jsonString, apexType) などの JSON メソッドを使用した JSON 文字列の並列化には影響しません。JSON 文字列を調べるときにこの変更の影響が顕著に現れます。次に例を示します。

1String jsonString = JSON.serialize(
2                 [SELECT Id, Name, Website FROM Account WHERE Website = null LIMIT 1]);
3System.debug(jsonString);
4
5// In v27.0 and earlier, the string includes the null field and looks like the following.
6// {"attributes":{...},"Id":"001D000000Jsm0WIAR","Name":"Acme","Website":null}
7
8// In v28.0 and later, the string doesn’t include the null field and looks like 
9//  the following.
10// {"attributes":{...},"Name":"Acme","Id":"001D000000Jsm0WIAR"}}