wmframework v2.0 手册（五）ibatis改写扩展说明
1、源码修改记录
1.1、 sqlmap中新增执行节点statements
修改了sqlmap校验解析文件sql-map-2.dtd
修改了sqlmap解析器：SqlMapParser.java
example:
<statements id="insertUsersList" parameterClass="test.A">//一层节点
<selectKey keyProperty="userId" resultClass="String" type="pre">
SELECT P_GET_KEY('SEQ_USER_KEY') from DUAL
</selectKey>
<insert id="insertUserO" parameterClass="test.A">//二层节点
INSERT INTO A
(
USER_ID ,
USER_NAME ,
PASSWORD ,
create_time
)
values(
P_GET_KEY('SEQ_USER_KEY'),
#userName#,
#password#,
SYSDATE
)
</insert>
<insert id="insertUserB" parameterClass="test.A">
INSERT INTO SUBA
(
USER_ID ,
EMP_ID
)
values(
P_GET_KEY('SEQ_USER_KEY'),
P_GET_KEY('SEQ_USER_KEY')
)
</insert>
</statements>
1.2、 ClassKey生成使用
修改了sqlmap校验解析文件sql-map-2.dtd
新定义classkey处理类：com.ibatis.sqlmap.engine.mapping.statement. ClassKeyStatement记录当前需要生成的key的class路径
在sqlmap解析器中新增classkey节点的检查校验
com.ibatis.sqlmap.engine.builder.xml.SqlStatementParser
修改了sql执行代理器中关于classkey的取值及参数对象赋值
com.ibatis.sqlmap.engine.impl.SqlMapExecutorDelegate
example:
<!-- classkey产生主键 -->
<insert id="insertUserClassKey" parameterClass="test.A">
<![CDATA[ INSERT INTO A
(
USER_ID ,
USER_NAME ,
PASSWORD ,
create_time
)
values(
#userId#,
#userName#,
#password#,
SYSDATE
) ]]>
<classKey keyProperty="userId" resultClass="String" type="pre"
className="test.util.GenerateSerial"
methodName="getUUID"
args="1,2"
paramTypes="java.lang.String,int"
>
</classKey>
</insert>
1.3、 insert中多SQL同步保存
sql表示器com.ibatis.sqlmap.engine.mapping.statement. MappedStatement新增属性resSql，用于记录sqlmap中原始定义的sql，便于后期检查是否存在多个sql的分割标志。当前设置为分号“;”
修改sql执行方法，检查当前是否存在多个sql同时提交的情况；
修改sql执行器com.ibatis.sqlmap.engine.execution.SqlExecutor中对于参数的赋值方法
重构参数映射类
com.ibatis.sqlmap.engine.mapping.parameter.ParameterMap中设定参数的方式，即存在多个sql公用某个参数类时，需要进行键值提取，并处理先后顺序
1.4、 批处理优化
修改了sql执行器com.ibatis.sqlmap.engine.execution.SqlExecutor,
添加了sql执行保存器，用于存储已经添加过在批处理桶列中的sql识别集合map。
即扩展当前检查sql执行的方法：
if (currentSql != null && currentSql.equals(sql)) {
//检查是否与前一个执行sql相同
int last = statementList.size() - 1;
ps = (PreparedStatement) statementList.get(last);
//add by warison 20101019 检查当前sql是否已经使用过了
} else if (psMap.containsKey(sql)) {
//检查是否已经在过去生成过当前sql
ps = (PreparedStatement) psMap.get(sql);
} else{
1.5、Debug模式下打印完整的SQL语句
- 改进目标
即使用ibatis时需要在控制台或日志文件中打印其当前执行的完整sql，而不是常见的参数 问号 ？ 语句。
- 执行顺序分析
Ibatis中常见API执行流程：
- 修改说明
主要修改com.ibatis.sqlmap.engine.execution.SqlExecutor，找到方法executeUpdate，即ps.execute();语句执行之前，新增如下代码：
//打印调试信息 start
if (log.isDebugEnabled()) {
int count = ps.getParameterMetaData().getParameterCount();
for (int i = 0; i < count; i++) {
sql = sql.replaceFirst("\\?", parameters[i].getClass().getName().equals("java.lang.String") ? "'"+parameters[i].toString()+"'" : parameters[i].toString());
}
log.debug("===当前执行SQL为===" + sql + ".");
}
//打印调试信息 end
2、扩展使用说明
2.1、sqlmap中新增执行节点statements
sqlmap中新增执行节点 statements，其中可以包含多个子节点（insert、update、delete、statement均可），改功能扩展后用处不太理想
使用参考：参考以上
2.2、ClassKey生成使用
classKey获取主键即为，执行某个class中的方法后生成主键序列的方式，格式定义是为：
<classKey
keyProperty="userId" //生成key存放如parameterClass的属性名称，必填
resultClass="String" //返回key结果类型，必填
type="pre"//insert执行前、后执行当前生成主键方式，必填
className="test.util.GenerateSerial"//当前执行类全路径，必填
methodName="getUUID"//当前执行方法，必填
args="1,2"//参数值，多个以逗号隔开，选填
paramTypes="java.lang.String,int"//参数类型，多个以逗号隔开，选填
>
</classKey>
以上即表示执行test.util.GenerateSerial中getUUID，并传递参数1,2。返回字符串类型数据存放在userId中
2.3、insert中多SQL同步保存
在sqlmap中扩展insert节点，可确保一次性提交同步执行多条sql，各sql之间以逗号;隔开（当前分隔符可自行定义），这有利于保证主子表同步保存时，关联外键的相同性。而且多个sql语句仅需要定义一个参数类或map等形式。这样我们就没必要再service层定义aop之类以事务管理了，也减少了很多没必要的代码编写
这这里统一可以使用selectKey、classKey产生主键。
当然对于，update、delete同样适用当前方法。
具体写法参考：
<insert id="insertUserO" parameterClass="test.A">
INSERT INTO A
(
USER_NAME ,
USER_ID ,
PASSWORD ,
create_time
)
values(
#userName#,
#userId#,
#password#,
SYSDATE
);
INSERT INTO SUBA
(
CNAME,
USER_ID ,
FLAG ,
EMP_ID
)values(
#cname#,
#userId#,
#flag#,
P_GET_KEY('SEQ_USER_KEY')
)
</insert>
（注：本人文章均为原创，转载请注明出处！刀光剑影20110215写于深圳。）