Mybatis学习总结(一)——入门基础
一、Mybatis介绍
1.MyBatis是什么?
MyBatis 本是apache的一个开源项目iBatis, 2010年这个项目由apache software foundation 迁移到了google code,并且改名为MyBatis,实质上Mybatis对ibatis进行一些改进。
MyBatis是一个优秀的持久层框架,它对jdbc的操作数据库的过程进行封装,使开发者只需要关注 SQL 本身,而不需要花费精力去处理例如注册驱动、创建connection、创建statement、手动设置参数、结果集检索等jdbc繁杂的过程代码。
Mybatis通过xml或注解的方式将要执行的各种statement(statement、preparedStatemnt、CallableStatement)配置起来,并通过java对象和statement中的sql进行映射生成最终执行的sql语句,最后由mybatis框架执行sql并将结果映射成java对象并返回。
MyBatis是一个支持普通SQL查询,存储过程和高级映射的优秀持久层框架。MyBatis消除了几乎所有的JDBC代码和参数的手工设置以及对结果集的检索封装。MyBatis可以使用简单的XML或注解用于配置和原始映射,将接口和Java的POJO(Plain Old Java Objects,普通的Java对象)映射成数据库中的记录。
2.Mybatis框架图
(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编程中对结果的解析处理过程。
二、Mybatis入门程序
1.需求:(1).根据用户id(主键)查询用户信息 (2).根据用户名称模糊查询用户信息(3).添加用户 4).删除用户(5).更新用户
2.环境:java环境:JDK1.6,eclipse,Mysql5.1
3.工程目录结构
4.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事务管理,事务控制由mybatis管理--> <transactionManager type="JDBC" /> <!-- 数据库连接池,由mybatis管理--> <dataSource type="POOLED"> <property name="driver" value="com.mysql.jdbc.Driver" /> <property name="url" value="jdbc:mysql://localhost:3306/test?characterEncoding=utf-8" /> <property name="username" value="root" /> <property name="password" value="root" /> </dataSource> </environment> </environments> <!-- 加载映射文件 --> <mappers> <mapper resource="com/mybatis/mapping/User.xml"/> </mappers> </configuration>
5.实体User.java内容
package com.mybatis.entity; import java.util.Date; /** * @ClassName: User * @Description: TODO(用户实体) * @author lixiaoxi * @date 2015-6-27 下午1:56:02 * */ public class User { // 属性名称和数据库字段名称保持一致 private Integer id; // 姓名 private String username; // 性别 private String sex; // 地址 private String address; // 生日 private Date birthday; public Integer getId() { return id; } public void setId(Integer 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 String getAddress() { return address; } public void setAddress(String address) { this.address = address; } public Date getBirthday() { return birthday; } public void setBirthday(Date birthday) { this.birthday = birthday; } @Override public String toString() { return "User [id=" + id + ", username=" + username + ", sex=" + sex + ", address=" + address + ", birthday=" + birthday + "]"; } }
6.映射文件User.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,namespace的值习惯上设置成包名+sql映射文件名,这样就能够保证namespace的值是唯一的 例如namespace="com.mybatis.mapping.User"就是com.mybatis.mapping(包名)+User(User.xml文件去除后缀) --> <!-- namespace命名空间,作用就是对sql进行分类化的管理,理解为sql隔离 注意:使用mapper代理开发时,namespace有特殊作用 --> <mapper namespace="com.mybatis.mapping.User"> <!-- 在映射文件中配置很多sql语句 --> <!-- 需求:通过Id查询用户表的记录 --> <!-- 通过SELECT执行数据库查询 id:标识映射文件中的sql,称为statement的id; 将sql语句封装在mapperStatement的对象中,所以Id称为Statement的id; parameterType:指定输入参数的类型,这里指定int型 #{}:表示一个占位符; #{id}:其中Id表示接收输入的参数,参数名称就是Id,如果输入参数是简单类型,#{}中的参数名可以任意,可以是value或者其它名称; resultType:指定sql输出结果所映射的java对象类型,select指定resultType表示将单条记录映射成java对象。 --> <select id="findUserById" parameterType="int" resultType="com.mybatis.entity.User"> select username,DATE_FORMAT(birthday,'%Y-%m-%d')birthday,sex,address from t_user where id=#{id} </select> <!-- 根据用户名称模糊查询用户信息,可能返回多条数据 resultType:指定的就是单条记录所映射的java类型; ${}:表示拼接sql字符串,将接收到的参数内容不加任何修饰拼接在sql中. 使用${}拼接sql,可能会引起sql注入 ${value}:接收输入参数的内容,如果传入的是简单类型,${}中只能使用value --> <select id="findUserByName" parameterType="java.lang.String" resultType="com.mybatis.entity.User" > select * from t_user where username LIKE '%${value}%' </select> <!-- 查询所有用户 --> <select id="getUserList" resultType="com.mybatis.entity.User"> select username,birthday,sex,address from t_user </select> <!-- 添加用户 parameterType:指定输入的参数类型是pojo(包括用户信息); #{}中指定pojo的属性名称,接收到pojo对象的属性值 ,mybatis通过OGNL(类似struts2的OGNL)获取对象的属性值 --> <insert id="insertUser" parameterType="com.mybatis.entity.User"> <!-- 将insert插入的数据的主键返回到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> <!-- 使用mysql的uuid(),实现非自增主键的返回。 执行过程:通过uuid()得到主键,将主键设置到user对象的Id的属性中,其次,在insert执行时,从user对象中取出Id属性值; <selectKey keyProperty="id" order="BEFORE" resultType="java.lang.String"> select uuid() </selectKey> insert into t_user (id,username,birthday,sex,address) values(#{id},#{username},#{birthday},#{sex},#{address}) --> insert into t_user(username,birthday,sex,address) values(#{username},#{birthday},#{sex},#{address}) </insert> <!-- 更新用户 需要传入用户的Id和用户的更新信息 parameterType:指定User对象,包括Id和用户的更新信息,注意:Id是必须存在的 #{id}:从输入的User对象中获取Id的属性值 --> <update id="updateUser" parameterType="com.mybatis.entity.User"> update t_user set username=#{username},birthday=#{birthday},sex=#{sex},address=#{address} where id=#{id} </update> <!-- 删除用户 根据ID删除用户,需要输入Id值 --> <delete id="deleteUser" parameterType="java.lang.Integer"> delete from t_user where id=#{id} </delete> </mapper>
7.测试程序MybatisTest.java代码
package com.mybatis.test; import java.io.IOException; import java.io.InputStream; import java.util.Date; import java.util.List; import org.apache.ibatis.io.Resources; import org.apache.ibatis.session.SqlSession; import org.apache.ibatis.session.SqlSessionFactory; import org.apache.ibatis.session.SqlSessionFactoryBuilder; import org.junit.Test; import com.mybatis.entity.User; public class MybatisTest { // 根据Id查询用户信息,得到一条记录结果 @Test public void findUserByIdTest(){ // mybatis的配置文件 String resource = "SqlMapConfig.xml"; InputStream inputStream = null; SqlSession sqlSession = null; try{ inputStream = Resources.getResourceAsStream(resource); // 1.创建会话工场,传入mybatis的配置文件信息 SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream); // 2.通过工厂得到SqlSession sqlSession = sqlSessionFactory.openSession(); // 3.通过sqlSession操作数据库 // 第一个参数:映射文件中的statement的Id,等于namespace + "." + statement的id; // 第二个参数:指定和映射文件中所匹配的parameterType类型的参数; // sqlSession.selectOne结果是与映射文件所匹配的resultType类型的对象; // selectOne:查询一条结果 User user = sqlSession.selectOne("com.mybatis.mapping.User.findUserById",1); System.out.println(user.toString()); }catch(IOException e){ e.printStackTrace(); }finally{ if(sqlSession != null){ sqlSession.close(); } if(inputStream != null){ try{ inputStream.close(); }catch(IOException e){ e.printStackTrace(); } } } } // 根据姓名模糊查询用户信息,得到一条或多条记录结果 @Test public void findUserByNameTest(){ // mybatis的配置文件 String resource = "SqlMapConfig.xml"; InputStream inputStream = null; SqlSession sqlSession = null; try{ inputStream = Resources.getResourceAsStream(resource); // 1.创建会话工场,传入mybatis的配置文件信息 SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream); // 2.通过工厂得到SqlSession sqlSession = sqlSessionFactory.openSession(); // 3.通过sqlSession操作数据库 // 第一个参数:映射文件中的statement的Id,等于namespace + "." + statement的id; // 第二个参数:指定和映射文件中所匹配的parameterType类型的参数; // sqlSession.selectList结果是与映射文件所匹配的resultType类型的对象; // list中的user和resultType类型一致 List<User> list = sqlSession.selectList("com.mybatis.mapping.User.findUserByName","小"); System.out.println(list); }catch(IOException e){ e.printStackTrace(); }finally{ if(sqlSession != null){ sqlSession.close(); } if(inputStream != null){ try{ inputStream.close(); }catch(IOException e){ e.printStackTrace(); } } } } // 添加用户 @Test public void insertUserTest(){ // mybatis的配置文件 String resource = "SqlMapConfig.xml"; InputStream inputStream = null; SqlSession sqlSession = null; try{ inputStream = Resources.getResourceAsStream(resource); // 1.创建会话工场,传入mybatis的配置文件信息 SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream); // 2.通过工厂得到SqlSession sqlSession = sqlSessionFactory.openSession(); //插入用户的对象 User user = new User(); user.setUsername("小红"); user.setSex("1"); user.setBirthday(new Date()); user.setAddress("北京"); // 3.通过sqlSession操作数据库 // 第一个参数:映射文件中的statement的Id,等于namespace + "." + statement的id; // 第二个参数:指定和映射文件中所匹配的parameterType类型的参数; sqlSession.insert("com.mybatis.mapping.User.insertUser",user); // 执行提交事务 sqlSession.commit(); //项目中经常需要 获取新增的用户的主键 System.out.println(user.getId()); }catch(IOException e){ e.printStackTrace(); }finally{ if(sqlSession != null){ sqlSession.close(); } if(inputStream != null){ try{ inputStream.close(); }catch(IOException e){ e.printStackTrace(); } } } } // 根据Id更新用户信息 @Test public void updateUserTest(){ // mybatis的配置文件 String resource = "SqlMapConfig.xml"; InputStream inputStream = null; SqlSession sqlSession = null; try{ inputStream = Resources.getResourceAsStream(resource); // 1.创建会话工场,传入mybatis的配置文件信息 SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream); // 2.通过工厂得到SqlSession sqlSession = sqlSessionFactory.openSession(); //更新用户的信息 User user = new User(); user.setId(2); user.setUsername("小黑"); user.setSex("2"); user.setBirthday(new Date()); user.setAddress("上海"); // 3.通过sqlSession操作数据库 // 第一个参数:映射文件中的statement的Id,等于namespace + "." + statement的id; // 第二个参数:指定和映射文件中所匹配的parameterType类型的参数; sqlSession.update("com.mybatis.mapping.User.updateUser",user); // 执行提交事务 sqlSession.commit(); }catch(IOException e){ e.printStackTrace(); }finally{ if(sqlSession != null){ sqlSession.close(); } if(inputStream != null){ try{ inputStream.close(); }catch(IOException e){ e.printStackTrace(); } } } } // 根据Id删除用户 @Test public void deleteUserTest(){ // mybatis的配置文件 String resource = "SqlMapConfig.xml"; InputStream inputStream = null; SqlSession sqlSession = null; try{ inputStream = Resources.getResourceAsStream(resource); // 1.创建会话工场,传入mybatis的配置文件信息 SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream); // 2.通过工厂得到SqlSession sqlSession = sqlSessionFactory.openSession(); // 3.通过sqlSession操作数据库 // 第一个参数:映射文件中的statement的Id,等于namespace + "." + statement的id; // 第二个参数:指定和映射文件中所匹配的parameterType类型的参数; //传入Id,删除用户 sqlSession.delete("com.mybatis.mapping.User.deleteUser",6); // 执行提交事务 sqlSession.commit(); }catch(IOException e){ e.printStackTrace(); }finally{ if(sqlSession != null){ sqlSession.close(); } if(inputStream != null){ try{ inputStream.close(); }catch(IOException e){ e.printStackTrace(); } } } } }
8.数据库所用sql脚本
CREATE TABLE t_user ( id INT NOT NULL AUTO_INCREMENT PRIMARY KEY, username VARCHAR(30) NOT NULL COMMENT '用户名称', birthday DATE DEFAULT NULL COMMENT '生日', sex CHAR(2) DEFAULT NULL COMMENT '性别', address VARCHAR(256) DEFAULT NULL COMMENT '地址' ); INSERT INTO t_user (username,birthday,sex,address) VALUES ('小A','2015-06-27','2','北京'), ('小B','2015-06-27','2','北京'), ('小C','2015-06-27','1','北京'), ('小D','2015-06-27','2','北京');
三、mybatis和Hibernate的本质区别与应用场景
hibernate:是一个标准ORM框架(对象关系映射),入门门槛较高的,不需要程序写sql,sql语句自动生成了,对sql语句进行优化、修改比较困难的。
应用场景:
适用与需求变化不多的中小型项目,比如:后台管理系统,erp、orm、oa。
mybatis:专注是sql本身,需要程序员自己编写sql语句,sql修改、优化比较方便。mybatis是一个不完全的ORM框架,虽然程序员自己写sql,mybatis 也可以实现映射(输入映射、输出映射)。
应用场景:
适用与需求变化较多的项目,比如:互联网项目。
四、小结
1.parameterType和resultType
parameterType:在映射文件中通过parameterType指定输入参数的类型。
resultType:在映射文件中通过resultType指定输出结果的类型
2.#{}和${}
#{}表示一个占位符号,#{}接收输入参数,类型可以是简单类型,pojo、hashmap;
如果接收简单类型,#{}中可以写成value或其它名称;
#{}接收pojo对象值,通过OGNL读取对象中的属性值,通过属性.属性.属性...的方式获取对象属性值。
${}表示一个拼接符号,会引用sql注入,所以不建议使用 表示一个拼接符号,会引用sql注入,所以不建议使用{};
${}接收输入参数,类型可以是简单类型,pojo、hashmap;
如果接收简单类型,${}中只能写成value;
${}接收pojo对象值,通过OGNL读取对象中的属性值,通过属性.属性.属性...的方式获取对象属性值。
3.selectOne()和selectList()
selectOne表示查询出一条记录进行映射。如果使用selectOne可以实现,那么使用selectList也可以实现(list中只有一个对象)。
selectList表示查询出一个列表(多条记录)进行映射。如果使用selectList查询多条记录,不能使用selectOne。如果使用selectOne会报错。