This procedure signals the Application Express engine to stop further processing and immediately exit to avoid adding additional HTML code to the HTTP buffer.
Note:
This procedure raises the exception apex_application
.e_stop_apex_engine
internally. You must raise that exception again, if you use a WHEN OTHERS exception handler.
Syntax
APEX_APPLICATION.STOP_APEX_ENGINE
Parameters
None
Example 1
This example tells the browser to redirect to http://apex.oracle.com/
and immediately stops further processing.
owa_util.redirect_url('http://apex.oracle.com'); apex_application.stop_apex_engine;
Example 2
This example also tells the browser to redirect to http://apex.oracle.com/
and immediately stops further processing. But, this time the code also contains a WHEN OTHERS exception handler which deals with the apex_application.e_stop_apex_engine
used by apex_application.stop_apex_engine
.
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 Application Express engine exception when others then ...; -- code to handle the exception end;