Force.com Apex コード開発者ガイド
j
No Results
Search Tips:
- Please consider misspellings
- Try different search keywords
Newer Version Available
HttpRequest クラス
名前空間
使用方法
HttpRequest で作成されたリクエストボディ内の XML または JSON コンテンツを解析するには、XML クラスまたは JSON クラスを使用します。
例
次の例は、要求を含む認証ヘッダーの使用方法と応答の処理を示しています。
1swfobject.registerObject("clippy.codeblock-0", "9");public class AuthCallout {
2
3 public void basicAuthCallout(){
4 HttpRequest req = new HttpRequest();
5 req.setEndpoint('http://www.yahoo.com');
6 req.setMethod('GET');
7
8 // Specify the required user name and password to access the endpoint
9 // As well as the header and header information
10
11 String username = 'myname';
12 String password = 'mypwd';
13
14 Blob headerValue = Blob.valueOf(username + ':' + password);
15 String authorizationHeader = 'BASIC ' +
16 EncodingUtil.base64Encode(headerValue);
17 req.setHeader('Authorization', authorizationHeader);
18
19 // Create a new http object to send the request object
20 // A response object is generated as a result of the request
21
22 Http http = new Http();
23 HTTPResponse res = http.send(req);
24 System.debug(res.getBody());
25 }
26}HttpRequest メソッド
HttpRequest のメソッドは次のとおりです。すべてインスタンスメソッドです。
getBodyDocument()
署名
public Dom.Document getBodyDocument()
戻り値
型: Dom.Document
例
このメソッドを次のショートカットとして使用します。
1String xml = httpRequest.getBody();
2Dom.Document domDoc = new Dom.Document(xml);getMethod()
署名
public String getMethod()
戻り値
型: String
使用方法
次は、戻り値の例です。
- DELETE
- GET
- HEAD
- POST
- PUT
- TRACE
setBody(String)
署名
public Void setBody(String body)
パラメータ
- body
- 型: String
戻り値
型: Void
使用方法
制限: 同期 Apex の場合は 6 MB、非同期 Apex の場合は 12 MB。
HTTP 要求のサイズおよび応答のサイズは、ヒープサイズの合計にカウントされます。
setBodyAsBlob(Blob)
署名
public Void setBodyAsBlob(Blob body)
パラメータ
- body
- 型: Blob
戻り値
型: Void
使用方法
制限: 同期 Apex の場合は 6 MB、非同期 Apex の場合は 12 MB。
HTTP 要求のサイズおよび応答のサイズは、ヒープサイズの合計にカウントされます。
setBodyDocument(Dom.Document)
署名
public Void setBodyDocument(Dom.Document document)
パラメータ
- document
- 型: Dom.Document
戻り値
型: Void
使用方法
制限: 同期 Apex の場合は 6 MB、非同期 Apex の場合は 12 MB。
setClientCertificateName(String)
署名
public Void setClientCertificateName(String certDevName)
パラメータ
- certDevName
- 型: String
戻り値
型: Void
使用方法
「HTTP 要求での証明書の使用」を参照してください。
setCompressed(Boolean)
署名
public Void setCompressed(Boolean flag)
パラメータ
- flag
- 型: Boolean
戻り値
型: Void
setEndpoint(String)
署名
public Void setEndpoint(String endpoint)
パラメータ
- endpoint
- 型: String
- エンドポイントに使用できる値は、次のとおりです。
- 有効な URL
1https://my_endpoint.example.com/some_path - プレフィックス callout: があり、必要に応じてパスが追加された指定ログイン情報
1callout:My_Named_Credential/some_path
- 有効な URL
戻り値
型: Void
指定ログイン情報の使用方法
Apex コールアウトで指定ログイン情報をコールアウトエンドポイントとして指定するすべての認証が Salesforce によって管理されるため、コードでこれらを行う必要はありません。外部サイトへの Apex コールアウトに必要なリモートサイト設定もスキップできます。
エンドポイント URL と認証を Apex コードから切り離すことで、指定ログイン情報でコールアウトを簡単に管理できます。たとえば、エンドポイント URL が変更された場合も、指定ログイン情報を更新するだけです。その指定ログイン情報を参照するすべてのコールアウトは、コードを変更しなくても引き続き機能します。複数の組織が有る場合、各組織に同じ名前の指定ログイン情報を作成できます。それぞれの指定ログイン情報には、開発環境と本番環境の違いに対応したりするため、異なるエンドポイント URL を含めることができます。コードは指定ログイン情報の名前のみを参照するため、コードのプログラムで環境を確認することなく、同じ Apex クラスをパッケージ化してすべての組織にリリースできます。
例
1swfobject.registerObject("clippy.codeblock-5", "9");HttpRequest req = new HttpRequest();
2req.setEndpoint('callout:My_Named_Credential/some_path');
3req.setMethod('GET');
4Http http = new Http();
5HTTPResponse res = http.send(req);
6System.debug(res.getBody());
7
コールアウトエンドポイントを指定ログイン情報ではなく URL としてコーディングできますが、コードで認証を処理する必要があります。この例では、基本的なパスワード認証を使用していますが、OAuth 認証ははるかに複雑であるため、指定ログイン情報で処理することをお勧めします。1swfobject.registerObject("clippy.codeblock-6", "9");HttpRequest req = new HttpRequest();
2req.setEndpoint('https://my_endpoint.example.com/some_path');
3req.setMethod('GET');
4
5// Specify the required user name and password to access the endpoint
6// As well as the header and header information
7
8String username = 'myname';
9String password = 'mypwd';
10
11Blob headerValue = Blob.valueOf(username + ':' + password);
12String authorizationHeader = 'BASIC ' +
13EncodingUtil.base64Encode(headerValue);
14req.setHeader('Authorization', authorizationHeader);
15
16// Create a new http object to send the request object
17// A response object is generated as a result of the request
18
19Http http = new Http();
20HTTPResponse res = http.send(req);
21System.debug(res.getBody());
22setMethod(String)
署名
public Void setMethod(String method)
パラメータ
- method
- 型: String
- このメソッドの種別の値には、次のものがあります。
- DELETE
- GET
- HEAD
- POST
- PUT
- TRACE
戻り値
型: Void
使用方法
このメソッドは要求オプションの設定にも使用できます。
setTimeout(Integer)
署名
public Void setTimeout(Integer timeout)
パラメータ
- timeout
- 型: Integer
戻り値
型: Void
使用方法
タイムアウト値は 1 ～ 120,000 ミリ秒の間で設定します。
toString()
署名
public String toString()
戻り値
型: String