HTTP 関数の概要

環境に関する考慮事項

基本 HTTP 関数

関数の名前は、これらの 3 つのディメンションを反映したものです。例えば、HTTPGETCLOBVERBOSE は、最初のディメンションとして GET 操作、2 番目のディメンションとして CLOB データ・タイプ、3 番目のディメンションとして VERBOSE 設定を使用します。

これらの HTTP 関数には、アクセスする HTTP サーバー、HTTP ヘッダーの設定、サーバーに送信する任意のデータを指定するパラメーターを渡します。最初の 2 つのパラメーターは、すべての HTTP 関数で同じです。

• 第 1 パラメーターは、サーバーへのアクセスに使用する URL です。
• 第 2 のパラメーターは、要求がサーバーに示す HTTP ヘッダーを指定する XML 文書です。この XML 文書は、CLOB または XML 値として指定できます。HTTP ヘッダー XML 文書の形式は、以下のとおりです。

  <httpHeader headerAttribute="headerAttributeValue">
     <header name="name" value="value" />
     <header name="Accept" value="text/plain,application/xml,*/*" />
  </httpHeader>

  XML ヘッダー文書は、後述する各種属性を持つ httpHeader 要素で構成されます。そして、httpHeader 要素には、追加の HTTP ヘッダーの設定に使用される header 要素が含まれます。これは、ヘッダーの名前とその名前に対応する値を指定することで行われます。

  httpHeader 要素では、以下の属性を設定できます。

  表 2. httpHeader 属性

  属性名	タイプ	デフォルト	説明
  connectionTimeout	整数	SystemDefault	タイムアウト (ミリ秒数)
  readTimeout	整数	SystemDefault	タイムアウト (ミリ秒数)
  followRedirects	ブール	true	true の場合、リダイレクトに従います。
  useCaches	ブール	true	true の場合、キャッシュが使用されます。
  includeErrorMsg	ブール	false	true の場合、HTTP 詳細関数により、RESPONSEMSG 列でエラー情報が返されます。

  header 要素により、各種 HTTP ヘッダーを設定できます。ヘッダー名「Content-Type」、「Content-Length」、「Content-Encoding」、「Accept-Encoding」、「Authorization」、「User-Agent」では、大/小文字は区別されません。残りのヘッダーは、指定したとおりに送信されます。

  例えば、以下のヘッダーを使用した場合を考えます。

  <httpHeader><header name="User-Agent" value="IBM i HTTP function"/></httpHeader>

  これにより、サーバーに送信される HTTP ヘッダーに "User-Agent": "IBM i HTTP function" が含まれることになります。

一般 HTTP 関数

ユーティリティー HTTP 関数

一般的なエラー

デバッグに関する考慮事項

STRSQL を使用して HTTP 関数を呼び出すと、有用な問題情報が得られません。エラー情報を確認するには、代わりに ACS Run SQL Scripts を使用して HTTP 関数を実行する必要があります。

HTTP 関数は Java で提供されているネットワーキング関数を使用するため、Java コードで検出されたネットワーキングの問題が SQL レベルで公開されず、問題を診断するために十分な詳細が得られないことがあります。HTTP 関数が SQL4302 エラーで失敗し、情報が有用でない場合は、例外に関する詳細情報を確認するために、Java ストアード・プロシージャー・トレースを使用できます。