<转载> ORACLE RAISE_APPLICATION_ERROR

时间：2010-10-28 来源：yujunleik

可能不是很多人知道 RAISE_APPLICATION_ERROR 的用途是什么，虽然从字面上已经猜到这个函数是干什么用的。
      其实 RAISE_APPLICATION_ERROR 是将应用程序专有的错误从服务器端转达到客户端应用程序。

      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;

在客户端，你可以写一个类似下面的程序，来测试一下。

DECLARE

    no_babies_allowed EXCEPTION;


     PRAGMA EXCEPTION_INIT(no_babies_allowed, -20001);

BEGIN

       INSERT INTO employee ....;

EXCEPTION
       WHEN no_babies_allowed
       THEN

              DBMS_OUTPUT.PUT_LINE(SQLERRM);
END;

------------------------------------------------------------------------------

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!