ITPUB??ì3
ITPUB论坛 » Java web开发及框架技术 » 关于使用IBATIS动态SQL,方法命名的问题


标题: 关于使用IBATIS动态SQL,方法命名的问题
离线 hanfeishu
中级会员



精华贴数 0
个人空间 0
技术积分 3572 (400)
社区积分 0 (1284172)
注册日期 2007-2-28
论坛徽章:19
开发板块每日发贴之星生肖徽章2007版:鼠生肖徽章2007版:鼠生肖徽章2007版:鼠生肖徽章2007版:鼠生肖徽章2007版:鼠
生肖徽章2007版:鼠生肖徽章2007版:鼠生肖徽章2007版:鼠生肖徽章2007版:鼠生肖徽章2007版:鼠生肖徽章2007版:鼠

发表于 2008-7-3 19:15 
关于使用IBATIS动态SQL,方法命名的问题

今天在命名上有一些疑问,希望可以与大家共同讨论,也希望大牛门可以给些指点
遇到同样问题的同学可以来参考

今天的问题是这样地
使用IBATIS来做持久层框架,我们可以很轻松的写出动态SQL语句(一条SQL干很多事情)
一个语句可以通过不同的条件来得到不同过滤粒度的结果。
DAO中也是接收一个VO为参数,里面有SQL所需要的所有条件。通过改变VO中属性的组合,得到不同的结果。
在Facade层中可以有几种命名的选择
比如得到系统用户这样的方法

1.List getUsers(Object obj){} 我们简称大对象的方式
这个obj里面可以有很多属性比如userId,userName,roleId等等.通过调用端传来的值不同得到结果也不一样
比如 userId = -1 userName = "tom" roleId = "employee" dept=""
这样的条件就会查出 所有叫tom的员工. 如果dept有值就会查出dept所有叫tom的在某部门的员工

遇到的问题是这样的:如果着个程序或者SQL是自己写的还好办些,如果是别人写的而且SQL中的判断相当复杂(产生不同结果).那维护和调用这个方法的人就郁闷死了。因为要一直看到SQL文才会知道传什么样的参数才能得到自己想要的结果.如果SQL文中判断非常多嵌套又非常深.可能看SQL文就得一上午的时间.

2.采用
List getUsersByUserName(String name);
List getUserByRoleId(String name,String roleId);
List getUserByDept(String name,Stirng roleId,String dept);

Java代码
List getUsersByUserName(String name){   
    if(name == null || "".equals(name)){   
        throw new IllegalArgumentException("请检查参数列表");      
    }   
}   
List getUserByRoleId(String name,String roleId){   
    if((name == null || "".equals(name))   
        && (roleId == null || "".equals(roleId))){   
        throw new IllegalArgumentException("请检查参数列表");      
    }   
}  

List getUsersByUserName(String name){
    if(name == null || "".equals(name)){
        throw new IllegalArgumentException("请检查参数列表");   
    }
}
List getUserByRoleId(String name,String roleId){
    if((name == null || "".equals(name))
        && (roleId == null || "".equals(roleId))){
        throw new IllegalArgumentException("请检查参数列表");   
    }
}

通过这样的实现可以从方法名称上知道我要的是什么数据.同样维护人员可以在方法名上得知我这些参数组织起来后会得到一个什么样的list,和主要条件
问题是,会产生很多这样的方法.而且名字通常不能表述完全我需要的参数.关键参数需要在程序里面验证.


3.使用List getUsers(User obj){} 加注释的方式
Java代码
/**  
*user.userName = "tom" && roleId = "employee" = 查出 所有叫tom的员工  
*.....其他组合方式的注释  
*/  
List getUsers(User user){   
  
}  

/**
*user.userName = "tom" && roleId = "employee" = 查出 所有叫tom的员工
*.....其他组合方式的注释
*/
List getUsers(User user){

}



知所以出现这样的疑问是为了代码可以更好的被维护,也可以大量节省维护人员的时间。之后无论是别人使用方法,还是维护人员查看代码都不需要去下面找SQL文,面对里面N多判断.在脑子里面组织出自己想要的条件.
大家有什么意见?请多指教~


只看该作者    顶部
离线 juanpeng
中级会员



精华贴数 0
个人空间 0
技术积分 4048 (343)
社区积分 0 (1438955)
注册日期 2007-6-21
论坛徽章:27
开发板块每日发贴之星开发板块每日发贴之星开发板块每日发贴之星生肖徽章2007版:鼠生肖徽章2007版:鼠生肖徽章2007版:鼠
生肖徽章2007版:鼠生肖徽章2007版:鼠生肖徽章2007版:鼠生肖徽章2007版:鼠生肖徽章2007版:鼠生肖徽章2007版:鼠

发表于 2008-7-3 19:16 
我现在用List getUsers(Map<?,?> map){} + 文档或注释。
可以维持接口统一,并保持接口简单。
用map可以表述很多user对象本身表述不了的东西,简单的如MYSQL的limit,而且iBatis对map的支持相当好。
方法二,一方面会照成接口臃肿。另一方面,方法名本身携带的信息很有限,简单的也就算了,要是复杂的查询怎么办?还不如直接留个详细的文档给维护人员。
嗯,这个问题仁者见仁智者见智,我占个楼,看看大家的想法,多多学习,呵呵。


只看该作者    顶部
离线 smartpig
老会员



精华贴数 1
个人空间 160
技术积分 5689 (228)
社区积分 0 (1064170)
注册日期 2006-8-9
论坛徽章:33
会员2007贡献徽章开发板块每日发贴之星开发板块每日发贴之星开发板块每日发贴之星生肖徽章2007版:鼠生肖徽章2007版:鼠
生肖徽章2007版:鼠生肖徽章2007版:鼠生肖徽章2007版:鼠生肖徽章2007版:鼠生肖徽章2007版:鼠生肖徽章2007版:鼠

发表于 2008-7-3 19:17 
我在项目中一般这样做
每一个SQL都对应于详细设计书(excel文件)的一个sheet相对应
在设计书中每一个用逻辑名写SQL
在Dao的方法注释中通常只需要把sheet名称copy过来


只看该作者    顶部
离线 cyntha80
中级会员



精华贴数 1
个人空间 0
技术积分 3967 (350)
社区积分 2 (29984)
注册日期 2007-2-8
论坛徽章:20
开发板块每日发贴之星生肖徽章2007版:鼠生肖徽章2007版:鼠生肖徽章2007版:鼠生肖徽章2007版:鼠生肖徽章2007版:鼠
生肖徽章2007版:鼠生肖徽章2007版:鼠生肖徽章2007版:鼠生肖徽章2007版:鼠生肖徽章2007版:鼠生肖徽章2007版:鼠

发表于 2008-7-3 19:17 
这种情况需要在DAO的接口方法中进行详细的注释,VO对象也将限定前台开发人员能传递的参数范围,同样,根据DAO接口方法的功能介绍,前台开发人员也能够很容易的知道自己传递什么样的参数就应该会出来什么样的结果


只看该作者    顶部
 
    

相关内容


CopyRight 1999-2006 itpub.net All Right Reserved.
北京皓辰广域网络信息技术有限公司. 版权所有
E-mail:Webmaster@itpub.net
京ICP证:010037号 联系我们 法律顾问