Apex 開発者ガイド
j静的リソースを使用した HTTP コールアウトのテスト
受信するレスポンスボディを静的リソース内に指定し、2 つの組み込みクラス (StaticResourceCalloutMock または MultiStaticResourceCalloutMock) のいずれかを使用することで、HTTP コールアウトをテストできます。
StaticResourceCalloutMock を使用した HTTP コールアウトのテスト
Apex には、静的リソースでレスポンスボディを指定することでコールアウトのテストに使用できる、組み込み StaticResourceCalloutMock クラスが用意されています。このクラスを使用する場合、HttpCalloutMock インターフェースを独自に実装する必要ありません。代わりに、単に StaticResourceCalloutMock のインスタンスを作成し、レスポンスボディに使用する静的リソースを応答の他のプロパティ (状況コードやコンテンツタイプなど) と共に設定します。
- 返すレスポンスボディを含むテキストファイルを作成します。レスポンスボディには任意の文字列を使用できますが、コンテンツタイプを指定した場合はそのタイプと一致する必要があります。たとえば、応答にコンテンツタイプを指定しない場合、ファイルには任意の文字列 abc を含めることができます。応答に application/json のコンテンツタイプを指定した場合、ファイルの内容は {"hah":"fooled you"} などの JSON 文字列にする必要があります。
- このテキストファイル用の静的リソースを作成します。
- [設定] から、[クイック検索] ボックスに「静的リソース」と入力し、[静的リソース] を選択します。
- [新規] をクリックします。
- 静的リソースに名前を付けます。
- アップロードするファイルを選択します。
- [保存] をクリックします。
静的リソースについての詳細は、Salesforce オンラインヘルプの「静的リソースの定義」を参照してください。
次に、StaticResourceCalloutMock のインスタンスを作成し、静的リソースとその他のプロパティを設定します。
1StaticResourceCalloutMock mock = new StaticResourceCalloutMock();
2mock.setStaticResource('myStaticResourceName');
3mock.setStatusCode(200);
4mock.setHeader('Content-Type', 'application/json');テストメソッドで、Test.setMock をコールして擬似コールアウトモードを設定し、最初の引数として HttpCalloutMock.class、2 番目の引数として StaticResourceCalloutMock 用に作成した変数名を渡します。
1Test.setMock(HttpCalloutMock.class, mock);これ以降テストメソッドでコールアウトを実行しようとすると、コールアウトは実行されず、Apex ランタイムが StaticResourceCalloutMock のインスタンスで指定した擬似応答を送信します。
次の詳細な例には、テストメソッド (testCalloutWithStaticResources) が含まれ、このメソッドで、コールアウトを実行する getInfoFromExternalService をテストします。この例を実行する前に、コンテンツ {"hah":"fooled you"} を含むテキストファイルに基づいた mockResponse という名前の静的リソースを作成します。各クラスを個別に保存して、CalloutStaticClassTest でテストを実行します。
1public class CalloutStaticClass {
2 public static HttpResponse getInfoFromExternalService(String endpoint) {
3 HttpRequest req = new HttpRequest();
4 req.setEndpoint(endpoint);
5 req.setMethod('GET');
6 Http h = new Http();
7 HttpResponse res = h.send(req);
8 return res;
9 }
10}1@isTest
2private class CalloutStaticClassTest {
3 @isTest static void testCalloutWithStaticResources() {
4 // Use StaticResourceCalloutMock built-in class to
5 // specify fake response and include response body
6 // in a static resource.
7 StaticResourceCalloutMock mock = new StaticResourceCalloutMock();
8 mock.setStaticResource('mockResponse');
9 mock.setStatusCode(200);
10 mock.setHeader('Content-Type', 'application/json');
11
12 // Set the mock callout mode
13 Test.setMock(HttpCalloutMock.class, mock);
14
15 // Call the method that performs the callout
16 HTTPResponse res = CalloutStaticClass.getInfoFromExternalService(
17 'http://example.com/example/test');
18
19 // Verify response received contains values returned by
20 // the mock response.
21 // This is the content of the static resource.
22 System.assertEquals('{"hah":"fooled you"}', res.getBody());
23 System.assertEquals(200,res.getStatusCode());
24 System.assertEquals('application/json', res.getHeader('Content-Type'));
25 }
26}MultiStaticResourceCalloutMock を使用した HTTP コールアウトのテスト
Apex には、各エンドポイントの静的リソースでレスポンスボディを指定することでコールアウトのテストに使用できる、組み込み MultiStaticResourceCalloutMock クラスが用意されています。このクラスは、複数のレスポンスボディを指定できること以外は StaticResourceCalloutMock と似ています。このクラスを使用する場合、HttpCalloutMock インターフェースを独自に実装する必要ありません。代わりに、単に MultiStaticResourceCalloutMock のインスタンスを作成し、エンドポイントごとに使用する静的リソースを設定します。状況コードやコンテンツタイプなどの応答の他のプロパティも設定できます。
最初に、レスポンスボディを含めるテキストファイルから静的リソースを作成する必要があります。「StaticResourceCalloutMock を使用した HTTP コールアウトのテスト」に示された手順を参照してください。
次に、MultiStaticResourceCalloutMock のインスタンスを作成し、静的リソースとその他のプロパティを設定します。
1MultiStaticResourceCalloutMock multimock = new MultiStaticResourceCalloutMock();
2multimock.setStaticResource('http://example.com/example/test', 'mockResponse');
3multimock.setStaticResource('http://example.com/example/sfdc', 'mockResponse2');
4multimock.setStatusCode(200);
5multimock.setHeader('Content-Type', 'application/json');テストメソッドで、Test.setMock をコールして擬似コールアウトモードを設定し、最初の引数として HttpCalloutMock.class、2 番目の引数として MultiStaticResourceCalloutMock 用に作成した変数名を渡します。
1Test.setMock(HttpCalloutMock.class, multimock);これ以降テストメソッドで http://example.com/example/test または http://example.com/example/sfdc のいずれかのエンドポイントへの HTTP コールアウトを実行しようとすると、コールアウトは実行されず、Apex ランタイムが MultiStaticResourceCalloutMock のインスタンスで指定した対応する擬似応答を送信します。
次の詳細な例には、テストメソッド (testCalloutWithMultipleStaticResources) が含まれ、このメソッドで、コールアウトを実行する getInfoFromExternalService をテストします。この例を実行する前に、コンテンツ {"hah":"fooled you"} を含むテキストファイルに基づいた mockResponse という名前の静的リソースと、コンテンツ {"hah":"fooled you twice"} を含むテキストファイルに基づいた mockResponse2 という名前の静的リソースを作成します。各クラスを個別に保存して、CalloutMultiStaticClassTest でテストを実行します。
1public class CalloutMultiStaticClass {
2 public static HttpResponse getInfoFromExternalService(String endpoint) {
3 HttpRequest req = new HttpRequest();
4 req.setEndpoint(endpoint);
5 req.setMethod('GET');
6 Http h = new Http();
7 HttpResponse res = h.send(req);
8 return res;
9 }
10}1@isTest
2private class CalloutMultiStaticClassTest {
3 @isTest static void testCalloutWithMultipleStaticResources() {
4 // Use MultiStaticResourceCalloutMock to
5 // specify fake response for a certain endpoint and
6 // include response body in a static resource.
7 MultiStaticResourceCalloutMock multimock = new MultiStaticResourceCalloutMock();
8 multimock.setStaticResource(
9 'http://example.com/example/test', 'mockResponse');
10 multimock.setStaticResource(
11 'http://example.com/example/sfdc', 'mockResponse2');
12 multimock.setStatusCode(200);
13 multimock.setHeader('Content-Type', 'application/json');
14
15 // Set the mock callout mode
16 Test.setMock(HttpCalloutMock.class, multimock);
17
18 // Call the method for the first endpoint
19 HTTPResponse res = CalloutMultiStaticClass.getInfoFromExternalService(
20 'http://example.com/example/test');
21 // Verify response received
22 System.assertEquals('{"hah":"fooled you"}', res.getBody());
23
24 // Call the method for the second endpoint
25 HTTPResponse res2 = CalloutMultiStaticClass.getInfoFromExternalService(
26 'http://example.com/example/sfdc');
27 // Verify response received
28 System.assertEquals('{"hah":"fooled you twice"}', res2.getBody());
29 }
30}