超详细MyBatis入门讲解,深入开发,从今天开始
1.Mybatis简介
1.1基本内容
- MyBatis是一个优秀的持久层框架,它对jdbc的操作数据库的过程进行封装,使开发者只需要关注 SQL 本身,而不需要花费精力去处理例如注册驱动、创建connection、创建statement、手动设置参数、结果集检索等jdbc繁杂的过程代码。
- Mybatis通过xml或注解的方式将要执行的各种statement(statement、preparedStatemnt、CallableStatement)配置起来,并通过java对象和statement中的sql进行映射生成最终执行的sql语句,最后由mybatis框架执行sql并将结果映射成java对象并返回。
1.2JDBC的问题
1、 数据库连接创建、释放频繁造成系统资源浪费,从而影响系统性能。如果使用数据库连接池可解决此问题。
2、 Sql语句在代码中硬编码,造成代码不易维护,实际应用中sql变化的可能较大,sql变动需要改变java代码。
3、 使用preparedStatement向占有位符号传参数存在硬编码,因为sql语句的where条件不一定,可能多也可能少,修改sql还要修改代码,系统不易维护。
4、 对结果集解析存在硬编码(查询列名),sql变化导致解析代码变化,系统不易维护,如果能将数据库记录封装成pojo对象解析比较方便。
1.3Mybatis架构
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编程中对结果的解析处理过程。
2.Mybatis框架搭建
2.1入门程序
1.导包
-
mybatis-3.2.7.jar
-
依赖包:
-
数据库驱动包
1 <dependency> 2 <groupId>org.mybatis</groupId> 3 <artifactId>mybatis</artifactId> 4 <version>3.2.7</version> 5 </dependency> 6 <!-- https://mvnrepository.com/artifact/mysql/mysql-connector-java --> 7 <dependency> 8 <groupId>mysql</groupId> 9 <artifactId>mysql-connector-java</artifactId> 10 <version>5.1.8</version> 11 </dependency> 12 <dependency> 13 <groupId>commons-logging</groupId> 14 <artifactId>commons-logging</artifactId> 15 <version>1.1.1</version> 16 </dependency> 17 <dependency> 18 <groupId>log4j</groupId> 19 <artifactId>log4j</artifactId> 20 <version>1.2.17</version> 21 </dependency> 22 <dependency> 23 <groupId>org.apache.logging.log4j</groupId> 24 <artifactId>log4j-api</artifactId> 25 <version>2.10.0</version> 26 </dependency> 27 <!-- https://mvnrepository.com/artifact/org.apache.logging.log4j/log4j-core --> 28 <dependency> 29 <groupId>org.apache.logging.log4j</groupId> 30 <artifactId>log4j-core</artifactId> 31 <version>2.1</version> 32 </dependency> 33 <!-- https://mvnrepository.com/artifact/org.slf4j/slf4j-api --> 34 <dependency> 35 <groupId>org.slf4j</groupId> 36 <artifactId>slf4j-api</artifactId> 37 <version>1.7.6</version> 38 </dependency> 39 <!-- https://mvnrepository.com/artifact/org.slf4j/slf4j-log4j12 --> 40 <dependency> 41 <groupId>org.slf4j</groupId> 42 <artifactId>slf4j-log4j12</artifactId> 43 <version>1.7.6</version> 44 <scope>test</scope> 45 </dependency> 46 <!-- https://mvnrepository.com/artifact/cglib/cglib --> 47 <dependency> 48 <groupId>cglib</groupId> 49 <artifactId>cglib</artifactId> 50 <version>3.1</version> 51 </dependency> 52 <!-- https://mvnrepository.com/artifact/org.javassist/javassist --> 53 <dependency> 54 <groupId>org.javassist</groupId> 55 <artifactId>javassist</artifactId> 56 <version>3.18.2-GA</version> 57 </dependency> 58 <!-- https://mvnrepository.com/artifact/org.ow2.asm/asm --> 59 <dependency> 60 <groupId>org.ow2.asm</groupId> 61 <artifactId>asm</artifactId> 62 <version>5.0.3</version> 63 </dependency>
2.数据库准备:数据库建立,表的建立
1 DROP TABLE IF EXISTS `user`; 2 CREATE TABLE `user` ( 3 `id` int(11) NOT NULL AUTO_INCREMENT, 4 `name` varchar(32) NOT NULL COMMENT '用户名称', 5 `birthday` date DEFAULT NULL COMMENT '生日', 6 `sex` char(1) DEFAULT NULL COMMENT '性别', 7 `address` varchar(256) DEFAULT NULL COMMENT '地址', 8 PRIMARY KEY (`id`) 9 ) ENGINE=InnoDB AUTO_INCREMENT=27 DEFAULT CHARSET=utf8;
3.Bean包User创建,对应数据库中的User表
1 private int id; 2 private String username;// 用户姓名 3 private String sex;// 性别 4 private Date birthday;// 生日 5 private String address;// 地址
4.核心配置文件sqlMapConfig.xml
(src目录下)
1 <?xml version="1.0" encoding="UTF-8" ?> 2 <!DOCTYPE configuration 3 PUBLIC "-//mybatis.org//DTD Config 3.0//EN" 4 "http://mybatis.org/dtd/mybatis-3-config.dtd"> 5 <configuration> 6 <!-- 和spring整合后 environments配置将废除 --> 7 <environments default="development"> 8 <environment id="development"> 9 <!-- 使用jdbc事务管理 --> 10 <transactionManager type="JDBC" /> 11 <!-- 数据库连接池 --> 12 <dataSource type="POOLED"> 13 <property name="driver" value="com.mysql.jdbc.Driver" /> 14 <property name="url" 15 value="jdbc:mysql://localhost:3306/spring?characterEncoding=utf-8" /> 16 <property name="username" value="root" /> 17 <property name="password" value="123456" /> 18 </dataSource> 19 </environment> 20 </environments> 21 </configuration>
日志配置文件 在src下创建log4j.properties如下
1 # Global logging configuration 2 3 log4j.rootLogger=DEBUG, stdout 4 5 # Console output... 6 7 log4j.appender.stdout=org.apache.log4j.ConsoleAppender 8 log4j.appender.stdout.layout=org.apache.log4j.PatternLayout 9 log4j.appender.stdout.layout.ConversionPattern=%5p [%t] - %m%n
5.配置文件Mapper1.xml(可以统一放在src/sqlMap文件夹下)
1 <?xml version="1.0" encoding="UTF-8" ?> 2 <!DOCTYPE mapper 3 PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" 4 "http://mybatis.org/dtd/mybatis-3-mapper.dtd"> 5 <!-- namespace:命名空间,用于隔离sql, 6 命名空间 user.findUserById 7 --> 8 <mapper namespace="user"> 9 <!-- 通过ID查询一个用户 10 id名字,namespace+id用来定位具体的sql parameterType:参数类型 resultType:返回值,如果bean与数据库一一对应,则会自动映射 where id=#{v},#{} 占位符,里面要写一个任意字符 11 --> 12 <select id="findUserById" parameterType="Integer" resultType="com.ali.pojo.User"> 13 select * from t_user where id=#{v} 14 </select> 15 </mapper>
同时,需要在sqlMapConfig中加入如下信息,表明mapper.xml位置
1 <!-- mapper位置 --> 2 <mappers> 3 <mapper resource="../src/sqlMap/User.xml" /> 4 </mappers>
6.测试
1 public class MybatisTest1 { 2 3 @Test 4 public void testMybatis() throws IOException { 5 //加载核心文件 6 String resource="sqlMapConfig.xml"; 7 InputStream resourceAsStream = Resources.getResourceAsStream(resource); 8 //创建sqlSessionFactory 9 SqlSessionFactory sqlSessionFactory=new SqlSessionFactoryBuilder().build(resourceAsStream); 10 //创建sqlSession 11 SqlSession session=sqlSessionFactory.openSession(); 12 //执行sql语句 13 User user = session.selectOne("user.findUserById", 1); 14 System.out.println(user); 15 }
7.使用名字模糊查询
1 <!-- 根据名字模糊查询 2 #{} 1.相当于? =='' 会带单引号 2.里面的表示字符任意 3 ${} 1.不带单引号 2.里面的字符必须为value 4 resultType="com.ali.pojo.User" 写的是list的泛型 5 --> 6 <select id="findUserByName" parameterType="String" resultType="com.ali.pojo.User"> 7 <!-- select * from t_user where name like '%${value}%'--> 8 select * from t_user where name like "%"#{v}"%" 9 </select>
测试唯一不同的是,此时要使用 selectListS
1 List<User> users = session.selectList("user.findUserByNames", "ba");
8.添加用户
这时候的参数值name
sex
要与数据库的字段名匹配
1 <insert id="insertUser" parameterType="com.ali.bean.User"> 2 insert into t_user values(null,#{name},#{sex}) 3 </insert>
记得执行完sql语句后,提交事务
1 User user=new User(); 2 user.setName("Tx2333"); 3 user.setAge(24); 4 int insert = openSession.insert("user.insertUser", user); 5 openSession.commit();
9.添加用户后返回id号
1 <insert id="insertUser" parameterType="com.ali.bean.User"> 2 <!-- mysql是先插入数据,再进行编号,所以 order="AFTER",oracle是before--> 3 <selectKey keyProperty="id" resultType="Integer" order="AFTER"> 4 select LAST_INSERT_ID()<!-- 这个是mysql提供的函数--> 5 </selectKey> 6 insert into t_user values(null,#{name},#{age}) 7 </insert>
1 User user=new User(); 2 user.setName("ali"); 3 user.setAge(24); 4 int insert = openSession.insert("user.insertUser", user); 5 openSession.commit(); 6 System.out.println(user.getId());
10.更新用户(跟上面的没啥区别,没时间的话就不用看了,只是记得要提交事务)
1 <update id="updateUser" parameterType="com.ali.bean.User"> 2 update t_user set name=#{name} where id=#{id} 3 </update>
1 User user=new User(); 2 user.setName("ali"); 3 user.setId(1); 4 int update = openSession.update("user.updateUser", user); 5 openSession.commit();
11.删除用户(跟上面的没啥区别,没时间的话就不用看了,只是记得要提交事务)
1 <!--直接传入整数也是可以的--> 2 <delete id="deleteUser" parameterType="com.ali.bean.User"> 3 delete from t_user where id=#{id} 4 </delete>
1 User user=new User(); 2 user.setId(1); 3 int delete = openSession.delete("user.deleteUser", user); 4 openSession.commit();
2.2小结
- #{}表示一个占位符号,通过#{}可以实现preparedStatement向占位符中设置值,自动进行java类型和jdbc类型转换。#{}可以有效防止sql注入。 #{}可以接收简单类型值或pojo属性值。 如果parameterType传输单个简单类型值,#{}括号中可以是value或其它名称。
${}
表示拼接sql串,通过${}
可以将parameterType 传入的内容拼接在sql中且不进行jdbc类型转换, ${}可以接收简单类型值或pojo属性值,如果parameterType传输单个简单类型值,${}
括号中只能是value。
2.2和Hibernate的区别
Mybatis和hibernate不同,它不完全是一个ORM框架,因为MyBatis需要程序员自己编写Sql语句。mybatis可以通过XML或注解方式灵活配置要运行的sql语句,并将java对象和sql语句映射生成最终执行的sql,最后将sql执行的结果再映射生成java对象。
Mybatis学习门槛低,简单易学,程序员直接编写原生态sql,可严格控制sql执行性能,灵活度高,非常适合对关系数据模型要求不高的软件开发,例如互联网软件、企业运营类软件等,因为这类软件需求变化频繁,一但需求变化要求成果输出迅速。但是灵活的前提是mybatis无法做到数据库无关性,如果需要实现支持多种数据库的软件则需要自定义多套sql映射文件,工作量大。
Hibernate对象/关系映射能力强,数据库无关性好,对于关系模型要求高的软件(例如需求固定的定制化软件)如果用hibernate开发可以节省很多代码,提高效率。但是Hibernate的学习门槛高,要精通门槛更高,而且怎么设计O/R映射,在性能和对象模型之间如何权衡,以及怎样用好Hibernate需要具有很强的经验和能力才行。
总之,按照用户的需求在有限的资源环境下只要能做出维护性、扩展性良好的软件架构都是好架构,所以框架只有适合才是最好。
3.Dao开发方法
-
dao层新建接口UserDao ,实现类 UserDaoImpl
1 package com.ali.dao; 2 3 import org.apache.ibatis.session.SqlSession; 4 5 import org.apache.ibatis.session.SqlSessionFactory; 6 7 import com.ali.bean.User; 8 9 public class UserDaoImpl implements UserDao { 10 11 //注入工厂 12 private SqlSessionFactory sessionFactory; 13 14 public UserDaoImpl(SqlSessionFactory sessionFactory) { 15 this.sessionFactory = sessionFactory; 16 } 17 //通过用户ID查询一个用户 18 @Override 19 public User selectUserById(Integer id) { 20 SqlSession openSession = sessionFactory.openSession(); 21 return openSession.selectOne("user.findUserById",id); 22 } 23 }
使用测试类创建SqlSessionFactory
1 public class MybatisDaoTest { 2 public SqlSessionFactory sqlSessionFactory; 3 @Before 4 public void before() throws IOException { 5 String resource="sqlMapConfig.xml"; 6 InputStream in = Resources.getResourceAsStream(resource); 7 sqlSessionFactory=new SqlSessionFactoryBuilder().build(in); 8 } 9 @Test 10 public void testDao() { 11 UserDao userDao =new UserDaoImpl(sqlSessionFactory); 12 User user = userDao.selectUserById(2); 13 System.out.println(user);
4.Mapper动态代理开发
-
只写接口,实现类由mybatis生成
-
四个原则: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.xml对应
1 import com.ali.bean.User; 2 3 public interface MapperUser { 4 //原则一:mapper.xml中的namespace要与mapper接口类路径相同 5 //原则二:接口方法名与xml中id相同 6 //原则三:接口的输入参数一致 7 //原则四:接口方法返回类型一致 8 public User findUserById(Integer id); 9 }
1 <mapper namespace="com.ali.mapper.MapperUser"> 2 <select id="findUserById" resultType="com.ali.bean.User" 3 parameterType="Integer"> 4 select * from t_user where id=#{v} 5 </select> 6 </mapper>
- 测试类 要使用sqlSession.getMapper(MapperUser.class);方法
1 public void fun1() throws IOException { 2 String resource="sqlMapConfig.xml"; 3 InputStream in = Resources.getResourceAsStream(resource); 4 SqlSessionFactory sqlSessionFactory=new SqlSessionFactoryBuilder().build(in); 5 SqlSession sqlSession = sqlSessionFactory.openSession(); 6 //sqlSession生成实现类 7 MapperUser userMapper = sqlSession.getMapper(MapperUser.class); 8 User user = userMapper.findUserById(2); 9 System.out.println(user); 10 }
5.配置文件说明
5.1配置内容
SqlMapConfig.xml中配置的内容和顺序如下:
- properties(属性)
- settings(全局配置参数)
- typeAliases(类型别名)
- typeHandlers(类型处理器)
- objectFactory(对象工厂)
- plugins(插件)
- environments(环境集合属性对象)
- environment(环境子属性对象)
- transactionManager(事务管理)
- dataSource(数据源)
- mappers(映射器)
5.2properties(属性)
-
SqlMapConfig.xml可以引用java属性文件中的配置信息,比如db.properties
-
SqlMapConfig.xml引用如下:
<properties resource="db.properties"></properties> ..... <property name="driver" value="${jdbc.driver}" />
- 1
- 2
- 3
- 4
5.3typeAliases(类型别名)
- 解决mapper.xml中类型名引用过长的问题
- 同时注意顺序,该标签必须放在properties标签下面
1 <typeAliases> 2 <!-- 单个别名定义 --> 3 <typeAlias type="com.ali.bean.User" alias="user"/> 4 <!-- 批量别名定义,扫描整个包下的类,别名为类名,自动映射(大小写不敏感) --> 5 <package name="com.ali.bean" /> 6 </typeAliases>
5.4mapper(映射器)
-
<mapper resource=" " />
使用相对于类路径的资源(现在的使用方式)
如:
<mapper resource="sqlmap/User.xml" />
-
<mapper class=" " />
使用mapper接口类路径
如:
<mapperclass="cn.itcast.mybatis.mapper.UserMapper"/>
注意:此种方法要求mapper接口名称和mapper映射文件名称相同,且放在同一个目录中。
-
<package name=""/>
注册指定包下的所有mapper接口
如:
<package name="cn.itcast.mybatis.mapper"/>
注意:此种方法要求mapper接口名称和mapper映射文件名称相同,且放在同一个目录中。
喜欢请关注小编,后续会再带来更丰富的Java知识更新,希望大家和小编一起共同进步!!!