Force.com Apex コード開発者ガイド
jDML 操作と擬似コールアウトの実行
デフォルトでは、必ず同じトランザクション内で DML 操作の後にコールアウトを実行することは許可されません。これは DML 操作によって、コミットされていない待機中の作業が発生してコールアウトの実行が妨げられるためです。場合によっては、コールアウトを行う前に、DML を使用してテストメソッドにテストデータを挿入する必要が生じることがあります。これを行うには、コールアウトを実行するコード部分を Test.startTest と Test.stopTest ステートメントの間に配置します。Test.startTest ステートメントは、Test.setMock ステートメントの前に配置する必要があります。また、DML 操作のコールは、Test.startTest/Test.stopTest ブロックの一部にすることはできません。
擬似コールアウト後の DML 操作は許可されており、テストメソッドでの変更は必要ありません。
擬似コールアウト前の DML の実行
この例は、前の例に基づいています。この例では、Test.startTest および Test.stopTest ステートメントを使用して、テストメソッドで疑似コールアウトの前に DML 操作を実行できるようにします。テストメソッド (testEchoString) は最初にテスト取引先を挿入し、Test.startTest をコールします。次に、Test.setMock を使用して疑似コールアウトモードを設定して、コールアウトを実行するメソッドをコールし、疑似応答値を確認します。最後に、Test.stopTest をコールします。
1swfobject.registerObject("clippy.codeblock-0", "9");
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17@isTest
18private class WebSvcCalloutTest {
19 @isTest static void testEchoString() {
20 // Perform some DML to insert test data
21 Account testAcct = new Account('Test Account');
22 insert testAcct;
23
24 // Call Test.startTest before performing callout
25 // but after setting test data.
26 Test.startTest();
27
28 // Set mock callout class
29 Test.setMock(WebServiceMock.class, new WebServiceMockImpl());
30
31 // Call the method that invokes a callout
32 String output = WebSvcCallout.callEchoString('Hello World!');
33
34 // Verify that a fake result is returned
35 System.assertEquals('Mock response', output);
36
37 Test.stopTest();
38 }
39}非同期 Apex と擬似コールアウト
DML と同様に、非同期 Apex 操作では、コミットされていない待機中の作業によって、同じトランザクションの後の方でコールアウトの実行が妨げられる結果になります。非同期 Apex 操作の例としては、future メソッド、Apex 一括処理、スケジュール済み Apex のコールがあります。通常、これらの非同期コールは、Test.stopTest の後で実行されるようにするため、テストメソッドで Test.startTest と Test.stopTest ステートメント間に配置します。この場合、擬似コールアウトは非同期コールの後で実行できるため、変更は不要です。ただし、非同期コールが Test.startTest と Test.stopTest ステートメント間に配置されていない場合は、コミットされていない待機中の作業のため例外が発生します。この例外を回避するには、次のいずれかを行います。
- 非同期コールを Test.startTest と Test.stopTest ステートメント間に配置する。
1Test.startTest(); 2MyClass.asyncCall(); 3Test.stopTest(); 4 5Test.setMock(..); // Takes two arguments 6MyClass.mockCallout(); - DML コールと同じルールに従う。つまり、コールアウトを実行するコード部分を Test.startTest と Test.stopTest ステートメント間に配置します。Test.startTest ステートメントは、Test.setMock ステートメントの前に配置する必要があります。また、非同期コールは、Test.startTest/Test.stopTest ブロックの一部にすることはできません。
1MyClass.asyncCall(); 2 3Test.startTest(); 4Test.setMock(..); // Takes two arguments 5MyClass.mockCallout(); 6Test.stopTest();
擬似コールアウト後の非同期コールは許可されており、テストメソッドでの変更は必要ありません。