HTTP のクラス

これらのクラスは HTTP 要求および応答の機能を表示します。

• Http クラス: HTTP 要求と応答を開始するにはこのクラスを使用します。
• HttpRequest クラス: プログラムに基づいて GET、POST、PUT、および DELETE のような HTTP 要求を作成するには、このクラスを使用します。
• HttpResponse クラス: HTTP で返された HTTP の応答を処理するには、このクラスを使用します。

次の例では、url パラメータで getCalloutResponseContents メソッドに渡される外部サーバへの HTTP GET 要求を行います。この例では、返されたレスポンスボディにもアクセスします。

1public class HttpCalloutSample {
2
3  // Pass in the endpoint to be used using the string url
4  public String getCalloutResponseContents(String url) {
5
6    // Instantiate a new http object
7    Http h = new Http();
8
9     // Instantiate a new HTTP request, specify the method (GET) as well as the endpoint
10    HttpRequest req = new HttpRequest();
11    req.setEndpoint(url);
12    req.setMethod('GET');
13
14    // Send the request, and return a response
15    HttpResponse res = h.send(req);
16    return res.getBody();
17  }
18}

前の例は、同期して実行されます。つまり、外部 Web サービスが応答を返すまで、それ以上の処理は発生しません。または、@future アノテーションを使用してコールアウトを非同期に実行することもできます。

エンドポイントまたはリダイレクトエンドポイントから外部サーバにアクセスするには、認証されたリモートサイトのリストにリモートサイトを追加しておきます。Salesforce にログインし、[設定] から、[クイック検索] ボックスに「リモートサイトの設定」と入力して [リモートサイトの設定] を選択します。

HttpRequest で作成されたリクエストボディ内、またはHttpResponse でアクセスされたレスポンスボディ内の XML または JSON コンテンツを解析するには、XML クラスまたは JSON クラスを使用します。