Mybatis
一、简介
1.1 如何获得?
-
Maven仓库
<!-- https://mvnrepository.com/artifact/org.mybatis/mybatis --> <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis</artifactId> <version>3.5.2</version> </dependency>
-
中文文档:https://mybatis.org/mybatis-3/zh/index.html
1.2 持久化
数据持久化
-
持久化就是将程序的数据在持久状态和瞬时状态转化的过程
-
内存:断电即失
-
数据库(JDBC),io文件持久化。
-
生活:冷藏,罐头。
为什么需要持久化?
- 有一些对象,不能让他丢掉。
- 内存太贵了
1.3 持久层
Dao层,Service层,Controller层…
- 完成持久化工作的代码块
- 层界限十分明显。
1.4 为什么需要Mybatis?
-
帮助程序员将数据存入到数据库中
-
方便
-
传统的JDBC代码太复杂了,简化,框架。
-
优点:
- 简单易学
- 灵活
- sql和代码分离,提高了可维护性
- 提供映射标签,支持对象与数据库的orm字段关系映射
- 提供对象关系映射标签,支持对象关系组件维护
- 提供xml标签,支持编写动态sql
最重要的一点:使用的人多!
二、第一个Mybatis程序
思路:搭建环境->导入Mybatis->编写代码–>测试
2.1 搭建环境
搭建数据库
CREATE DATABASE `mybatis`;
USE `mybatis`;
CREATE TABLE `user`(
`id` INT(20) NOT NULL PRIMARY KEY,
`name` VARCHAR(30) DEFAULT NULL,
`pwd` VARCHAR(30) DEFAULT NULL
)ENGINE=INNODB DEFAULT CHARSET=utf8;
INSERT INTO `user`(`id`,`name`,`pwd`) VALUES
(1,'zsf','123445'),(2,'掌声','2314'),(3,'历史','2131232')
新建项目
-
新建一个普通的maven项目
-
删除src目录
-
导入maven依赖
<!-- 导入依赖--> <dependencies> <!-- mysql驱动--> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>5.1.47</version> </dependency> <!-- mybatis--> <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis</artifactId> <version>3.5.2</version> </dependency> <!-- Junit--> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <version>4.12</version> </dependency> </dependencies>
2.2 创建一个模块
- 编写mybatis的核心配置文件
<?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核心配置文件-->
<configuration>
<environments default="development">
<environment id="development">
<transactionManager type="JDBC"/>
<dataSource type="POOLED">
<property name="driver" value="com.mysql.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://localhost:3306/mybatis?useSSL=true&useUnicode=true&characterEncoding=UTF-8"/>
<property name="username" value="root"/>
<property name="password" value="root"/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="org/mybatis/example/BlogMapper.xml"/>
</mappers>
</configuration>
- 编写mybatis工具类
//工具类sqlSessionFactory --> sqlSession
public class MybatisUtils {
//提升作用域
private static SqlSessionFactory sqlSessionFactory;
static {
try {
//使用Mybatis,第一步获取sqlSessionFactory对象
String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
} catch (IOException e) {
e.printStackTrace();
}
}
//既然有了 SqlSessionFactory,顾名思义,我们可以从中获得 SqlSession 的实例。
// SqlSession 提供了在数据库执行 SQL 命令所需的所有方法。
// 你可以通过 SqlSession 实例来直接执行已映射的 SQL 语句。
public static SqlSession getSqlSession(){
return sqlSessionFactory.openSession();
}
}
2.3 编写代码
- 实体类
package com.zsf.pojo;
public class User {
private int id;
private String name;
private String pwd;
public User() {
}
public User(int id, String name, String pwd) {
this.id = id;
this.name = name;
this.pwd = pwd;
}
public int getId() {
return id;
}
public void setId(int id) {
this.id = id;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public String getPwd() {
return pwd;
}
public void setPwd(String pwd) {
this.pwd = pwd;
}
@Override
public String toString() {
return "User{" +
"id=" + id +
", name='" + name + '\'' +
", pwd='" + pwd + '\'' +
'}';
}
}
- Dao接口
//用来操控数据库
public interface UserDao {
List<User> getUserList();
}
- 接口实现类(由原来的UserDaoImp转换为一个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">
<!--namespace=绑定一个对应的Dao/Mapper接口-->
<mapper namespace="com.zsf.dao.UserDao">
<select id="getUserList" resultType="com.zsf.pojo.User">
select * from mybatis.user where id = #{id}
</select>
</mapper>
2.4 测试
- 获得SqlSession对象
- 执行SQL
- 执行接口里的方法
- 关闭SqlSessiopn
org.apache.ibatis.exceptions.PersistenceException:
资源导出问题:
<!--在build中配置resources,来防止我们资源导出失败的问题-->
<build>
<resources>
<resource>
<directory>src/main/resources</directory>
<includes>
<include>**/*.properties</include>
<include>**/*.xml</include>
</includes>
<filtering>false</filtering>
</resource>
<resource>
<directory>src/main/java</directory>
<includes>
<include>**/*.properties</include>
<include>**/*.xml</include>
</includes>
<filtering>false</filtering>
</resource>
</resources>
</build>
MapperRegistry是什么?
核心配置文件中注册mapper。
public class UserDaoTest {
@Test
public void test(){
//获得SqlSession对象
SqlSession sqlSession = MybatisUtils.getSqlSession();
//执行SQL
UserDao mapper = sqlSession.getMapper(UserDao.class);
//执行接口里的方法
List<User> userList = mapper.getUserList();
for (User user : userList) {
System.out.println(user);
}
//关闭SqlSessiopn
sqlSession.close();
}
}
可能遇到的问题:
- 配置文件没有注册
- 绑定接口错误
- 方法名不对
- 返回类型不对
- Maven导出资源问题
- 先搭建数据库,导入需要的mysql和mybatis的jar包依赖,
- 构造工具类MybatisUtils,获取工厂的三行代码集成到公共类,编写mybatis的配置文件mybatis-config.xml(放在resources里面),
- 在配置文件里面先连接数据库,注意每一个Mapper.xm都需要在Mybatis的核心配置文件中注册!(也就是UserMapper.xml),
- 再去写实体类User.java,
- 再写接口UserDao.java。
- 再写Mybatis的核心配置文件UserMapper.xml:namespace绑定写好的接口UserDao,在写sql语句,id绑定里面的方法(接口里面的),标签体就专注于sql,返回值类型专注于实体类。
- 最后写测试代码。
三、CRUD
注意:实体类pojo和工具类utils就不需要再变了,操作的只是接口和UserMapper
1、namespace
namespace中的包名要和Dao/mapper接口包名一致!
2、select
选择,查询语句;
- id:就是对应的namespace中的方法名
- resultType:Sql语句执行的返回值!
- parameterType
-
编写接口
//根据id查询用户 User getUserById(int id);
-
编写对应的mapper中的sql语句
<select id="getUserById" parameterType="int" resultType="com.zsf.pojo.User"> select * from mybatis.user where id = #{id}; </select>
-
测试
@Test public void getUserById(){ SqlSession sqlSession = MybatisUtils.getSqlSession(); UserMapper mapper = sqlSession.getMapper(UserMapper.class); User user = mapper.getUserById(1); System.out.println(user); sqlSession.close(); }
3、Insert
<!-- 对象中的属性可以直接取出来-->
<insert id="addUser" parameterType="com.zsf.pojo.User">
insert into mybatis.user (id,name,pwd) values (#{id},#{name},#{pwd})
</insert>
4、update
<update id="updateUser" parameterType="com.zsf.pojo.User">
update mybatis.user set name=#{name},pwd=#{pwd} where id=#{id};
</update>
5、Delete
<delete id="deleteUser" parameterType="int">
delete from mybatis.user where id = #{id}
</delete>
注意点:
- 增删改需要提交事务
6、分析错误
- 标签不要匹配错
- resource绑定mapper,需要使用路径
- 程序配置文件必须符合规范
- NullPointerException,没有注册到资源
- 输出的xml文件中存在乱码问题!
- Maven资源没有导出
7、万能的Map
假设,我们的实体类,或者数据库中的表、字段或者参数过多,我们应当考虑使用Map!
Map传递参数,直接在sql中取出key即可!parameterType=“map”
对象传递参数,直接在sql中取对象的属性即可!parameterType=“Object”
只有一个基本类型参数的情况下,可以直接在sql中取到。
多个参数用Map,或者注解!
//用Mapinsert一个用户
int addUser2(Map<String,Object> map);
<!-- 用Map-->
<insert id="addUser2" parameterType="map">
insert into mybatis.user (id,pwd) values (#{username},#{password})
</insert>
@Test
public void addUser2(){
SqlSession sqlSession = MybatisUtils.getSqlSession();
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
Map<String, Object> map = new HashMap<String, Object>();
map.put("username",3);
map.put("password","123123");
mapper.addUser2(map);
sqlSession.commit();
sqlSession.close();
}
8、思考
模糊查询怎么写?
//模糊查询
List<User> getUserLike(String value);
<select id="getUserLike" resultType="com.zsf.pojo.User">
select * from mybatis.user where name like #{value}
</select>
@Test
public void getUserLike(){
SqlSession sqlSession = MybatisUtils.getSqlSession();
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
List<User> userList = mapper.getUserLike("%小%");
for (User user : userList){
System.out.println(user);
}
sqlSession.close();
}
这样写不安全,容易产生sql注入。
正确应该这样写:
- Java代码执行的时候,传递通配符%%
List<User> userList = mapper.getUserLike("%小%");
-
在sql拼接中使用通配符!
select * from mybatis.user where name like "%"#{value}"#"
四、配置解析
-
mybatis-config.xml
-
MyBatis的配置文件包含了会深深影响Mybatis行为的设置和属性信息。
configuration(配置) properties(属性) settings(设置) typeAliases(类型别名) typeHandlers(类型处理器) objectFactory(对象工厂) plugins(插件) environments(环境配置) environment(环境变量) transactionManager(事务管理器) dataSource(数据源) databaseIdProvider(数据库厂商标识) mappers(映射器)