RAISE_APPLICATION_ERROR 用法

可能不是很多人知道 RAISE_APPLICATION_ERROR 的用途是什么，虽然从字面上已经猜到这个函数是干什么用的。平时用来测试的异常处理
我们都是通过dbms_output.put_line来输出异常信息，但是在实际的应用中，需要把异常信息返回给调用的客户端。

其实 RAISE_APPLICATION_ERROR 是将应用程序专有的错误从服务器端转达到客户端应用程序(其他机器上的SQLPLUS或者其他前台开发语言)

RAISE_APPLICATION_ERROR 的声明：PROCEDURE RAISE_APPLICATION_ERROR( error_number_in IN NUMBER, error_msg_in IN VARCHAR2);

里面的错误代码和内容，都是自定义的。说明是自定义，当然就不是系统中已经命名存在的错误类别，是属于一种自定义事务错误类型，才调用此函数。

error_number_in 之容许从 -20000 到 -20999 之间，这样就不会与 ORACLE 的任何错误代码发生冲突。error_msg_in 的长度不能超过 2k，否则截取 2k。
举个例吧：
阻止小于18岁的用户增加到数据库 employee 表中

CREATE OR REPALCE TRIGGER minimun_age_check
BEFORE INSERT ON employee
FOR EACH ROW
BEGIN
        IF ADD_MONTHS( :new.birth_date, 18*12) > SYSDATE
        THEN
               RAISE_APPLICATION_ERROR(-20001, 'Employees must at least eighteen years of age.');
        END IF;
END;

下面我们编写一个客户端程序，为了简单，同样用PL/SQL调用

DECLARE

      no_babies_allowed EXCEPTION;

       /*将名称与用于触发器中的错误号码关联起来*/
       PRAGMA EXCEPTION_INIT(no_babies_allowed, -20001);

BEGIN

         INSERT INTO employee .;

EXCEPTION
         WHEN no_babies_allowed
         THEN
                /*
                || SQLERRM 将传递给内置过程 RAISE_APPLICATION_ERROR 的消息返回
                */
                DBMS_OUTPUT.PUT_LINE(SQLERRM);
END;

平时用来测试的异常处理
我们都是通过dbms_output.put_line来输出异常信息，但是在实际的应用中，需要把异常信息返回给调用的客户端。
其实 RAISE_APPLICATION_ERROR 是将应用程序专有的错误从服务器端转达到客户端应用程序(其他机器上的SQLPLUS或者其他前台开发语言)

raise_application_error(异常类型,传递信息)

异常类型：number() 值域：-20000 到-20999

传递信息：varchar2（2000）

DBMS_STANDARD包的RAISE_APPLICATION_ERROR过程，可以重新定义异常错误消息，它为应用程序提供了一种与ORACLE交互的方法。语法如下

RAISE_APPLICATION_ERROR(errorNumber,errorString)

errorNumber是数值在-20000到-20999之间，errorString为自定义的错误信息。

如：

update jobs set job_title = v_newJobTitle where job_id = v_jobid;

if sql%notfound then

   RAISE_APPLICATION_ERROR(-20167,'update failure!');

end if;

..........

当在sqlpus中测试时，一旦没有要更新的行，则抛出这样的异常：

ORA-20167: update failure!

oracle的异常分为编译时异常(错误)和运行时异常，前者不能被处理，后者可以被处理。
我们主要讨论运行时异常。

异常类型：
a、预定义异常
      已命名的预定义异常有CURSOR_ALREADY_OPEN、INVALID_NUMBER、TOO_MANY_ROWS等
b、用户定义异常
c、已命名异常(已命名异常不能单独归为一类异常，但它有点特别，所以我将它单独罗列说明)
      如果希望处理一个异常(被when子串处理)，那么异常必须有一个名字，如TOO_MANY_ROWS；
      数据库错误有数千个，但是只有不到25个是内建的已命名异常(这些异常都声明在standard包中)；
      要处理那些未命名的异常时，你可以将一个名字和一个错误号联系在一起，达到这个目的的语句是pragma exception_init语句；

抛出异常：
a、通过pl/sql运行时引擎
      当数据库或pl/sql在运行时发生错误时，一个异常被pl/sql运行时引擎自动抛出
b、使用raise语句
      异常也可以通过raise语句抛出：raise exception_name;
c、调用raise_application_error存储过程

处理异常&异常传播：
a、一旦程序进入异常部分就不能再回到同一块的执行部分；当异常被处理后，控制返回到外层执行部分的下一条语句；
b、如果有when others子串，则必须放置在最后面作为缺省处理器处理没有显式处理的异常；
c、执行部分抛出的异常将首先传递到同一块的异常部分，如果在同一块的异常部分没有处理这个异常的处理器，那么异常将会传播到上一层的异常部分中，一直到最外层；
d、异常被处理后如果你仍然希望它继续传播，可以在异常处理的最后执行不带参数的raise语句(raise语句将重新抛出出现的异常，允许它继续传播)；

--这是一个上面部分知识点的示例(伪代码)说明
declare
...
user_define_exception exception; --用户定义异常
invalid_column_name exception;
--补充说明：如果我们在程序块中使用了无效列名，会有括号中的错误提示(ORA-00904:invalid column name)
--下面我们将这个异常代码号与我们自定义的异常进行关联，即为异常命名
pragma exception_init(invalid_column_name,-904);
begin
...
--raise user_define_exception; --可以显式引发异常
exception
when TOO_MANY_ROWS then --预定义异常处理
    ...;
when user_define_exception then --用户定义异常处理
    ...;
when invalid_column_name then --PRAGMA EXCEPTION_INIT异常处理
    ...;
    raise;    --继续传播该异常
end;

sqlcode和sqlerrm：
a、另外一种处理数据库错误的方法是使用内建函数sqlcode和sqlerrm；
b、sqlcode将返回现行数据库错误号，这些错误号中除了no_data_found是+100外其他都是负数；
c、sqlerrm返回文本描述的错误信息；
d、为了获得用户自定义异常返回的sqlerrm和sqlcode，你需要使用raise_application_error函数给自定义异常标注错误号

给自定义错误标注号码：
a、raise_application_error内建函数用于抛出一个异常并给异常赋予一个错误号以及错误信息；
b、自定义异常的缺省错误号是+1,缺省信息是user_defined_exception。来自未处理的异常的一般信息对于识别导致错误的原因没有帮助，
c、raise_application_error函数能够在pl/sql程序块的执行部分和异常部分调用，显式抛出带特殊错误号的命名异常；
d、使用语法：raise_application_error(error_no,error_message[,{true|| false}]);
e、错误号的范围是-20,001到-20,999；错误信息是文本字符串，最多为2048字节；true和false表示是添加(true)进错误堆(error stack)还是覆盖(overwrite)错误堆(false)。缺省情况下是false。