首先我要明确告诉大家的是MyBatis是一个java持久层框架,以前我们都是用jdbc来将我们的java程序与数据库相连接,而MyBatis是对jdbc的一个封装。
1.MyBatis框架的引入
我们来看看传统的编程方式中使用jdbc的问题:
- 1.数据库连接频繁的创建和关闭,缺点:浪费数据库的资源,影响操作效率。解决方法:使用数据库连接池如c3p0.
- 2.sql语句是硬编码(不利用系统维护),如果需求变更需要修改sql,这时候就需要修改java代码,然后需要重新编译,系统不易维护。解决方法:将sql语句统一配置在文件中。这样以后修改sql时就不需要修改java代码了。
- 3.我们通过preparedStatement对象向占位符设置参数,存在硬编码(参数位置、参数)问题,系统不易维护。解决方法:将sql中的占位符及对应的参数类型配置在配置文件中,能够自动输入的映射。
- 4.遍历查询结果集存在硬编码(列名)。解决方法:自动进行sql查询结果向java对象的映射(输出映射)。
为了解决这些问题,所以出现了MyBatis框架。
2.MyBatis介绍
MyBatis 本是apache的一个开源项目iBatis, 2010年这个项目由apache software foundation 迁移到了google code,并且改名为MyBatis,实质上Mybatis对ibatis进行一些改进。 目前mybatis在github上托管。
MyBatis是一个优秀的持久层框架,它对jdbc的操作数据库的过程进行封装,使开发者只需要关注 SQL 本身,而不需要花费精力去处理例如注册驱动、创建connection、创建statement、手动设置参数、结果集检索等jdbc繁杂的过程代码。
MyBatis通过xml或注解的方式将要执行的各种statement(statement、preparedStatemnt、CallableStatement)配置起来,并通过java对象和statement中的sql进行映射生成最终执行的sql语句,最后由mybatis框架执行sql并将结果映射成java对象并返回。
3.MyBatis架构
如下图:
接下来我将通过对一张用户表进行增、删、改、查带你快速入门MyBatis。
4.MyBatis快速入门
4.1准备开发环境
1.创建测试项目,普通java项目或是web项目都可。
2.导入jar包:mybatis-3.1.1.jar(低于这个版本的jar包需要导入很多依赖包)和mysql-connection-java
3.创建数据库和相应的表,SQL脚本如下:
到此,环境配置就告一段落。
4.2使用MyBatis查询表中数据(通过id查询)
1.添加Mybatis的配置文件SqlMapConfig.xml
在src目录下创建一个SqlMapConfig.xml文件(文件名称随便起),内容如下:
2.定义表所需要的实体类User.java
代码如下:
3.定义操作user表的sql映射文件User.xml
这里我们没将文件命名为userMapper.xml,后面我们会改。
User.xml文件内容如下:
在User.xml中写SQL语句,在参数处使用占位符#{}
,应该注意的是大括号{}
中传入的数据应该与User.java中的属性对应,文件中各个属性的解释见图中注释处。
4.在SqlMapConfig文件中注册User.xml文件
在SqlMapConfig.xml中添加一个<mappers></mappers>
字段,并在里面传入User.xml文件路径。
整体结构如下:
5.接下来我们便可以借助上面MyBatis架构图来编写测试类了
注意,我是借助junit.jar包来编写的测试类。输出结果如下:
上面我们是通过id来对表进行查询,接下来我要讲讲如何通过姓名来模糊查询表。
4.3使用MyBatis根据用户名模糊查询用户信息
1.需要在User.xml文件中添加如下字段:
此时,我们在传入参数的地方不再使用占位符#{}
而是使用${}
,二者区别如下:
#{}
:1.表示一个占位符,向占位符输入参数,mybatis自动进行java类型和jdbc类型的转换。2.程序员不需要考虑参数的类型,比如:传入字符串,mybatis最终拼接好的sql就是参数两边加单引号。3.#{}
接收pojo(Plain Old Java Object Java数据对象)数据,可以使用OGNL(就是el表达式)解析出pojo的属性值。${}
:1.表示sql的拼接,通过${}
接收参数,将参数的内容不加任何修饰拼接在sql中。2.${}
也可以接收pojo数据,可以使用OGNL解析出pojo的属性值。3.缺点:不能防止sql注入。
2.测试类代码如下:
注意,此时我们通过name查询出来的语句为多条,故此时我们应该选择调用sqlSession对象的selectList()方法返回多条记录,输出我们查询到的第一条记录即可。若使用selectOne()方法,当返回的记录为多条时就会发生异常。
这样我们便完成了查询时将sql结果输出映射到Java对象中。那如何将Java对象输入映射到sql语句中,接下来我们就来讲通过MyBatis实现增、删、改数据库。
4.4使用MyBatis向表中插入一条记录
1.在User.xml中添加如下字段:
貌似关键字为value和values都可以…
2.编写测试类:
此时查看数据库:
发现数据已被插入。
扩展:主键返回:
在测试类中,我们没有给User对象的id属性设置值,所以我们在测试类中尝试输出User对象的id时会输出id=0
,但是该对象通过输入映射在数据库中是有对应的id值的(因为我们为该字段设置了自增长属性)。那么我们想输出该对象在记录中的id时,又该怎么做呢?只需在User.xml文件中的<insert></insert>
标签中添加<selectKey>
标签即可,属性解释见图:
此时我们在测试类中便可输出该User对象插入在表中的记录id值了。
这里我们由于在建表时设置了id字段为自增长,采用自增长的形式生成主键,所以我们在传入User对象的id属性时可以将该属性设置为null。那么当我们使用uuid生成主键时又该怎么做呢?
只需在User.xml中添加如下字段:
属性值”before”的意思表示在执行插入操作时,会先调用uuid()函数生成uuid得到主键,然后将主键设置到User对象中,再将User对象插入到数据库。所以此时我们在测试类中也可以不对User的id属性进行设置值。
4.5使用MyBatis实现删除表中数据
接下来的操作就很轻松了,因为跟上述操作差不多。
1.在User.xml文件中添加如下字段:
2.编写测试类:
运行程序后便可发现数据库中的该数据已被删除。
4.6使用MyBatis实现更新表中数据
1.在User.xml文件中添加如下字段:
2.编写测试类:
运行程序后便可发现数据库中的该数据已被更新。
5.MyBatis开发流程小结
写过上述代码,我们便可以对MyBatis的开发流程进行一下总结了,流程如下:
- 1.编写SqlMapConfig.xml
- 2.编写mapper.xml(每个字段定义一个statement)
- 3.编程通过配置文件创建SqlSessionFactory
- 4.通过SqlSessionFactory获取SqlSession对象。
- 5.通过SqlSession操作数据库。(如果执行添加、更新、删除需要调用SqlSession.commit())
- 6.SqlSesion使用完成要关闭。
关于MyBatis配置的一些优化及高级知识请见我后面的文章。