mysql语⾔的注释符_MybatisSQL映射语句中参数注释规则最近在*Mybatis*的学习中对于映射语句中的参数注释设置有点犯迷糊,于是在*debug*下跟踪了下源代码,发现*Mybatis*在接⼝⽅法映射语句中会做如下处理:
1. 接⼝⽅法只有⼀个参数
1.1 不使⽤`@Param`注解
1.1.1 参数为基本类型或为基本包装类型(int,)
参数注释为: #{任意字符}
1.1.2 参数为⾃定义对象
参数注释为: #{对象属性}
⽰例:
User getUserById(int id);
// 注:该中情况下'任意字符'不能为空,否则报错
// select * from where id = #{任意字符}
select * from
User getUser(User user); // Age
select * from
1.2 使⽤`@Param`注解
1.2.1 参数为基本类型或为基本包装类型(int,)
参数注释为: #{注解名称} | #{param1}
1.2.2 参数为⾃定义对象
参数注释为: #{注解名称.对象属性} | #{param1.对象属性}
⽰例:
User getUserById(@Param(value="keyId") int id);
select * from where id = #{keyId}
// or
select * from
User getUser(@Param(value="usr") User user); // Age
param nameselect * from
// or
select * from
2. 接⼝⽅法有两个及两个以上参数
2.1 不使⽤`@Param`注解
2.1.1 参数为基本类型或为基本包装类型(int,)
参数注释为: #{参数位置[0..n-1]} | #{]}
2.1.2 参数为⾃定义对象
参数注释为: #{参数位置[0..n-1].对象属性} | #{].对象属性}
⽰例:
User getUser(String name, int age);
select * from
// or
select * from
User getUser(User usr, int flag);
select * from
// or
select * from
2.2 使⽤`@Param`注解
2.2.1 参数为基本类型或为基本包装类型(int,)
参数注释为: #{注解名称} | #{]}
2.2.2 参数为⾃定义对象
参数注释为: #{注解名称.对象属性} | #{].对象属性}
⽰例:
User getUser(@Param(value="xm") String name, @Param(value="nl") int age);
select * from
// or
select * from
// or
select * from
User getUser(@Param(value="usr") User user, @Param(value="tag") int flag); select * from
// or
select * from
// or
select * from
2.2.3 部分参数使⽤`@Param`注解
当采⽤部分参数使⽤`@Param`注解时,参数注释为将以上两种情况结合起来即可。⽰例:
User getUser(String name, @Param(value="nl") age, int gendar);
// 对于age的访问不能是 #{1} 只能是 #{param2} | #{nl}
select * from
总结下
`@Param`的作⽤是设置参数别名。设置后的参数只能通过`#{]`或者`#{注解别名}`来访问
多个参数情况下,均可使⽤ `#{参数位置[0..n-1]}` |`#{]}`来访问参数
最后给出⼏个源代码中关于参数设置的源代码供⼤家参考:
参数获取操作:org.apache.ibatis.Param(Object[] args)
private Object getParam(Object[] args) {
final int paramCount = paramPositions.size();
// ⽆参数
if (args == null || paramCount == 0) {
return null;
// ⽆注解并参数个数为1
} else if (!hasNamedParameters && paramCount == 1) {
return (0)];
} else {
Map param = new MapperParamMap();
for (int i = 0; i < paramCount; i++) {
param.(i), (i)]);
}
// issue #71, add param names as param1, but ensure backward compatibility
// 这就是 #{]} 的来源
for (int i = 0; i < paramCount; i++) {
String genericParamName = "param" + String.valueOf(i + 1);
if (!ainsKey(genericParamName)) {
param.put(genericParamName, (i)]);
}
}
return param;
}
}
SQL预编译参数设置:org.utor.parameter.DefaultParameterHandler.setParameters(PreparedStatement ps) throws SQLException
org.utor.parameter.DefaultParameterHandler.setParameters(PreparedStatement ps) throws SQLException
public void setParameters(PreparedStatement ps)
throws SQLException {
ErrorContext.instance().activity("setting parameters").ParameterMap().getId());
List parameterMappings = ParameterMappings();
if (parameterMappings != null) {
MetaObject metaObject = parameterObject == null ? null : wMetaObject(parameterObject);
for (int i = 0; i < parameterMappings.size(); i++) {
ParameterMapping parameterMapping = (i);
if (Mode() != ParameterMode.OUT) {
Object value;
String propertyName = Property();
PropertyTokenizer prop = new PropertyTokenizer(propertyName);
if (parameterObject == null) {
value = null;
} else if (typeHandlerRegistry.Class())) {
value = parameterObject;
} else if (boundSql.hasAdditionalParameter(propertyName)) {
value = AdditionalParameter(propertyName);
} else if (propertyName.startsWith(ForEachSqlNode.ITEM_PREFIX)
&& boundSql.Name())) {
value = Name());
if (value != null) {
value = wMetaObject(value).getValue(propertyName.Name().length()));
}
} else {
value = metaObject == null ? null : Value(propertyName);
}
TypeHandler typeHandler = TypeHandler();
if (typeHandler == null) {
throw new ExecutorException("There was no TypeHandler found for parameter " + propertyName + " of statement " + Id());
}
JdbcType jdbcType = JdbcType();
if (value == null && jdbcType == null) jdbcType = JdbcTypeForNull();
typeHandler.setParameter(ps, i + 1, value, jdbcType);
} } } }
版权声明:本站内容均来自互联网,仅供演示用,请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198,我们将在24小时内删除。
发表评论