Oracle专题15之包

1、包的概述

a、什么是包？

• 包是一组相关过程、函数、变量、常量和游标等PL/SQL程序设计元素的组合。

  b、包的特点？

• 它具有面向对象程序设计语言的特点，是对PL/SQL程序设计元素（过程、函数、变量等）的封装。
• 它使程序设计模块化。

  c、包中的程序元素

• 包中的程序元素分为两种：公用元素（公用组件）、私用元素（私用组件）。

  e、包的组成

• 一个包由两个分开的部分组成：
• 包规范（包定义）：用于定义包的公用组件，包括常量、变量、游标、过程和函数等。
• 包体（包主体）：用于实现包规范所定义的公用过程和函数。包体不仅可用于实现公用过程和函数，而且还可以定义包的私有组件（变量、游标、过程、函数等）。

  f、简单代码示例

• 创建包规范和包体的示例代码

  --创建包规范
  CREATE OR REPLACE PACKAGE first_package
  IS
      v_no emp.deptno%TYPE := 10;
      --过期
      PROCEDURE query_emp(v_deptno IN NUMBER DEFAULT v_no, v_avgsal OUT NUMBER, v_cnt OUT NUMBER);
  END first_package;
  --创建包体
  CREATE OR REPLACE PACKAGE BODY first_package
  IS
               PROCEDURE query_emp(v_deptno IN NUMBER DEFAULT v_no, v_avgsal) OUT NUMBER, v_cnt OUT NUMBER)
               IS
               BEGIN
                   SELECT avg(sal), count(*) INTO v_avgsal, v_cnt FROM emp WHERE deptno = v_deptno;
               EXCEPTION
                   WHEN NO_DATA_FOUND THEN
                       dbms_output.put_line('没有此部门');   
                   WHEN OTHERS THEN
                       dbms_output.put_line(SQLERRM);
                   END;
  END first_package;

• 调用包中的存储过程：

  DECLARE
      v_avgsal NUMBER;
      v_cnt NUMBER;
  BEGIN
      first_package.query_emp(20, v_avgsal, v_cnt);
      DBMS_OUTPUT.put_line('平均工资：' || v_avgsal);
      DBMS_OUTPUT.put_line('总人数：' || v_cnt);
  END;

  2、包的创建

  a、创建包规范

• 语法格式如下：

  CREATE [OR REPLACE] PACKAGE package_name
  IS | AS
  -- 定义公用常量、变量、游标、过程、函数等
  END [package_name];

• 示例代码：

  CREATE OR REPLACE PACKAGE emp_package
  IS
               --添加员工信息的存储过程
               PROCEDURE add_emp_proc
               (v_empno IN emp.empno%TYPE,
               v_ename IN emp.ename%TYPE,
               v_sal IN emp.sal%TYPE,
               v_deptno IN emp.deptno%TYPE);
  
               --删除员工信息的存储过程
               PROCEDURE del_emp_proc
               (v_empno IN emp.empno%TYPE);
  END emp_package;

  b、创建包体

• 语法格式如下：

  CREATE [OR REPLACE] PACKAGE BODY package_name 
  IS | AS
  --定义私有常量、变量、游标、过程和函数等
  --实现公用过程和函数
  END [package_name];

• 示例代码：

  CREATE OR REPLACE PACKAGE BODY emp_package
  IS    
              --添加员工信息的存储过程
               PROCEDURE add_emp_proc
               (v_empno IN emp.empno%TYPE,
               v_ename IN emp.ename%TYPE,
               v_sal IN emp.sal%TYPE,
               v_deptno IN emp.deptno%TYPE)
               IS
                                  e_2291 EXCEPTION;
                                  PRAGMA EXCEPTION_INIT(e_2291, -2291);
               BEGIN
                   INSERT INTO emp(empno, ename, sal, deptno) VALUES(v_empno, v_ename, v_sal, v_deptno);
               EXCEPTION
                   WHEN DUP_VAL_ON_INDEX THEN
                       RAISE_APPLICATION_ERROR(-20001, '员工号不能重复');
                   WHEN e_2291 THEN
                       RAISE_APPLICATION_ERROR(-20002, '部门号不存在');
               END;
  
               --删除员工信息的存储过程
               PROCEDURE del_emp_proc
               (v_empno IN emp.empno%TYPE)
               IS
               BEGIN
                   --根据员工号删除指定的员工信息
                   DELETE FROM emp WHERE empno = v_empno;
                   --判断是否删除成功
                   IF SQL%NOTFOUND THEN
                       RAISE_APPLICATION_ERROR(-20009, '指定删除的员工不存在');
                   ELSE
                       DBMS_OUTPUT.PUT_line('删除成功');
                   END IF;
               END;
  END emp_package;

  c、包创建的过程案例代码

• 根据员工号查询工资，如果工资小于等于3000，工资涨500。

  --创建包规范
  CREATE OR REPLACE PACKAGE emp_sal_pkg
  IS
               FUNCTION get_sal(eno NUMBER) RETURN NUMBER;
  
               PROCEDURE upd_sal(eno NUMBER, salary NUMBER);
  END emp_sal_pkg;
  
  --包体
  CREATE OR REPLACE PACKAGE BODY emp_sal_pkg
  IS
               FUNCTION get_sal(eno NUMBER) RETURN NUMBER
               IS
                                  v_sal emp.sal%TYPE := 0;
               BEGIN
                                  SELECT sal INTO v_sal FROM emp WHERE empno = eno;
                                  RETURN v_sal;
               EXCEPTION
                                  WHEN NO_DATA_FOUND THEN
                                      RAISE_APPLICATION_ERROR(-20010,'此员工号不存在');
               END;
  
               PROCEDURE upd_sal(eno NUMBER, salary NUMBER)
               IS
               BEGIN
                   IF salary <=3000 THEN
                       UPDATE emp SET sal = sal + 500 WHERE empno = eno;
                   END IF;
               END;
  END emp_sal_pkg;  

  3、包的调用和删除

  a、包的调用

• 对包内共有元素（公用组件）的调用格式为：包名.元素名称（组件名称）
• 例如：emp_package.del_emp_proc();

  b、 包的调用示例1

• 调用emp_package包下添加员工信息的存储过程。（在本专题的第2节包的创建，已经在Oracle数据库中创建emp_package包规范和包体）
  

  DECLARE 
      v_empno emp.empno%TYPE := &empno;
      v_ename emp.ename%TYPE := '&name';
      v_sal emp.sal%TYPE := &salary;
      v_deptno emp.deptno%TYPE := &deptno;
      e_dup_val EXCEPTION;
      e_no_dept EXCEPTION;
  
      PRAGMA EXCEPTION_INIT(e_dup_val, -20001);
      PRAGMA EXCEPTION_INIT(e_no_dept, -20002);
  BEGIN
      emp_package.add_emp_proc(v_empno, v_ename, v_sal, v_deptno);
      COMMIT;
  EXCEPTION
      WHEN e_dup_val THEN
          DBMS_OUTPUT.put_line(SQLERRM);
      WHEN e_no_dept THEN
          DBMS_OUTPUT.put_line(SQLERRM);
          ROLLBACK;
  END;

  b、包的调用示例2

• 调用emp_package包下删除员工信息的存储过程。（在本专题的第2节包的创建，已经在Oracle数据库中创建emp_package包规范和包体）
  

  DECLARE 
      v_empno emp.empno%TYPE := &empno;
      e_no_emp EXCEPTION;
      PRAGMA EXCEPTION_INIT(e_no_emp, -20009);
  BEGIN
      emp_package.del_emp_proc(v_empno);
      COMMIT;
  EXCEPTION
      WHEN e_no_emp THEN
          DBMS_OUTPUT.put_line(SQLERRM);
          ROLLBACK;
  END;

  c、包的调用示例3

• 调用emp_sal_pkg包下的过程和函数：（在本专题的第2节包的创建，已经在Oracle数据库中创建emp_sal_pkg包规范和包体）
  
  1、调用根据员工号返回员工工资的函数
  2、调用更新满足条件的员工工资的过程

  DECLARE
      v_empno emp.empno%TYPE := &empno;
      v_salary emp.sal%TYPE;
      e_no_emp EXCEPTION;
      PRAGMA EXCEPTION_INIT(e_no_emp, -20010);
  BEGIN
      v_salary := emp_sal_pkg.get_sal(v_empno);
      emp_sal_pkg.upd_sal(v_empno, v_salary);
      COMMIT;
  EXCEPTION
      WHEN e_no_emp THEN
          DBMS_OUTPUT.put_line(SQLERRM);
  END;

  d、如何在SQLPlus窗口中进行包的调用

• 示例1：在SQLPlus窗口中进行emp_sal_pkg包的调用，查询员工的工资信息：

  SQL> VAR v_empno NUMBER
  SQL> EXEC :v_empno := &no
  
  PL/SQL procedure successfully completed
  
  v_empno
  ---------
  1234
  
  SQL> VAR v_salary NUMBER
  SQL> EXEC :v_salary := emp_sal_pkg.get_sal(:v_empno)
  begin :v_salary := emp_sal_pkg.get_sal(:v_empno); end;
  
  ORA-20010: 此员工号不存在
  ORA-06512: 在 "SCOTT.EMP_SAL_PKG", line 11
  ORA-06512: 在 line 1
  v_salary
  ---------
  v_empno
  ---------
  1234

• 示例2：在SQLPlus窗口中进行emp_sal_pkg包的调用，更新员工的工资信息：（变量v_empno已经在示例1中定义）

  SQL> EXEC :v_empno := &no
  
  PL/SQL procedure successfully completed
  
  v_empno
  ---------
  7369
  
  SQL> EXEC :v_salary := emp_sal_pkg.get_sal(:v_empno)
  
  PL/SQL procedure successfully completed
  
  v_salary
  ---------
  800
  v_empno
  ---------
  7369
  
  SQL> EXEC emp_sal_pkg.upd_sal(:v_empno, :v_salary)
  
  PL/SQL procedure successfully completed
  
  v_empno
  ---------
  7369
  v_salary
  ---------
  800
  
  SQL> SELECT ename, sal from emp WHERE empno = 7369;
  
  ENAME            SAL
  ---------- ---------
  G_EASON      1300.00

• 在SQLPlus环境中，可以使用 [VAR 变量名 变量类型]命令定义变量。

  e、包的删除

• 可以使用DROP PACKAGE命令对不需要的包进行删除，语法如下：

  DROP PACKAGE [BODY] [user.] package_name;

  4、子程序重载

  a、什么是子程序重载？

• 所谓重载是指两个或者多个子程序有相同的名称，但是拥有不同的参数变量、参数顺序或者参数数据类型。

  b、示例代码

• 示例：1、根据员工号或者员工姓名获取员工信息；2、根据员工号或者员工姓名删除员工的信息。

  --创建包规范
  CREATE OR REPLACE PACKAGE overload_pkg
  IS
               FUNCTION get_info(eno NUMBER) RETURN emp%ROWTYPE;
               FUNCTION get_info(name VARCHAR) RETURN emp%ROWTYPE;
  
               PROCEDURE del_emp(eno NUMBER);
               PROCEDURE del_emp(name VARCHAR);
  END;
  --创建包体
      CREATE OR REPLACE PACKAGE BODY overload_pkg
  IS
               FUNCTION get_info(eno NUMBER) RETURN emp%ROWTYPE
               IS
                                  emp_record emp%ROWTYPE;
               BEGIN
                                  SELECT * INTO emp_record FROM emp WHERE empno = eno;
                                  RETURN emp_record;
               EXCEPTION
                                  WHEN NO_DATA_FOUND THEN
                                           RAISE_APPLICATION_ERROR(-20020, '不存在此员工');
               END;
  
               FUNCTION get_info (name VARCHAR) RETURN emp%ROWTYPE
               IS
                                  emp_record emp%ROWTYPE;
               BEGIN
                                  SELECT * INTO emp_record FROM emp WHERE ename= name;
                                  RETURN emp_record;
               EXCEPTION
                                  WHEN NO_DATA_FOUND THEN
                                      RAISE_APPLICATION_ERROR(-20020, '不存在此员工');
               END;
  
               PROCEDURE del_emp(eno NUMBER)
               IS
               BEGIN
                   DELETE FROM emp WHERE empno = eno;
                   IF SQL%NOTFOUND THEN
                       RAISE_APPLICATION_ERROR(-20020, '不存在此员工');
                   END IF;
               END;
  
               PROCEDURE del_emp(name VARCHAR)
               IS
               BEGIN
                   DELETE FROM emp WHERE ename = name;
                   IF SQL%NOTFOUND THEN
                       RAISE_APPLICATION_ERROR(-20020, '不存在此员工');
                   END IF;
               END;
  END overload_pkg;

• overload_pkg包的调用示例：

  --根据员工号查询员工信息
  DECLARE
      emp_record emp%rowtype;
      e_no_emp EXCEPTION;
      PRAGMA EXCEPTION_INIT(e_no_emp, -20020);
  BEGIN 
      emp_record := overload_pkg.get_info(&no);
      DBMS_OUTPUT.put_line('员工号：' || emp_record.empno || '，姓名：' || emp_record.ename || '，工资：' || 
      emp_record.sal);
  EXCEPTION
      WHEN e_no_emp THEN
          DBMS_OUTPUT.put_line(SQLERRM);
  END;

  --根据员工姓名查询员工信息
  DECLARE
      emp_record emp%rowtype;
      e_no_emp EXCEPTION;
      PRAGMA EXCEPTION_INIT(e_no_emp, -20020);
  BEGIN 
      emp_record := overload_pkg.get_info('&ename');
      DBMS_OUTPUT.put_line('员工号：' || emp_record.empno || '，姓名：' || emp_record.ename || '，工资：' || 
      emp_record.sal);
  EXCEPTION
      WHEN e_no_emp THEN
          DBMS_OUTPUT.put_line(SQLERRM);
  END;

  --根据员工号删除员工信息
  DECLARE 
      e_no_emp EXCEPTION;
      PRAGMA EXCEPTION_INIT(e_no_emp, -20020);
  BEGIN
      overload_pkg.del_emp(&no);
      COMMIT;
  EXCEPTION
      WHEN e_no_emp THEN
          DBMS_OUTPUT.put_line(SQLERRM);
      ROLLBACK;
  END;

  
  --根据员工姓名删除员工信息
  DECLARE 
      e_no_emp EXCEPTION;
      PRAGMA EXCEPTION_INIT(e_no_emp, -20020);
  BEGIN
      overload_pkg.del_emp('&ename');
      COMMIT;
  EXCEPTION
      WHEN e_no_emp THEN
          DBMS_OUTPUT.put_line(SQLERRM);
      ROLLBACK;
  END;