utPLSQL用户指南三-优快云博客

本文深入探讨了UTResult与UTAssert包在测试环境中的使用方法，包括初始化、显示结果、检索测试状态、遍历结果数组以及控制成功信息的显示等功能。详细介绍了如何通过这些API实现高效且灵活的测试流程。

utResult包包含以下过程和函数。

初始化结果数据。utResult.init。
显示结果。utResult.show、utResult.showone、utResult.showlast。
显示最后一个测试的成功或失败。utResult.success、utResult.failure。
迭代访问结果数组。utResult.firstresult、utResult.nextresult、utResult.nthresult、utResult.resultcount。
控制成功测试的显示。utResult.include_successes、utResult.ignore_successes。

utResult包提供了一个控制utAsert断言程序输出信息的API。utPLSQL.test与utPLSQL.testsuite的结果通过utResult.show过程进行显示。因此，通常不需要执行任何操作。但是，如果想要从其他环境中访问这些信息（例如Oracle Forms或Java等），或者构建自己的断言逻辑或者测试引擎，可以使用utResult包中的程序。

1、初始化

要初始化utResult数据，使用以下过程将其设置为NULL：

2、显示结果

使用以下三个过程之一显示测试结果。

其中，run_id_in用于查看某一次测试内的结果。

使用show过程显示utResult数组中的全部结果。如果reset_in设置为TRUE，将会初始化结果信息。

使用showone过程显示第n个结果。

使用showlast显示最后一个测试结果。

3、检索测试状态

函数success与failure用于返回最后一次测试的状态。

FUNCTION success (run_id_in IN utr_outcome.run_id%TYPE := NULL)
      RETURN BOOLEAN;

   FUNCTION failure (run_id_in IN utr_outcome.run_id%TYPE := NULL)
      RETURN BOOLEAN;

4、遍历结果数组

utPLSQL.show过程遍历utResult结果数组并显示信息。同样也可以使用以下程序组合编写相同的逻辑。

PROCEDURE firstresult (run_id_in IN utr_outcome.run_id%TYPE := NULL);

   FUNCTION nextresult (run_id_in IN utr_outcome.run_id%TYPE := NULL)
      RETURN result_rt;

   PROCEDURE nextresult (
      name_out        OUT      VARCHAR2,
      msg_out         OUT      VARCHAR2,
      case_indx_out   OUT      PLS_INTEGER,
      run_id_in       IN       utr_outcome.run_id%TYPE := NULL
   );

   FUNCTION nthresult (
      indx_in     IN   PLS_INTEGER,
      run_id_in   IN   utr_outcome.run_id%TYPE := NULL
   )
      RETURN result_rt;

   PROCEDURE nthresult (
      indx_in         IN       PLS_INTEGER,
      name_out        OUT      VARCHAR2,
      msg_out         OUT      VARCHAR2,
      case_indx_out   OUT      PLS_INTEGER,
      run_id_in       IN       utr_outcome.run_id%TYPE := NULL
   );

   FUNCTION resultcount (run_id_in IN utr_outcome.run_id%TYPE := NULL)
      RETURN PLS_INTEGER;