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;

パラメータ

表47-5 MAKE_REQUESTのパラメータ

パラメータ	説明
`p_url`	WebサービスのURLエンドポイント。
`p_action`	起動する操作に対応するSOAPアクション。
`p_version`	SOAPのバージョン(1.1または1.2)。デフォルトは、1.1です。
`p_envelope`	サービスにポストするSOAPエンベロープ。
`p_username`	このサービスに基本認証が必要な場合はユーザー名。
`p_password`	このサービスに基本認証が必要な場合はパスワード。
`p_scheme`	認証スキーム。ご使用のデータベース・リリースでサポートされている場合、Basic (デフォルト)、AWS、Digestまたは`OAUTH_CLIENT_CRED`のいずれか。
`p_proxy_override`	リクエストに使用するプロキシ。指定したプロキシは、アプリケーション属性で定義したプロキシより優先されます。
`p_transfer_timeout`	レスポンスを待機する時間(秒単位)。
`p_wallet_path`	URLエンドポイントがHTTPSの場合はウォレットへのファイル・システム・パス。`file:/usr/home/oracle/WALLETS`など指定されたウォレットのパスは、インスタンス設定で定義したウォレットより優先されます。
`p_wallet_pwd`	ウォレットにアクセスするためのパスワード。
`p_https_host`	HTTPS要求に対してリモート・サーバーの証明書の共通名(CN)と照合するホスト名。
`p_credential_static_id`	使用するWeb資格証明の名前(共有コンポーネントに構成)。
`p_token_url`	トークンベースの認証フロー用のトークンを取得するURL (OAuth2など)。

例

次の例では、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