Foxnic-SQL (9) —— DAO 特性 : 执行存储过程与函数

概述

Foxnic-SQL 对函数与存储过程的调用做了简化，使调用过程尽量简洁。虽然现在新构建的应用越来越不提倡使用数据库存储过程与函数，但是它们还是非常广泛地被使用着。任何技术的使用，一是看场景，而是看使用者，存储过程和函数不应被抛弃。
本文中的示例代码均可在 https://gitee.com/LeeFJ/foxnic-samples 项目中找到。

定义存储过程

首先，在数据库创建存储过程和函数，存储过程的特点是多个参数，多个返回值。函数的特点是多个参数，一个返回值。当然，从数据库角度它们还有其它的区别，我们不做展开，在此我们只关心调用的形式。示例代码如下：

CREATE DEFINER=`foxnic`@`%` PROCEDURE `demo_proc`
(
 IN a decimal(8,2),
 IN b decimal(8,2),
 OUT c decimal(8,2),
 OUT d decimal(8,2)
)
BEGIN
  set c=a+b;
  set d=a*b;
END

CREATE DEFINER=`foxnic`@`%` FUNCTION `demo_func`(
  a decimal(8,2),
  b decimal(8,2)
) RETURNS decimal(8,2) DETERMINISTIC
BEGIN
    RETURN a+b;
END

调用函数

函数的调用相对比较简单，也就是传入参数返回结果，示例代码如下：

/**
* 数据库函数调用测试
* */
@Test
    public void test_func() {
    // 通过 DBInstance 拿到 DAO 对象
    DAO dao= DBInstance.DEFAULT.dao();
    // 从 dao 拿到存储函数对象
    StoredFunction function =dao.getStoredFunction("demo_func",BigDecimal.class);
    // 按顺序传入参数
    BigDecimal result= function.execute(1.1,2.2);
    // 检查结果
    assertTrue(result.doubleValue()==3.30);
}

针对 StoredFunction 类由于它只有一个返回值，Foxnic-SQL 使用了泛型的方式来简化参数定义。通过 DAO 拿到 StoredFunction 对象，通过 execute 方法按顺序传入参数，执行即可。

调用存储过程

由于存储过程可以是多入参、多出参，所以它的调用过程相对复杂一点。它需要有参数类型定义，map 参数传入并执行，返回多个结果值等几个步骤，示例代码如下：

/**
* 数据库存储过程调用测试
* */
@Test
    public void test_proc() {
    // 通过 DBInstance 拿到 DAO 对象
    DAO dao= DBInstance.DEFAULT.dao();
    // 从 dao 拿到存储过程对象
    StoredProcedure procedure =dao.getStoredProcedure("demo_proc");
    // 定义参数
    procedure.declareParameter("a", DBDataType.STRING);
    procedure.declareParameter("b", DBDataType.DECIMAL);
    procedure.declareOutParameter("c",DBDataType.DECIMAL);
    procedure.declareOutParameter("d",DBDataType.DECIMAL);
    // 传入 Map 类型参数
    Map result= procedure.execute(MapUtil.asMap("a",1.1,"b",2.2));
    // 获得多个返回值
    BigDecimal c=(BigDecimal) result.get("c");
    BigDecimal d=(BigDecimal) result.get("d");
    // 检查结果
    assertTrue(c.doubleValue()==3.30);
    assertTrue(d.doubleValue()==2.42);
}

小结

本节主要介绍了在 Foxni-SQL 中如何调用数据库的存储过程与函数。存储过程与函数在传参的形式以及接收返回值的形式上有着比较明显的差异。

官方文档

http://foxnicweb.com/docs/doc.html

Foxnic-SQL (9) —— DAO 特性 : 执行存储过程与函数