- Mybatis是一个持久层的框架,是apache下的顶级项目。mybatis最先托管到googlecode下,再后来托管到github下(https://github.com/mybatis/mybatis-3/releases)。
- Mybatis 主要是由 log4j.properties 日志管理文件、SqlMapConfig.xml 数据源(数据库连接池,比如 C3P0)、事务(Spring 事务管理,如果不和 Spring整合,那么事务管理则是由 Mybatis 自己 实现)等运行环境的配置文件、映射器文件 mapper 三部分组成。
其中,SqlMapConfig文件实现内容与实现顺序如下:
1.定义数据库的属性,包括数据库的事务处理机制、数据库的名称、接口、密码、种类等;
2.数据库全局参数的配置,比如:开启二级缓存、开启延迟加载;
3.数据库中所需要使用的别名,此处可方便之后映射器中输入输出参数的书写,避免遇到 pojo 时,输入一长串路径名和类名(可以单个或者批量定义别名);
4.类型处理器,mybatis中通过typeHandlers完成jdbc类型和java类型的转换。通常情况下,mybatis提供的类型处理器满足日常需要,不需要自定义;
5.映射加载器,可以批量加载也可以通过类或者资源逐个加载。
代码示例:
(一)log4j 日志管理文件
# Global logging configuration
#在测试环境下日志类型设置成 debug,在生产环境下日志类型设置成 info或者error 类型
log4j.rootLogger=DEBUG, stdout
# Console output...
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%5p [%t] - %m%n
(二) SqlMapConfig 配置文件
1.定义数据库的属性,包括数据库的事务处理机制、数据库的名称、接口、密码、种类等;
2.数据库全局参数的配置,比如:开启二级缓存、开启延迟加载;
3.数据库中所需要使用的别名,此处可方便之后映射器中输入输出参数的书写,避免遇到 pojo 时,输入一长串路径名和类名(可以单个或者批量定义别名);
4.类型处理器,mybatis中通过typeHandlers完成jdbc类型和java类型的转换。通常情况下,mybatis提供的类型处理器满足日常需要,不需要自定义;
5.映射加载器,可以批量加载也可以通过类或者资源逐个加载。
详细如下:
1.配置数据库登录信息和事务管理
<!-- 加载属性文件 -->
<properties resource="db.properties">
<!--properties中还可以配置一些属性名和属性值 -->
<!-- <property name="jdbc.driver" value=""/> -->
</properties>
<!-- 此处使用 jdbc 管理数据库事务 -->
<!-- 和spring整合后 environments配置将废除-->
<environments default="development">
<environment id="development">
<!-- 使用jdbc事务管理,事务控制由mybatis-->
<transactionManager type="JDBC" />
<!-- 数据库连接池,由mybatis管理-->
<dataSource type="POOLED">
<property name="driver" value="${jdbc.driver}" />
<property name="url" value="${jdbc.url}" />
<property name="username" value="${jdbc.username}" />
<property name="password" value="${jdbc.password}" />
</dataSource>
</environment>
</environments>
2.配置全局参数(设置:二级缓存、是否延迟加载等)
<!-- 全局配置参数,需要时再设置 -->
<!-- <settings>
</settings> -->
3.别名的定义
<!-- 别名定义 -->
<typeAliases>
<!-- 针对单个别名定义
type:类型的路径
alias:别名
-->
<!-- <typeAlias type="cn.itcast.mybatis.po.User" alias="user"/> -->
<!-- 批量别名定义
指定包名,mybatis自动扫描包中的po类,自动定义别名,别名就是类名(首字母大写或小写都可以)
-->
<package name="cn.itcast.mybatis.po"/>
</typeAliases>
4.类型处理器(一般 Mybatis 部署的已经够用了)
5.映射器的编辑
<!-- 加载 映射文件 -->
<mappers>
<mapper resource="sqlmap/User.xml"/>
<!--通过resource方法一次加载一个映射文件 -->
<!-- <mapper resource="mapper/UserMapper.xml"/> -->
<!-- 通过mapper接口加载单个 映射文件
遵循一些规范:需要将mapper接口类名和mapper.xml映射文件名称保持一致,且在一个目录 中
上边规范的前提是:使用的是mapper代理方法
-->
<!-- <mapper class="cn.itcast.mybatis.mapper.UserMapper"/> -->
<!-- 批量加载mapper
指定mapper接口的包名,mybatis自动扫描包下边所有mapper接口进行加载
遵循一些规范:需要将mapper接口类名和mapper.xml映射文件名称保持一致,且在一个目录 中
上边规范的前提是:使用的是mapper代理方法
-->
<package name="cn.itcast.mybatis.mapper"/>
</mappers>
(三)映射器
代码示例
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<!-- namespace命名空间,作用就是对sql进行分类化管理,理解sql隔离
注意:使用mapper代理方法开发,namespace有特殊重要的作用
-->
<mapper namespace="test">
<!-- 在 映射文件中配置很多sql语句 -->
<!-- 需求:通过id查询用户表的记录 -->
<!-- 通过 select执行数据库查询
id:标识 映射文件中的 sql
将sql语句封装到mappedStatement对象中,所以将id称为statement的id
parameterType:指定输入 参数的类型,这里指定int型
#{}表示一个占位符号
#{id}:其中的id表示接收输入 的参数,参数名称就是id,如果输入 参数是简单类型,#{}中的参数名可以任意,可以value或其它名称
resultType:指定sql输出结果 的所映射的java对象类型,select指定resultType表示将单条记录映射成的java对象。
-->
<select id="findUserById" parameterType="int" resultType="cn.itcast.mybatis.po.User">
SELECT * FROM USER WHERE id=#{value}
</select>
<!-- 根据用户名称模糊查询用户信息,可能返回多条
resultType:指定就是单条记录所映射的java对象 类型
${}:表示拼接sql串,将接收到参数的内容不加任何修饰拼接在sql中。
使用${}拼接sql,引起 sql注入
${value}:接收输入 参数的内容,如果传入类型是简单类型,${}中只能使用value
-->
<select id="findUserByName" parameterType="java.lang.String" resultType="cn.itcast.mybatis.po.User">
SELECT * FROM USER WHERE username LIKE '%${value}%'
</select>
<!-- 添加用户
parameterType:指定输入 参数类型是pojo(包括 用户信息)
#{}中指定pojo的属性名,接收到pojo对象的属性值,mybatis通过OGNL获取对象的属性值
-->
<insert id="insertUser" parameterType="cn.itcast.mybatis.po.User">
<!--
将插入数据的主键返回,返回到user对象中
SELECT LAST_INSERT_ID():得到刚insert进去记录的主键值,只适用与自增主键
keyProperty:将查询到主键值设置到parameterType指定的对象的哪个属性
order:SELECT LAST_INSERT_ID()执行顺序,相对于insert语句来说它的执行顺序
resultType:指定SELECT LAST_INSERT_ID()的结果类型
-->
<selectKey keyProperty="id" order="AFTER" resultType="java.lang.Integer">
SELECT LAST_INSERT_ID()
</selectKey>
insert into user(username,birthday,sex,address) value(#{username},#{birthday},#{sex},#{address})
<!--
使用mysql的uuid()生成主键
执行过程:
首先通过uuid()得到主键,将主键设置到user对象的id属性中
其次在insert执行时,从user对象中取出id属性值
-->
<!-- <selectKey keyProperty="id" order="BEFORE" resultType="java.lang.String">
SELECT uuid()
</selectKey>
insert into user(id,username,birthday,sex,address) value(#{id},#{username},#{birthday},#{sex},#{address}) -->
</insert>
<!-- 删除 用户
根据id删除用户,需要输入 id值
-->
<delete id="deleteUser" parameterType="java.lang.Integer">
delete from user where id=#{id}
</delete>
<!-- 根据id更新用户
分析:
需要传入用户的id
需要传入用户的更新信息
parameterType指定user对象,包括 id和更新信息,注意:id必须存在
#{id}:从输入 user对象中获取id属性值
-->
<update id="updateUser" parameterType="cn.itcast.mybatis.po.User">
update user set username=#{username},birthday=#{birthday},sex=#{sex},address=#{address}
where id=#{id}
</update>
</mapper>
- 输入输出映射
输入映射:在查询条件包含需要使用某一类对象的多个属性时,可以构建一个“对象工厂类”,类中包含对象以及对象的 set、get 方法。实现 mapper 的配置和类文件的数据库操作。
输出映射:在查询结果筛选某些对象的属性而不是直接返回对象时,需要对查询结果进行处理,而这时需要进行查询结果的有效获取,因此,需要将SQL查询结果的字段与JAVA类属性相匹配。实现匹配的方法就是输出映射所要做的事情。这里主要是通过 resultMap 文件,实现字段的映射。其中,id 标签对应的字段是唯一标识的字段,result 对应的字段是普通字段。
- 多个查询中都包含相似的条件查询时,可以用 sql 便签封装好查询字段,实现查询条件的拼接。
- 查询条件是list、数组类型,foreach 解决有多个同类查询条件。