怎么在MyBatis中正确调用带有Out参数的Oracle存储过程?

阿强姑娘_6795

阿强姑娘_6795

2026-09-12

449人浏览

原创

必须设置statementtype="callable"且out参数显式声明mode=out和jdbctype,否则mybatis无法回写结果;游标需配专用resultmap,参数容器须为可修改map或含setter的实体类。

怎么在mybatis中正确调用带有out参数的oracle存储过程?

必须用 statementType="CALLABLE",且所有 OUT 参数的 mode 要显式设为 OUT,否则 MyBatis 不会把结果回写到参数容器里。

MyBatis XML 中必须声明 statementType="CALLABLE"

这是最关键的开关。默认 statementType="PREPARED",MyBatis 会把它当普通 SQL 解析,根本不会触发存储过程调用协议。哪怕你写了 {call ...} 语法,没这个属性照样报错或静默失败。

  • statementType 必须写在 <select></select>、<update></update> 或 <insert></insert> 标签上,不能只靠 SQL 字符串识别
  • Oracle 存储过程返回游标(sys_refcursor)时,也必须加这个属性,否则 jdbcType="CURSOR" 会被忽略
  • 别依赖“不写就默认”,MyBatis 不会自动推断存储过程意图

OUT 参数必须用 mode=OUT + 显式 jdbcType

Oracle 对数据类型敏感,MyBatis 需要提前知道 JDBC 如何绑定和读取 OUT 参数。漏掉 mode 或 jdbcType,轻则值为 null,重则抛 SQLException: Invalid column type。

Crypto Sniper Oracle
Crypto Sniper Oracle

机构级量化市场预言机,提供订单簿失衡(OBI)、VWAP分析、自动化报告及Telegram预警。

下载
  • #{paramName, mode=OUT, jdbcType=VARCHAR} —— jdbcType 必须匹配 Oracle 实际定义的类型,比如 VARCHAR2 对应 VARCHAR,NUMBER 对应 NUMERIC 或 INTEGER
  • 如果 OUT 是游标,jdbcType 固定写 CURSOR,且必须配 resultMap 和 javaType=java.sql.ResultSet
  • 别用 parameterMap(已废弃),全用 parameterType + 内联 #{...} 方式更可控

参数容器必须是可修改的 Map 或实体类

MyBatis 把 OUT 参数的值直接 set 进你传入的对象字段或 Map 的 key。如果传的是不可变对象(如 String)、原始类型(int)、或 final 字段,值永远拿不到。

  • 推荐用 HashMap<string object></string>:入参 put 进去,出参自动塞进同名 key,调用后直接 get
  • 也可用自定义实体类,但字段必须有 public setter,且命名与 XML 中 #{xxx} 的 key 一致
  • 不要传 Integer、String 等包装类/不可变类型作 OUT 参数载体——它们无法被 MyBatis 修改内部值
  • 测试时打印整个 Map 或实体对象,确认 OUT 键是否已存在且非 null

Oracle 游标必须配独立 resultMap,不能复用已有映射

MyBatis 对游标结果集的解析完全依赖 resultMap 定义。如果误用主表的 BaseResultMap,会报 Invalid column index 或字段映射全为空。

  • 游标专用的 resultMap 必须明确指定每个列的 column 和 property,大小写需与 Oracle 查询结果一致(通常大写)
  • resultMap 的 type 可以是 POJO 类,也可以是 java.util.HashMap,但后者要注意 key 全是大写字符串
  • XML 中引用时,大小写敏感:resultMap="ProcedureInfoMap" 必须和 <resultmap id="ProcedureInfoMap"></resultmap> 完全一致

最常被忽略的一点:Oracle 存储过程中对 sys_refcursor 的 OPEN ... FOR 语句,其 SELECT 字段顺序和别名,必须和 MyBatis 的 resultMap 列定义严格对应——差一个位置,整行数据就错位了。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
mybatis一级缓存和二级缓存
mybatis一级缓存和二级缓存

在MyBatis中,一级缓存和二级缓存是两种不同级别的缓存机制,它们都可以用来提高性能。本专题提供mybatis一级缓存和二级缓存相关文章,大家可以免费阅读。

2023.08.21

583

4

ibatis和mybatis有什么区别
ibatis和mybatis有什么区别

ibatis和mybatis的区别:1、基本信息不同;2、开发时间不同;3、功能与易用性;4、配置文件;5、入参类型与出参类型;6、返回结果集接受方式;7、语法差异;8、数据库方言支持;9、插件支持;10、社区活跃度;11、全球化支持。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

2182

5

mybatis如何配置数据库连接
mybatis如何配置数据库连接

mybatis配置数据库连接的方法:1、指定数据源;2、配置事务管理器;3、配置类型处理器和映射器;4、使用环境元素;5、配置别名。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

446

5

mybatis工作原理及流程是什么
mybatis工作原理及流程是什么

mybatis工作原理及流程:1、配置文件;2、接口与映射;3、sql解析与生成;4、执行计划;5、结果处理;6、动态sql;7、缓存机制;8、插件;9、事务管理;10、日志与监控;11、扩展性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

292

4

hibernate和mybatis有哪些区别
hibernate和mybatis有哪些区别

hibernate和mybatis的区别:1、实现方式;2、性能;3、对象管理的对比;4、缓存机制。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

302

5

Java MyBatis框架
Java MyBatis框架

本专题专注于Java主流ORM框架MyBatis的应用,系统讲解SQL映射、动态SQL、结果映射、分页查询、缓存机制与多表关联等核心内容,并结合企业管理系统、电商平台和后台管理项目实战,帮助学员全面掌握高效的数据库持久层开发技能。

2025.08.26

5329

22

oracle清空表数据
oracle清空表数据

当表中的数据不需要时,则应该删除该数据并释放所占用的空间。本专题为大家提供oracle清空表数据的相关文章,帮助大家解决该问题。

2023.08.16

881

5

Oracle中declare的使用
Oracle中declare的使用

Oracle DECLARE语句是PL/SQL编程语言中用于声明变量、常量、游标或异常的关键字。它的主要作用是在程序中定义这些对象,以便在后续的代码中使用。DECLARE语句的语法简单明了,可以根据需要声明多个对象。通过使用这些声明的对象,可以进行各种操作,如计算、查询数据库、处理异常等 。

2023.09.15

2473

5

oracle怎么分页
oracle怎么分页

实现分页的步骤:1、使用ROWNUM进行分页查询;2、在执行查询之前进行设置分页参数;3、使用"COUNT(*)"函数来获取总行数,并使用"CEIL"函数来向上取整计算总页数;4、在外部查询中使用"WHERE"子句来筛选出特定的行号范围,以实现分页查询。想了解更多oracle怎么分页的文章,可以来阅读本专题先的文章。

2023.09.18

2510

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程