MyBatis入门基础知识总结一
总览
- MyBatis简介
- MyBatis快速入门
- MyBatis的映射文件概述
- MyBatis的增删改查
- MyBatis的核心配置文件概述
- MyBatis的相关API
1 MyBatis简介
1.1 原始jdbc操作
- 注册驱动
- 获得连接
- 获得statement
- 执行查询
- 遍历结果集
- 释放资源
1.2 什么是MyBatis
MyBatis是基于java的持久层框架,内部封装了jdbc,是开发者只需要关注sql语句本身,而不需要花费精力去处理加载驱动、创建连接、创建statement等繁杂的过程。它通过xml或注解的方式将要执行的各种statement配置起来,并通过java对象和statement中的sql动态参数进行映射生成最终执行的sql语句。最后框架执行sql并将结果映射为java对象返回。采用orm思想解决了实体和数据库映射的问题。
2 MyBatis的快速入门
MyBatis开发步骤
- 添加MyBatis的坐标
- 创建user数据表
- 编写User实体类
- 编写映射文件UserMapper.xml
- 编写核心文件SqlMapConfig.xml
- 编写测试类
- 导入MyBatis坐标和相关坐标
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>5.1.32</version>
</dependency>
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.2</version>
</dependency>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.12</version>
<scope>test</scope>
</dependency>
<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>1.2.17</version>
</dependency>
- 创建user数据表
- 编写User实体
public class User {
private int id;
private String username;
private String password;
getter and setter...
}
- 编写UserMapper映射文件
<?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="userMapper">
<!--查询操作-->
<!--查询后会返回一个对象,因此要用resultType指定返回的对象,下面的user使用的核心配置文件里alias别名,全包名应该是:com.itheima.domain.User,后面几个相同-->
<select id="findAll" resultType="user">
select * from user
</select>
<!--插入标签-->
<insert id="save" parameterType="user">
insert into user values(#{id}, #{username}, #{password}) /*注意括号里面的值必须和实体类中的属性名保持一致,上面的parameterType是指从User实体类中获得的参数*/
</insert>
<!--更新操作-->
<update id="update" parameterType="user">
update user set username=#{username},password=#{password} where id=#{id}
</update>
<!--删除操作-->
<delete id="delete" parameterType="int">
delete from user where id=#{id}
</delete>
<!--根据id查询一个操作-->
<select id="findById" resultType="user" parameterType="int">
select * from user where id=#{id}
</select>
</mapper>
- 编写MyBatis核心文件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>
<!--通过properties加载外部的properties文件-->
<properties resource="jdbc.properties"></properties>
<!--自定义别名-->
<typeAliases>
<typeAlias type="com.itheima.domain.User" alias="user"></typeAlias>
</typeAliases>
<!--数据源环境-->
<environments default="development">
<environment id="development">
<transactionManager type="JDBC"></transactionManager>
<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>
<!--加载映射文件-->
<mappers>
<mapper resource="com/itheima/mapper/UserMapper.xml"></mapper>
</mappers>
</configuration>
- 编写测试代码
public class MyBatisTest {
@Test
public void test1() throws IOException {
// 加载核心配置文件
InputStream resourceAsStream = Resources.getResourceAsStream("sqlMapConfig.xml");
// 获得session工厂对象
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(resourceAsStream);
// 获得session会话对象
SqlSession sqlSession = sqlSessionFactory.openSession();
// 执行操作 参数:namespace+id
List<User> userList = sqlSession.selectList("userMapper.findAll");
// 打印数据
System.out.println(userList);
// 释放资源
sqlSession.close();
}
@Test
public void test2() throws IOException {
User user = new User();
user.setUsername("Alice");
user.setPassword("123");
// 加载核心配置文件
InputStream resourceAsStream = Resources.getResourceAsStream("sqlMapConfig.xml");
// 获得session工厂对象
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(resourceAsStream);
// 获得session会话对象
SqlSession sqlSession = sqlSessionFactory.openSession();
// 执行操作 参数:namespace+id
int count = sqlSession.insert("userMapper.save", user);
// 注意:mybatis默认事务不提交,所以默认情况下是不生效的,所以需要提交事务
sqlSession.commit();
System.out.println(count);
// 释放资源
sqlSession.close();
}
@Test
public void test3() throws IOException {
User user = new User();
user.setId(7);
user.setUsername("bob");
user.setPassword("123");
// 加载核心配置文件
InputStream resourceAsStream = Resources.getResourceAsStream("sqlMapConfig.xml");
// 获得session工厂对象
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(resourceAsStream);
// 获得session会话对象
SqlSession sqlSession = sqlSessionFactory.openSession();
// 执行操作 参数:namespace+id
sqlSession.update("userMapper.update", user);
// 注意:mybatis默认事务不提交,所以默认情况下是不生效的,所以需要提交事务,也可以将opensession的参数改为true,这样就默认提交了
sqlSession.commit();
// 释放资源
sqlSession.close();
}
@Test
public void test4() throws IOException {
// 加载核心配置文件
InputStream resourceAsStream = Resources.getResourceAsStream("sqlMapConfig.xml");
// 获得session工厂对象
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(resourceAsStream);
// 获得session会话对象
SqlSession sqlSession = sqlSessionFactory.openSession();
// 执行操作 参数:namespace+id
sqlSession.delete("userMapper.delete", 5);
// 注意:mybatis默认事务不提交,所以默认情况下是不生效的,所以需要提交事务
sqlSession.commit();
// 释放资源
sqlSession.close();
}
/**
* 根据id查询一个
* @throws IOException
*/
@Test
public void test5() throws IOException {
// 加载核心配置文件
InputStream resourceAsStream = Resources.getResourceAsStream("sqlMapConfig.xml");
// 获得session工厂对象
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(resourceAsStream);
// 获得session会话对象
SqlSession sqlSession = sqlSessionFactory.openSession();
// 执行操作 参数:namespace+id
User user = sqlSession.selectOne("userMapper.findById", 1);
System.out.println(user);
// 释放资源
sqlSession.close();
}
}
3 MyBatis映射文件概述
4 MyBatis的增删改查
4.1 插入操作注意问题
插入语句使用insert标签
在映射文件中使用parameterType属性指定要插入的数据类型
Sql语句中使用#{实体属性名}方式引用实体中的属性值
插入操作使用的API是sqlSession.insert(“命名空间.id”,实体对象);
插入操作涉及数据库数据变化,所以要使用sqlSession对象显示的提交事务,即sqlSession.commit()
4.2 修改操作注意问题
修改语句使用update标签
修改操作使用的API是sqlSession.update(“命名空间.id”,实体对象);
4.3 删除操作注意问题
删除语句使用delete标签
Sql语句中使用#{任意字符串}方式引用传递的单个参数
删除操作使用的API是sqlSession.delete(“命名空间.id”,Object);
5 核心配置文件概述
5.1 MyBatis核心配置文件层级关系
5.2 常用配置解析
-
environments标签
数据库环境的配置,支持多环境配置
其中,事务管理器(transactionManager)类型有两种:
-
JDBC:这个配置就是直接使用了JDBC 的提交和回滚设置,它依赖于从数据源得到的连接来管理事务作用域。
-
MANAGED:这个配置几乎没做什么。它从来不提交或回滚一个连接,而是让容器来管理事务的整个生命周期(比如 JEE 应用服务器的上下文)。 默认情况下它会关闭连接,然而一些容器并不希望这样,因此需要将 closeConnection 属性设置为 false 来阻止它默认的关闭行为。
其中,数据源(dataSource)类型有三种:
-
UNPOOLED:这个数据源的实现只是每次被请求时打开和关闭连接。
-
POOLED:这种数据源的实现利用“池”的概念将 JDBC 连接对象组织起来。
-
JNDI:这个数据源的实现是为了能在如 EJB 或应用服务器这类容器中使用,容器可以集中或在外部配置数据源,然后放置一个 JNDI 上下文的引用。
-
mapper标签
该标签的作用是加载映射的,加载方式有如下几种:(多数为第一种)
-
使用相对于类路径的资源引用,例如:
-
使用完全限定资源定位符(URL),例如:
-
使用映射器接口实现类的完全限定类名,例如:
-
将包内的映射器接口实现全部注册为映射器,例如:
-
-
properties标签
实际开发中,习惯将数据源的配置信息单独抽取成一个properties文件,该标签可以加载额外配置的properties文件
-
typeAliases标签
类型别名是为Java 类型设置一个短的名字。原来的类型名称配置如下
配置typeAliases,为com.itheima.domain.User定义别名为user
mybatis框架已经为我们设置好的一些常用的类型的别名
别名 | 数据类型 |
---|---|
string | String |
long | Long |
int | Integer |
double | Double |
boolean | Boolean |
… … | … … |
6 MyBatis相应的API
6.1 SqlSession工厂构建器SqlSessionFactoryBuilder
常用API:SqlSessionFactory build(InputStream inputStream)
通过加载mybatis的核心文件的输入流的形式构建一个SqlSessionFactory对象
其中, Resources 工具类,这个类在 org.apache.ibatis.io 包中。Resources 类帮助你从类路径下、文件系统或一个 web URL 中加载资源文件。
6.2 SqlSession工厂对象SqlSessionFactory
SqlSessionFactory 有多个个方法创建 SqlSession 实例。常用的有如下两个:
方法 | 解释 |
---|---|
openSession() | 会默认开启一个事务,但事务不会自动提交,也就意味着需要手动提交该事务,更新操作数据才会持久化到数据库中 |
openSession(boolean autoCommit) | 参数为是否自动提交,如果设置为true,那么不需要手动提交事务 |
6.3 SqlSession会话对象
SqlSession 实例在 MyBatis 中是非常强大的一个类。在这里你会看到所有执行语句、提交或回滚事务和获取映射器实例的方法。