3.6 STOP_APEX_ENGINE Procedure
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;
Parent topic: APEX_APPLICATION