MyBatis 的真正强大在于它的映射语句,也是它的魔力所在。由于它的异常强大,映射器的 XML 文件就显得相对简单。如果拿它跟具有相同功能的 JDBC 代码进行对比,你会立即发现省掉了将近 95% 的代码。MyBatis 就是针对 SQL 构建的,并且比普通的方法做的更好。
参考: Mybatis官方文档
主要元素如图所示:
<select id="findCustomerById" parameterType="Integer"
resultType="com.wang.po.Customer">
select*from t_customer where id=#{id}
select>
String sql = "select * from t_customer where id=?";
PreparedStatement ps = conn.prepareStatement(sql);
ps.setInt(1,id);
属性 | 说明 |
---|---|
id | 在命名空间中唯一的标识符,可以被用来引用这条语句。 |
parameterType | 将会传入这条语句的参数类的完全限定名或别名。这个属性是可选的,因为 MyBatis 可以通过 TypeHandler 推断出具体传入语句的参数,默认值为 unset。 |
resultType | 从这条语句中返回的期望类型的类的完全限定名或别名。注意如果是集合情形,那应该是集合可以包含的类型,而不能是集合本身。使用 resultType 或 resultMap,但不能同时使用。 |
resultMap | 外部 resultMap 的命名引用。结果集的映射是 MyBatis 最强大的特性,对其有一个很好的理解的话,许多复杂映射的情形都能迎刃而解。使用 resultMap 或 resultType,但不能同时使用。 |
flushCache | 将其设置为 true,任何时候只要语句被调用,都会导致本地缓存和二级缓存都会被清空,默认值:false。 |
useCache | 将其设置为 true,将会导致本条语句的结果被二级缓存,默认值:对 select 元素为 true。 |
timeout | 这个设置是在抛出异常之前,驱动程序等待数据库返回请求结果的秒数。默认值为 unset(依赖驱动)。 |
fetchSize | 这是尝试影响驱动程序每次批量返回的结果行数和这个设置值相等。默认值为 unset(依赖驱动)。 |
statementType | STATEMENT,PREPARED 或 CALLABLE 的一个。这会让 MyBatis 分别使用 Statement,PreparedStatement 或 CallableStatement,默认值:PREPARED。 |
resultSetType | FORWARD_ONLY,SCROLL_SENSITIVE 或 SCROLL_INSENSITIVE 中的一个,默认值为 unset (依赖驱动)。 |
databaseId | 如果配置了 databaseIdProvider,MyBatis 会加载所有的不带 databaseId 或匹配当前 databaseId 的语句;如果带或者不带的语句都有,则不带的会被忽略。 |
resultOrdered | 这个设置仅针对嵌套结果 select 语句适用:如果为 true,就是假设包含了嵌套结果集或是分组了,这样的话当返回一个主结果行的时候,就不会发生有对前面结果集的引用的情况。这就使得在获取嵌套的结果集的时候不至于导致内存不够用。默认值:false。 |
resultSets | 这个设置仅对多结果集的情况适用,它将列出语句执行后返回的结果集并每个结果集给一个名称,名称是逗号分隔的。 |
id="addCustomer"
parameterType="com.wang.po.Customer"
flushCache="true"
statementType="PREPARED"
keyProperty=""
keyColumn=""
useGeneratedKeys=""
timeout="20">
比如:
insert into
t_customer(username,jobs,phone)values(#{username},
#{jobs},#{phone})
属性 | 说明 |
---|---|
useGeneratedKeys | (仅对 insert 和 update 有用)这会令 MyBatis 使用 JDBC 的 getGeneratedKeys 方法来取出由数据库内部生成的主键(比如:像 MySQL 和 SQL Server 这样的关系数据库管理系统的自动递增字段),默认值:false。 |
keyProperty | 仅对 insert 和 update 有用)唯一标记一个属性,MyBatis 会通过 getGeneratedKeys 的返回值或者通过 insert 语句的 selectKey 子元素设置它的键值,默认:unset。如果希望得到多个生成的列,也可以是逗号分隔的属性名称列表。 |
keyColumn | (仅对 insert 和 update 有用)通过生成的键值设置表中的列名,这个设置仅在某些数据库(像 PostgreSQL)是必须的,当主键列不是表中的第一列的时候需要设置。如果希望得到多个生成的列,也可以是逗号分隔的属性名称列表。 |
面试题:如何获取自动生成的(主)键值?
id="addCustomer" parameterType="com.wang.po.Customer"
keyProperty="id" useGeneratedKeys="true">
insert into
t_customer(username,jobs,phone)values(#{username},
#{jobs},#{phone})
id="updateCustomer"
parameterType="com.wang.po.Customer"
flushCache="true"
statementType="PREPARED"
timeout="20">
比如:
update t_customer set
username=#{username},jobs=#{jobs}
,phone=#{phone} where id=#{id}
id="deleteCustomer"
parameterType="com.wang.po.Customer"
flushCache="true"
statementType="PREPARED"
timeout="20">
比如:
<delete id="deleteCustomer" parameterType="Integer">
delete from t_customer
where id=#{id}
delete>
属性 | 说明 |
---|---|
id | 命名空间中的唯一标识符,可被用来代表这条语句。 |
parameterType | 将要传入语句的参数的完全限定类名或别名。这个属性是可选的,因为 MyBatis 可以通过 TypeHandler 推断出具体传入语句的参数,默认值为 unset。 |
flushCache | 将其设置为 true,任何时候只要语句被调用,都会导致本地缓存和二级缓存都会被清空,默认值:true(对应插入、更新和删除语句)。 |
timeout | 这个设置是在抛出异常之前,驱动程序等待数据库返回请求结果的秒数。默认值为 unset(依赖驱动)。 |
statementType | STATEMENT,PREPARED 或 CALLABLE 的一个。这会让 MyBatis 分别使用 Statement,PreparedStatement 或 CallableStatement,默认值:PREPARED。 |
useGeneratedKeys | (仅对 insert 和 update 有用)这会令 MyBatis 使用 JDBC 的 getGeneratedKeys 方法来取出由数据库内部生成的主键(比如:像 MySQL 和 SQL Server 这样的关系数据库管理系统的自动递增字段),默认值:false。 |
keyProperty | 仅对 insert 和 update 有用)唯一标记一个属性,MyBatis 会通过 getGeneratedKeys 的返回值或者通过 insert 语句的 selectKey 子元素设置它的键值,默认:unset。如果希望得到多个生成的列,也可以是逗号分隔的属性名称列表。 |
keyColumn | (仅对 insert 和 update 有用)通过生成的键值设置表中的列名,这个设置仅在某些数据库(像 PostgreSQL)是必须的,当主键列不是表中的第一列的时候需要设置。如果希望得到多个生成的列,也可以是逗号分隔的属性名称列表。 |
databaseId | 如果配置了 databaseIdProvider,MyBatis 会加载所有的不带 databaseId 或匹配当前 databaseId 的语句;如果带或者不带的语句都有,则不带的会被忽略。 |
01.定义一个公共使用的多个字段
<sql id="customerColumns">username,jobs,phone sql>
02.比如在
<select id="findCustomerById" parameterType="Integer"
resultType="com.wang.po.Customer">
select id,<include refid="customerColumns"/> from t_customer where id=#{id}
select>
<select id="findCustomerById" parameterType="Integer"
resultType="com.wang.po.Customer">
select <include refid="customerColumns"/> from t_customer where id=#{id}
select>
<resultMap type="" id="">
<constructor>
<idArg />
<arg />
constructor>
<id />
<result />
<association property="" />
<collection property=""/>
<discriminator javaType="">
<case value="">case>
discriminator>
resultMap>
数据表的字段于User属性不一致,如果不加以处理从数据库查询出来的数据无法封装到User对象中去
,那么查询返回的结果都是null
第1种方法: 通过在查询的sql语句中定义字段名的别名,让字段名的别名和实体类的属性名一致
<select id="findAllUsers" resultType="com.wang.po.User">
select t_id id , t_name name ,t_age age from t_user
select>
第2种方法: 通过<resultMap>来映射字段名和实体类属性名的一一对应的关系
<resultMap type="com.wang.po.User" id="resultMap">
<id property="id" column="t_id" />
<result property="name" column="t_name" />
<result property="age" column="t_age" />
resultMap>
<select id="findAllUsers" resultMap="resultMap">
select*from t_user
select>
不同的Xml映射文件,如果配置了namespace,那么id可以重复;如果没有配置namespace,
那么id不能重复;毕竟namespace不是必须的,只是最佳实践而已。
原因就是namespace+id是作为Map<String, MappedStatement>的key使用的,如果没有
namespace,就剩下id,那么,id重复会导致数据互相覆盖。有了namespace,自然id就可
以重复,namespace不同,namespace+id自然也就不同。