6.4 STOP_APEX_ENGINEプロシージャ

このプロシージャは、HTMLコードがHTTPバッファにさらに追加されるのを避けるため、それ以降の処理を停止してすぐに終了するようOracle APEXエンジンに指示します。

ノート:

このプロシージャでは、例外APEX_APPLICATION.E_STOP_APEX_ENGINEが内部的に発生します。WHEN OTHERS例外ハンドラを使用する場合は、再度この例外を発生させる必要があります。

構文

APEX_APPLICATION.STOP_APEX_ENGINE

パラメータ

なし

例1

この例では、ブラウザがhttp://apex.oracle.com/にリダイレクトして、それ以降の処理をすぐに停止します。

owa_util.redirect_url('http://apex.oracle.com');
apex_application.stop_apex_engine;

例2

この例では、ブラウザがhttp://apex.oracle.com/にリダイレクトして、それ以降の処理をすぐに停止します。コードには、APEX_APPLICATION.STOP_APEX_ENGINEによって使用されるAPEX_APPLICATION.E_STOP_APEX_ENGINEを処理するWHEN OTHERS例外ハンドラも含まれています。

BEGIN
    ... code which can raise an exception ...
    owa_util.redirect_url('http://apex.oracle.com');
    apex_application.stop_apex_engine;
EXCEPTION
    WHEN apex_application.e_stop_apex_engine THEN
        RAISE; -- raise again the stop APEX engine exception
    WHEN others THEN
        ...; -- code to handle the exception
END;