隔了一段时间,将之前所学习的SSH整合了一段时间,然后也通过一些项目锻炼了一下自己的编码能力,现在终于有时间来写写最近学习的内容了,那么言归正传,今天我们要来讲讲的就是MyBatis框架,由于我本人也是一个学习的过程,所以讲解的东西可能偏向于入门级,所以大神们路过看看就行,不要吐槽我讲的简单,毕竟每个人都是从懵懂走向成熟的,爱你们哟~
MyBatis 本是apache的一个开源项目iBatis, 2010年这个项目由apache software foundation 迁移到了google code,并且改名为MyBatis 。2013年11月迁移到Github。
MyBatis是一个优秀的持久层框架,它对jdbc的操作数据库的过程进行封装,使开发者只需要关注 SQL 本身,而不需要花费精力去处理例如注册驱动、创建connection、创建statement、手动设置参数、结果集检索等jdbc繁杂的过程代码。
Mybatis通过xml或注解的方式将要执行的各种statement(statement、preparedStatement、CallableStatement)配置起来,并通过java对象和statement中的sql进行映射生成最终执行的sql语句,最后由mybatis框架执行sql并将结果映射成java对象并返回。
1、mybatis配置
SqlMapConfig.xml,此文件作为mybatis的全局配置文件,配置了mybatis的运行环境等信息。
mapper.xml文件即sql映射文件,文件中配置了操作数据库的sql语句。此文件需要在SqlMapConfig.xml中加载。
2、通过mybatis环境等配置信息构造SqlSessionFactory即会话工厂
3、由会话工厂创建sqlSession即会话,操作数据库需要通过sqlSession进行。
4、mybatis底层自定义了Executor执行器接口操作数据库,Executor接口有两个实现,一个是基本执行器、一个是缓存执行器。
5、Mapped Statement也是mybatis一个底层封装对象,它包装了mybatis配置信息及sql映射信息等。mapper.xml文件中一个sql对应一个Mapped Statement对象,sql的id即是Mapped statement的id。
6、Mapped Statement对sql执行输入参数进行定义,包括HashMap、基本类型、pojo,Executor通过Mapped Statement在执行sql前将输入的java对象映射至sql中,输入参数映射就是jdbc编程中对preparedStatement设置参数。
7、Mapped Statement对sql执行输出结果进行定义,包括HashMap、基本类型、pojo,Executor通过Mapped Statement在执行sql后将输出结果映射至java对象中,输出结果映射过程相当于jdbc编程中对结果的解析处理过程。
mybaits的代码由github.com管理,地址:https://github.com/mybatis/mybatis-3/releases
mybatis-3.2.7.jar—-mybatis的核心包
lib—-mybatis的依赖包
mybatis-3.2.7.pdf—-mybatis使用手册
实现以下功能:
根据用户id查询一个用户信息
根据用户名称模糊查询用户信息列表
添加用户
更新用户
删除用户
3.1 我们新建一个java工程,jdk使用1.7版本,如果你是使用导入jar包的形式开发的话,那新建一个lib文件夹,并导入以下jar包:
然后全部选中所有jar包,右键build path构建一下即可。
如果你是使用maven构建工程的话,那就对应在pom.xml文件中添加对应依赖即可,这里不做说明。
3.2 在classpath下的config文件夹下创建log4j.properties如下:
- # Global logging configuration
- 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
mybatis默认使用log4j作为输出日志信息。
3.3 在classpath下的config文件夹下创建SqlMapConfig.xml,当前文件是我已经整合好了的,代码如下:
- <?xml version="1.0" encoding="UTF-8" ?>
- <!DOCTYPE configuration
- PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
- "http://mybatis.org/dtd/mybatis-3-config.dtd">
- <configuration>
- <!-- 和spring整合后 environments配置将废除-->
- <environments default="development">
- <environment id="development">
- <!-- 使用jdbc事务管理-->
- <transactionManager type="JDBC" />
- <!-- 数据库连接池-->
- <dataSource type="POOLED">
- <
- property
- name
- =
- "driver"
- value
- =
- "com.mysql.jdbc.Driver"
- />
- <
- property
- name
- =
- "url"
- value
- =
- "jdbc:mysql://localhost:3306/mybatis?characterEncoding=utf-8"
- />
- <
- property
- name
- =
- "username"
- value
- =
- "root"
- />
- <
- property
- name
- =
- "password"
- value
- =
- "root"
- />
- </dataSource>
- </environment>
- </environments>
- </configuration>
SqlMapConfig.xml是mybatis核心配置文件,上边文件的配置内容为数据源、事务管理。
3.4 Po类作为mybatis进行sql映射使用,po类通常与数据库表对应,User.java如下:
- public class User {
- private int id;
- private String username; // 用户姓名
- private String sex; // 性别
- private Date birthday; // 生日
- private String address; // 地址
- public int getId() {
- return id;
- }
- public void setId(int id) {
- this.id = id;
- }
- public String getUsername() {
- return username;
- }
- public void setUsername(String username) {
- this.username = username;
- }
- public String getSex() {
- return sex;
- }
- public void setSex(String sex) {
- this.sex = sex;
- }
- public Date getBirthday() {
- return birthday;
- }
- public void setBirthday(Date birthday) {
- this.birthday = birthday;
- }
- public String getAddress() {
- return address;
- }
- public void setAddress(String address) {
- this.address = address;
- }
- @Override public String toString() {
- return "User [id=" + id + ", username=" + username + ", sex=" + sex + ", birthday=" + birthday + ", address=" + address + "]";
- }
- }
3.5 在classpath下的config目录下创建sql映射文件Users.xml:
- <?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">
- <mapper namespace="test">
- </mapper>
namespace :命名空间,用于隔离sql语句,后面会讲另一层非常重要的作用。
3.6 mybatis框架需要加载映射文件,将Users.xml添加在SqlMapConfig.xml,如下:
- <mappers>
- <mapper resource="sqlmap/User.xml" />
- </mappers>
4.1.1 在user.xml中添加:
- <!-- 根据id获取用户信息 -->
- <
- select
- id
- =
- "findUserById"
- parameterType
- =
- "int"
- resultType
- =
- "cn.zy.mybatis.po.User"
- >
- select * from user where id = #{id}
- </select>
parameterType:定义输入到sql中的映射类型,#{id}表示使用preparedstatement设置占位符号并将输入变量id传到sql。
resultType:定义结果映射类型。
4.1.2 测试程序
- public class Mybatis_first {
- //会话工厂
- private SqlSessionFactory sqlSessionFactory;
- //注解,会在程序运行之前执行,用于初始化
- @Before public void createSqlSessionFactory() throws IOException {
- // 配置文件
- String resource = "SqlMapConfig.xml";
- InputStream inputStream = Resources.getResourceAsStream(resource);
- // 使用SqlSessionFactoryBuilder从xml配置文件中创建SqlSessionFactory
- sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
- }
- // 根据 id查询用户信息
- @Test public void testFindUserById() {
- // 数据库会话实例
- SqlSession sqlSession = null;
- try {
- // 创建数据库会话实例sqlSession
- sqlSession = sqlSessionFactory.openSession();
- // 查询单个记录,根据用户id查询用户信息
- User user = sqlSession.selectOne("test.findUserById", 10);
- // 输出用户信息
- System.out.println(user);
- } catch(Exception e) {
- e.printStackTrace();
- } finally {
- if (sqlSession != null) {
- sqlSession.close();
- }
- }
- }
- }
说明:对以上代码进行讲解一下,例如这行代码:
User user = sqlSession.selectOne(“test.findUserById”, 10);
还记得我们之前在映射文件User.xml文件设置的命名空间叫做test吗?并且我们在User.xml文件中添加了一个id为findUserById的标签,那么这里就是mybatis的使用方法了,通过命名空间.id名即可执行对应的sql语句,并在第二个参数中将我们想要查询的参数传递过去即可,就能得到我们想要的结果。
4.2.1 继续在user.xml中添加:
- <!-- 自定义条件查询用户列表 -->
- <select id="findUserByUsername" parameterType="java.lang.String"
- resultType="cn.itcast.mybatis.po.User">
- select * from user where username like '%${value}%'
- </select>
parameterType:定义输入到sql中的映射类型,${value}表示使用参数将${value}替换,做字符串的拼接。
注意:如果是取简单数量类型的参数,括号中的值必须为value
resultType:定义结果映射类型。
4.2.2 测试程序
- // 根据用户名称模糊查询用户信息
- @Test public void testFindUserByUsername() {
- // 数据库会话实例
- SqlSession sqlSession = null;
- try {
- // 创建数据库会话实例sqlSession
- sqlSession = sqlSessionFactory.openSession();
- // 查询单个记录,根据用户id查询用户信息
- List < User > list = sqlSession.selectList("test.findUserByUsername", "张");
- System.out.println(list.size());
- } catch(Exception e) {
- e.printStackTrace();
- } finally {
- if (sqlSession != null) {
- sqlSession.close();
- }
- }
- }
4.3.1 #{}和${}的区别
#{}表示一个占位符号,通过#{}可以实现preparedStatement向占位符中设置值,自动进行java类型和jdbc类型转换,#{}可以有效防止sql注入。 #{}可以接收简单类型值或pojo属性值。 如果parameterType传输单个简单类型值,#{}括号中可以是value或其它名称。
${}表示拼接sql串,通过${}可以将parameterType 传入的内容拼接在sql中且不进行jdbc类型转换,${}可以接收简单类型值或pojo属性值,如果parameterType传输单个简单类型值,${}括号中只能是value。
4.3.2 parameterType和resultType
parameterType:指定输入参数类型,mybatis通过ognl从输入对象中获取参数值拼接在sql中。
resultType:指定输出结果类型,mybatis将sql查询结果的一行记录数据映射为resultType指定类型的对象。
4.3.3 selectOne和selectList
selectOne查询一条记录,如果使用selectOne查询多条记录则抛出异常:
- org.apache.ibatis.exceptions.TooManyResultsException: Expected one result(or null) to be returned by selectOne(),
- but found: 3 at org.apache.ibatis.session.defaults.DefaultSqlSession.selectOne(DefaultSqlSession.java: 70)
selectList可以查询一条或多条记录。
4.4.1 继续在user.xml中添加:
- <!-- 添加用户 -->
- <
- insert
- id
- =
- "insertUser"
- parameterType
- =
- "cn.itcast.mybatis.po.User"
- >
- insert into user(username,birthday,sex,address)
- values(#{username},#{birthday},#{sex},#{address})
- </insert>
4.4.2 测试程序
- // 添加用户信息
- @Test public void testInsert() {
- // 数据库会话实例
- SqlSession sqlSession = null;
- try {
- // 创建数据库会话实例sqlSession
- sqlSession = sqlSessionFactory.openSession();
- // 添加用户信息
- User user = new User();
- user.setUsername("张小明");
- user.setAddress("河南郑州");
- user.setSex("1");
- user.setPrice(1999.9f);
- sqlSession.insert("test.insertUser", user);
- //提交事务
- sqlSession.commit();
- } catch(Exception e) {
- e.printStackTrace();
- } finally {
- if (sqlSession != null) {
- sqlSession.close();
- }
- }
- }
4.4.3 通过修改user.xml映射文件,可以将mysql自增主键返回:
- <
- insert
- id
- =
- "insertUser"
- parameterType
- =
- "cn.itcast.mybatis.po.User"
- >
- <!-- selectKey将主键返回,需要再返回 -->
- <
- selectKey
- keyProperty
- =
- "id"
- order
- =
- "AFTER"
- resultType
- =
- "java.lang.Integer"
- >
- select LAST_INSERT_ID()
- </selectKey>
- insert into user(username,birthday,sex,address)
- values(#{username},#{birthday},#{sex},#{address});
- </insert>
添加selectKey实现将主键返回:
keyProperty:返回的主键存储在pojo中的哪个属性
order:selectKey的执行顺序,是相对与insert语句来说,由于mysql的自增原理执行完insert语句之后才将主键生成,所以这里selectKey的执行顺序为after
resultType:返回的主键是什么类型
LAST_INSERT_ID():是mysql的函数,返回auto_increment自增列新记录id值。
4.4.4 Mysql使用 uuid实现主键
需要增加通过select uuid()得到uuid值
- <insert id="insertUser" parameterType="cn.itcast.mybatis.po.User">
- <selectKey resultType="java.lang.String" order="BEFORE"
- keyProperty="id">
- select uuid()
- </selectKey>
- insert into user(id,username,birthday,sex,address)
- values(#{id},#{username},#{birthday},#{sex},#{address})
- </insert>
注意这里使用的order是“BEFORE”
4.5.1 继续在user.xml中添加:
- <!-- 删除用户 -->
- <
- delete
- id
- =
- "deleteUserById"
- parameterType
- =
- "int"
- >
- delete from user where id=#{id}
- </delete>
4.5.2 测试程序
- // 根据id删除用户
- @Test public void testDelete() {
- // 数据库会话实例
- SqlSession sqlSession = null;
- try {
- // 创建数据库会话实例sqlSession
- sqlSession = sqlSessionFactory.openSession();
- // 删除用户
- sqlSession.delete("test.deleteUserById", 18);
- // 提交事务
- sqlSession.commit();
- } catch(Exception e) {
- e.printStackTrace();
- } finally {
- if (sqlSession != null) {
- sqlSession.close();
- }
- }
- }
4.6.1 继续在user.xml中添加:
- <!-- 更新用户 -->
- <
- update
- id
- =
- "updateUser"
- parameterType
- =
- "cn.itcast.mybatis.po.User"
- >
- update user set username=#{username},birthday=#{birthday},sex=#{sex},address=#{address}
- where id=#{id}
- </update>
4.6.2 测试程序
- // 更新用户信息
- @Test public void testUpdate() {
- // 数据库会话实例
- SqlSession sqlSession = null;
- try {
- // 创建数据库会话实例sqlSession
- sqlSession = sqlSessionFactory.openSession();
- // 添加用户信息
- User user = new User();
- user.setId(16);
- user.setUsername("张小明");
- user.setAddress("河南郑州");
- user.setSex("1");
- user.setPrice(1999.9f);
- sqlSession.update("test.updateUser", user);
- // 提交事务
- sqlSession.commit();
- } catch(Exception e) {
- e.printStackTrace();
- } finally {
- if (sqlSession != null) {
- sqlSession.close();
- }
- }
- }
1、数据库链接创建、释放频繁造成系统资源浪费从而影响系统性能,如果使用数据库链接池可解决此问题。
解决:在SqlMapConfig.xml中配置数据链接池,使用连接池管理数据库链接。
2、Sql语句写在代码中造成代码不易维护,实际应用sql变化的可能较大,sql变动需要改变java代码。
解决:将Sql语句配置在XXXXmapper.xml文件中与java代码分离。
3、向sql语句传参数麻烦,因为sql语句的where条件不一定,可能多也可能少,占位符需要和参数一一对应。
解决:Mybatis自动将java对象映射至sql语句,通过statement中的parameterType定义输入参数的类型。
4、对结果集解析麻烦,sql变化导致解析代码变化,且解析前需要遍历,如果能将数据库记录封装成pojo对象解析比较方便。
解决:Mybatis自动将sql执行结果映射至java对象,通过statement中的resultType定义输出结果的类型。
Mybatis和hibernate不同,它不完全是一个ORM框架,因为MyBatis需要程序员自己编写Sql语句,不过mybatis可以通过XML或注解方式灵活配置要运行的sql语句,并将java对象和sql语句映射生成最终执行的sql,最后将sql执行的结果再映射生成java对象。
Mybatis学习门槛低,简单易学,程序员直接编写原生态sql,可严格控制sql执行性能,灵活度高,非常适合对关系数据模型要求不高的软件开发,例如互联网软件、企业运营类软件等,因为这类软件需求变化频繁,一但需求变化要求成果输出迅速。但是灵活的前提是mybatis无法做到数据库无关性,如果需要实现支持多种数据库的软件则需要自定义多套sql映射文件,工作量大。
Hibernate对象/关系映射能力强,数据库无关性好,对于关系模型要求高的软件(例如需求固定的定制化软件)如果用hibernate开发可以节省很多代码,提高效率。但是Hibernate的学习门槛高,要精通门槛更高,而且怎么设计O/R映射,在性能和对象模型之间如何权衡,以及怎样用好Hibernate需要具有很强的经验和能力才行。
总之,按照用户的需求在有限的资源环境下只要能做出维护性、扩展性良好的软件架构都是好架构,所以框架只有适合才是最好。
使用Mybatis开发Dao,通常有两个方法,即原始Dao开发方法和Mapper接口开发方法。
将下边的功能实现Dao:
根据用户id查询一个用户信息
根据用户名称模糊查询用户信息列表
添加用户信息
SqlSession中封装了对数据库的操作,如:查询、插入、更新、删除等。
通过SqlSessionFactory创建SqlSession,而SqlSessionFactory是通过SqlSessionFactoryBuilder进行创建。
SqlSessionFactoryBuilder用于创建SqlSessionFacoty,SqlSessionFacoty一旦创建完成就不需要SqlSessionFactoryBuilder了,因为SqlSession是通过SqlSessionFactory生产,所以可以将SqlSessionFactoryBuilder当成一个工具类使用,最佳使用范围是方法范围即方法体内局部变量。
SqlSessionFactory是一个接口,接口中定义了openSession的不同重载方法,SqlSessionFactory的最佳使用范围是整个应用运行期间,一旦创建后可以重复使用,通常以单例模式管理SqlSessionFactory。
SqlSession是一个面向用户的接口, sqlSession中定义了数据库操作方法。
每个线程都应该有它自己的SqlSession实例。SqlSession的实例不能共享使用,它也是线程不安全的。因此最佳的范围是请求或方法范围。绝对不能将SqlSession实例的引用放在一个类的静态字段或实例字段中。
打开一个 SqlSession;使用完毕就要关闭它。通常把这个关闭操作放到 finally 块中以确保每次都能执行关闭。如下:
- SqlSession session = sqlSessionFactory.openSession();
- try {
- // do work
- } finally {
- session.close();
- }
原始Dao开发方法需要程序员编写Dao接口和Dao实现类。
- <?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">
- <mapper namespace="test">
- <!-- 根据id获取用户信息 -->
- <
- select
- id
- =
- "findUserById"
- parameterType
- =
- "int"
- resultType
- =
- "cn.itcast.mybatis.po.User"
- >
- select * from user where id = #{id}
- </select>
- <!-- 添加用户 -->
- <
- insert
- id
- =
- "insertUser"
- parameterType
- =
- "cn.itcast.mybatis.po.User"
- >
- <
- selectKey
- keyProperty
- =
- "id"
- order
- =
- "AFTER"
- resultType
- =
- "java.lang.Integer"
- >
- select LAST_INSERT_ID()
- </selectKey>
- insert into user(username,birthday,sex,address)
- values(#{username},#{birthday},#{sex},#{address})
- </insert>
- </mapper>
- Public interface UserDao {
- public User getUserById(int id) throws Exception;
- public void insertUser(User user) throws Exception;
- }
- Public
- class
- UserDaoImpl
- implements
- UserDao
- {
- //注入SqlSessionFactory
- public UserDaoImpl(SqlSessionFactory sqlSessionFactory){
- this.setSqlSessionFactory(sqlSessionFactory);
- }
- private SqlSessionFactory sqlSessionFactory;
- @Override
- public User getUserById(int id) throws Exception {
- SqlSession session = sqlSessionFactory.openSession();
- User user = null;
- try {
- //通过sqlsession调用selectOne方法获取一条结果集
- //参数1:指定定义的statement的id,参数2:指定向statement中传递的参数
- user = session.selectOne("test.findUserById", 1);
- System.out.println(user);
- } finally{
- session.close();
- }
- return user;
- }
- @Override
- Public void insertUser(User user) throws Exception {
- SqlSession sqlSession = sqlSessionFactory.openSession();
- try {
- sqlSession.insert("insertUser", user);
- sqlSession.commit();
- } finally{
- session.close();
- }
- }
- }
创建一个JUnit的测试类,对UserDao进行测试。
- private SqlSessionFactory sqlSessionFactory;
- @Before
- public void init() throws Exception {
- SqlSessionFactoryBuilder sessionFactoryBuilder = new SqlSessionFactoryBuilder();
- InputStream inputStream = Resources.getResourceAsStream("SqlMapConfig.xml");
- sqlSessionFactory = sessionFactoryBuilder.build(inputStream);
- }
- @Test
- public void testGetUserById() {
- UserDao userDao = new UserDaoImpl(sqlSessionFactory);
- User user = userDao.getUserById(22);
- System.out.println(user);
- }
Mapper接口开发方法只需要程序员编写Mapper接口(相当于Dao接口),由Mybatis框架根据接口定义创建接口的动态代理对象,代理对象的方法体同上边Dao接口实现类方法。
Mapper接口开发需要遵循以下规范:
1、Mapper.xml文件中的namespace与mapper接口的类路径相同。
2、 Mapper接口方法名和Mapper.xml中定义的每个statement的id相同
3、Mapper接口方法的输入参数类型和mapper.xml中定义的每个sql 的parameterType的类型相同
4、Mapper接口方法的输出参数类型和mapper.xml中定义的每个sql的resultType的类型相同
定义mapper映射文件UserMapper.xml(内容同Users.xml),需要修改namespace的值为 UserMapper接口路径。将UserMapper.xml放在classpath 下mapper目录 下。
- <?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">
- <!--
- mapper接口代理实现编写规则:
- 1. 映射文件中namespace要等于接口的全路径名称
- 2. 映射文件中sql语句id要等于接口的方法名称
- 3. 映射文件中传入参数类型要等于接口方法的传入参数类型
- 4. 映射文件中返回结果集类型要等于接口方法的返回值类型
- -->
- <mapper namespace="cn.zy.mapper.UserMapper">
- <!--
- id:sql语句唯一标识
- parameterType:指定传入参数类型
- resultType:返回结果集类型
- #{}占位符:起到占位作用,如果传入的是基本类型(string,long,double,int,boolean,float等),那么#{}中的变量名称可以随意写.
- -->
- <
- select
- id
- =
- "findUserById"
- parameterType
- =
- "int"
- resultType
- =
- "cn.itheima.pojo.User"
- >
- select * from user where id=#{id}
- </select>
- <!--
- 如果返回结果为集合,可以调用selectList方法,这个方法返回的结果就是一个集合,所以映射文件中应该配置成集合泛型的类型
- ${}拼接符:字符串原样拼接,如果传入的参数是基本类型(string,long,double,int,boolean,float等),那么${}中的变量名称必须是value
- 注意:拼接符有sql注入的风险,所以慎重使用
- -->
- <
- select
- id
- =
- "findUserByUserName"
- parameterType
- =
- "string"
- resultType
- =
- "user"
- >
- select * from user where username like '%${value}%'
- </select>
- <!--
- #{}:如果传入的是pojo类型,那么#{}中的变量名称必须是pojo中对应的属性.属性.属性.....
- 如果要返回数据库自增主键:可以使用select LAST_INSERT_ID()
- -->
- <
- insert
- id
- =
- "insertUser"
- parameterType
- =
- "cn.itheima.pojo.User"
- >
- <!-- 执行 select LAST_INSERT_ID()数据库函数,返回自增的主键
- keyProperty:将返回的主键放入传入参数的Id中保存.
- order:当前函数相对于insert语句的执行顺序,在insert前执行是before,在insert后执行是AFTER
- resultType:id的类型,也就是keyproperties中属性的类型
- -->
- <
- selectKey
- keyProperty
- =
- "id"
- order
- =
- "AFTER"
- resultType
- =
- "java.lang.Integer"
- >
- select LAST_INSERT_ID()
- </selectKey>
- insert into user (username,birthday,sex,address) values(#{username},#{birthday},#{sex},#{address})
- </insert>
- </mapper>
- public interface UserMapper {
- public User findUserById(Integer id);
- //动态代理形式中,如果返回结果集为List,那么mybatis会在生成实现类的时候会自动调用selectList方法
- public List < User > findUserByUserName(String userName);
- public void insertUser(User user);
- }
1、Mapper接口方法名和Mapper.xml中定义的statement的id相同
2、Mapper接口方法的输入参数类型和mapper.xml中定义的statement的parameterType的类型相同
3、Mapper接口方法的输出参数类型和mapper.xml中定义的statement的resultType的类型相同
修改SqlMapConfig.xml文件:
- <!-- 加载映射文件 -->
- <mappers>
- <mapper resource="mapper/UserMapper.xml" />
- </mappers>
- public class UserMapperTest {
- private SqlSessionFactory factory;
- @Before
- public void setUp() throws Exception {
- String resource = "SqlMapConfig.xml";
- InputStream inputStream = Resources.getResourceAsStream(resource);
- factory = new SqlSessionFactoryBuilder().build(inputStream);
- }
- @Test
- public void testFindUserById() throws Exception {
- SqlSession openSession = factory.openSession();
- UserMapper mapper = openSession.getMapper(UserMapper.class);
- User user = mapper.findUserById(1);
- System.out.println(user);
- }
- @Test
- public void testFindUserByName() throws Exception {
- SqlSession openSession = factory.openSession();
- UserMapper mapper = openSession.getMapper(UserMapper.class);
- List<User> list = mapper.findUserByUserName("张");
- for (User user : list) {
- System.out.println(user);
- }
- }
- @Test
- public void testInserUser() throws Exception{
- SqlSession openSession = factory.openSession();
- UserMapper mapper = openSession.getMapper(UserMapper.class);
- User user = new User();
- user.setUsername("张北泾");
- user.setAddress("北京昌平");
- user.setBirthday(new Date());
- user.setSex("1");
- mapper.insertUser(user);
- openSession.commit();
- openSession.close();
- }
- }
selectOne和selectList
动态代理对象调用sqlSession.selectOne()和sqlSession.selectList()是根据mapper接口方法的返回值决定,如果返回list则调用selectList方法,如果返回单个对象则调用selectOne方法。
namespace
mybatis官方推荐使用mapper代理方法开发mapper接口,程序员不用编写mapper接口实现类,使用mapper代理方法时,输入参数可以使用pojo包装对象或map对象,保证dao的通用性。
SqlMapConfig.xml中配置的内容和顺序如下:
properties(属性)
settings(全局配置参数)
typeAliases(类型别名)
typeHandlers(类型处理器)
objectFactory(对象工厂)
plugins(插件)
environments(环境集合属性对象)
environment(环境子属性对象)
transactionManager(事务管理)
dataSource(数据源)
mappers(映射器)
SqlMapConfig.xml可以引用java属性文件中的配置信息如下:
在classpath下定义db.properties文件
- jdbc.driver=com.mysql.jdbc.Driver
- jdbc.url=jdbc:mysql://localhost:3306/mybatis?characterEncoding=utf-8
- jdbc.username=root
- jdbc.password=root
SqlMapConfig.xml引用如下:
- <properties resource="db.properties"/>
- <environments default="development">
- <environment id="development">
- <transactionManager type="JDBC"/>
- <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>
注意: MyBatis 将按照下面的顺序来加载属性:
* 在 properties 元素体内定义的属性首先被读取。
* 然后会读取properties 元素中resource或 url 加载的属性,它会覆盖已读取的同名属性。
在SqlMapConfig.xml中配置:
- <typeAliases>
- <!-- 单个别名定义 -->
- <
- typeAlias
- alias
- =
- "user"
- type
- =
- "cn.zy.mybatis.po.User"
- />
- <!-- 批量别名定义,扫描整个包下的类,别名为类名(首字母大写或小写都可以) -->
- <package name="cn.zy.mybatis.po"/>
- <package name="其它包"/>
- </typeAliases>
Mapper配置的几种方法:
- <mapper resource = " "/>
使用相对于类路径的资源 如:
- <mapper resource="sqlmap/User.xml" />
- <mapper class=" " />
使用mapper接口类路径
如:
- <mapper class="cn.itcast.mybatis.mapper.UserMapper"/>
注意:此种方法要求mapper接口名称和mapper映射文件名称相同,且放在同一个目录中。
- <package name=""/>
注册指定包下的所有mapper接口
如:注意:此种方法要求mapper接口名称和mapper映射文件名称相同,且放在同一个目录中。
- <package name="cn.zy.mybatis.mapper"/>
好了,写到这儿就是第一章的所有内容了,那么我们总结一下今天学了些什么。首先我从最开始的原始方式入手,并且在代码部分添加了很多的注释,相信大家都能很直观的看懂是什么意思,第二,在掌握了原始的使用mybatis框架后,我用了dao的方式,简化了一些代码,然后使用接口实现类的方式讲了一下如何使用mybatis,最后,使用了mapper动态代理的方式,通过获取接口来调用配置文件的方法从而获得我们所需要的结果,希望对大家有用!下期再见,下期会进阶一点的,加油~
来源: http://blog.csdn.net/woshizisezise/article/details/78784326