37.9 MAKE_REQUESTファンクション
このファンクションを使用して、指定されたSOAPエンベロープとともにSOAP形式のWebサービスを起動し、XMLTYPEで結果を戻します。
構文
APEX_WEB_SERVICE.MAKE_REQUEST (
p_url IN VARCHAR2,
p_action IN VARCHAR2 default null,
p_version IN VARCHAR2 default '1.1',
p_envelope IN CLOB,
p_username IN VARCHAR2 default null,
p_password IN VARCHAR2 default null,
p_scheme IN VARCHAR2 default 'Basic',
p_proxy_override IN VARCHAR2 default null,
p_transfer_timeout IN NUMBER default 180,
p_wallet_path IN VARCHAR2 default null,
p_wallet_pwd IN VARCHAR2 default null,
p_https_host IN VARCHAR2 default null,
p_credential_static_id IN VARCHAR2 default null,
p_token_url IN VARCHAR2 default null )
RETURN XMLTYPE;
パラメータ
表37-4 MAKE_REQUESTファンクションのパラメータ
パラメータ | 説明 |
---|---|
|
WebサービスのURLエンドポイント。 |
|
起動する操作に対応するSOAPアクション。 |
|
SOAPのバージョン(1.1または1.2)。デフォルトは、1.1です。 |
|
サービスにポストするSOAPエンベロープ。 |
|
このサービスに基本認証が必要な場合はユーザー名。 |
|
このサービスに基本認証が必要な場合はパスワード。 |
|
ご使用のデータベース・リリースでサポートされている場合、認証スキームのBasic (デフォルト)、AWS、Digest、または |
|
リクエストに使用するプロキシ。指定したプロキシは、アプリケーション属性で定義したプロキシより優先されます。 |
|
レスポンスを待機する時間(秒単位)。 |
|
URLエンドポイントがHTTPSの場合はウォレットへのファイル・システム・パス。file:/usr/home/oracle/WALLETSなど。指定されたウォレットのパスは、インスタンス設定で定義したウォレットより優先されます。 |
|
ウォレットにアクセスするためのパスワード。 |
|
HTTPS要求に対してリモート・サーバーの証明書の共通名(CN)と照合するホスト名。 |
|
使用するWeb資格証明の名前(共有コンポーネントに構成)。 |
|
トークンベースの認証フロー(OAuth2など): トークンの取得元のURL。 |
例
次の例では、make_request
ファンクションを使用して、ムービーのリストを戻すSOAP形式のWebサービスを起動します。結果はXMLTYPEで格納されます。
declare
l_envelope CLOB;
l_xml XMLTYPE;
BEGIN
l_envelope := ' <?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:tns="http://www.ignyte.com/whatsshowing"
xmlns:xs="http://www.w3.org/2001/XMLSchema">
<soap:Body>
<tns:GetTheatersAndMovies>
<tns:zipCode>43221</tns:zipCode>
<tns:radius>5</tns:radius>
</tns:GetTheatersAndMovies>
</soap:Body>
</soap:Envelope>';
l_xml := apex_web_service.make_request(
p_url => ' http://www.ignyte.com/webservices/ignyte.whatsshowing.webservice/moviefunctions.asmx',
p_action => ' http://www.ignyte.com/whatsshowing/GetTheatersAndMovies',
p_envelope => l_envelope
);
END
親トピック: APEX_WEB_SERVICE