前言
一切以官网为准:Mybatis官网
在官网的基础上,作补充说明
建议搞清楚JDBC再来学习Mybatis:真的了解JDBC吗?- JDBC详解
涉及到结果集以及连接流程等知识
概述
Mybatis有中文官网,可以看看Mybatis的官方说明
MyBatis 是一款优秀的持久层框架,它支持自定义 SQL、存储过程以及高级映射。MyBatis 免除了几乎所有的 JDBC 代码以及设置参数和获取结果集的工作。MyBatis 可以通过简单的 XML 或注解来配置和映射原始类型、接口和 Java POJO(Plain Old Java Objects,普通老式 Java 对象)为数据库中的记录
- Mybatis是一款持久层框架(持久层是指该代码层与数据库连接,将程序中的数据保存数据库 - 持久化)
- 支持自定义 SQL、存储过程以及高级映射(结果集与实体类的映射)
- MyBatis 免除了几乎所有的 JDBC 代码以及设置参数和获取结果集的工作(底层封装了JDBC,封装了对数据库的操作)
- MyBatis 可以通过简单的 XML 或注解来配置和映射原始类型、接口和 Java POJO(通过XML配置文件、注解实现连接、操作数据库)
- Mybatis本来是apache的开源项目ibatis,2010年这个项目由apache software foundation 迁移到了google code,并且改名为MyBatis 。2013年11月迁移到Github
- Mybatis是Dao层,将业务逻辑和数据访问逻辑分离
入门
Mybatis作为一个轻量级的框架,使用非常简单
首先,在IDEA创建一个Maven项目
别再手动导包了,使用Maven方便简单
然后新建一个模块(模块化可以在一个项目里完成多种实验)
随便命名
只需要一个Java项目,多模块就可以完成多种独立的环境
- 导包
在项目里的pom.xml中添加依赖(模块与项目是主从关系,项目中有的依赖,模块也可以使用)
需要两个jar包,使用的数据库驱动包和Mybatis包
版本按自己的需要设置
为了方便,设置了两个好用的工具:Junit测试工具、Lombok偷懒工具
junit可以直接@Test测试方法,不需要写main方法,也就可以设置一个测试类,有多种测试方法
关于pojo构建偷懒神器Lombok
<dependencies>
<!--mysql驱动-->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>5.1.44</version>
</dependency>
<!--mybatis-->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.3</version>
</dependency>
<!--junit单元测试-->
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.12</version>
</dependency>
<!--lombok 注解-->
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<version>1.18.10</version>
<scope>provided</scope>
</dependency>
</dependencies>
- 编写核心配置文件
mybatis-config.xml(名字随便取,要是xml文件)
配置数据库连接
后面再将数据库连接分开,现在先直接写在里面
先简单注册一下Mapper.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>
<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=UTF8&serverTimezone=Asia/Shanghai"/>
<property name="username" value="root"/>
<property name="password" value="root"/>
</dataSource>
</environment>
</environments>
<!--每一个mapper.xml都需要在mybatis的核心配置文件注册-->
<mappers>
<mapper resource="com/learn/dao/UserMapper.xml"/>
</mappers>
</configuration>
- 实体类与数据库表
User类:
这里用到了Lombok插件
自己练习时可以使用一下,偷一下懒
package com.learn.pojo;
import lombok.AllArgsConstructor;
import lombok.Data;
@Data
@AllArgsConstructor
public class User {
private int id;
private String name;
private String pwd;
}
数据库表:
create table user
(
id int(20) not null primary key,
name varchar(30) null,
pwd varchar(30) null
)
charset = utf8;
ok,环境设置完了
- 操作数据库dao层(有的叫Mapper,有的叫Dao,都一样的)
UserMapper接口:设置一个查询User表的方法
package com.learn.dao;
import com.learn.pojo.User;
import java.util.List;
public interface UserMapper {
List<User> getUserList();
}
- XML配置文件实现接口:UserMapper
namespace是关联的Mapper接口的接口名
resultType是指输出结果的类型(实体类就需要全名,具体再后面配置文件介绍)
<?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接口-->
<mapper namespace="com.learn.dao.UserMapper">
<select id="getUserList" resultType="com.learn.pojo.User">
select * from mybatis.user
</select>
</mapper>
- 工具类MybatisUtils
Mybatis的使用需要sqlSession,对与读取mybatis-config.xml的操作,全部封装到一个类中(未来集成spring后就不需要了)
package com.learn.util;
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 java.io.IOException;
import java.io.InputStream;
public class MybatisUtils {
private static SqlSessionFactory sqlSessionFactory;
static {
try {
//获取sqlSessionFactory对象
String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
} catch (IOException e) {
e.printStackTrace();
}
}
//创建能执行sql命令的对象SqlSession
public static SqlSession getSqlSession(){
return sqlSessionFactory.openSession();
}
}
- 测试类、junit工具
package com.learn.dao;
import com.learn.pojo.User;
import com.learn.util.MybatisUtils;
import org.apache.ibatis.session.SqlSession;
import org.junit.Test;
import java.util.List;
public class UserMapperTest {
@Test
public void test(){
//获得sqlsession对象
SqlSession sqlSession = MybatisUtils.getSqlSession();
//执行sql
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
List<User> userList = mapper.getUserList();
for (User u : userList){
System.out.println(u);
}
sqlSession.close();
}
}
可以看到,完成了对数据库的操作
如果报错,可以看这个:Mybatis碰到的问题
增删改
前面完成的是查询操作
对于业务处理CRUD(create、Read、Update、Delete),都实现一遍
增删改对应sql就是insert、update、delete
在前面的UserMapper里添加方法(增删改返回值都是int,返回影响的数据条数)
package com.learn.dao;
import com.learn.pojo.User;
import java.util.Map;
import java.util.List;
public interface UserMapper {
List<User> getUserList();
//通过id查找
User getUserById(int id);
//插入数据
int insert(User user);
//修改数据
int update(User user);
//删除数据
int delete(int id);
}
在UserMapper.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接口-->
<mapper namespace="com.learn.dao.UserMapper">
<select id="getUserList" resultType="com.learn.pojo.User">
select * from mybatis.user
</select>
<select id="getUserById" resultType="com.learn.pojo.User" parameterType="int">
select * from mybatis.user where id = #{id}
</select>
<!--User对象间的属性可以直接取出-->
<insert id="insert" parameterType="com.learn.pojo.User">
insert into mybatis.user (id,name,pwd) values (#{id},#{name},#{pwd});
</insert>
<update id="update" parameterType="com.learn.pojo.User">
update mybatis.user set name = #{name},pwd = #{pwd} where id = #{id};
</update>
<delete id="delete" parameterType="int">
delete from mybatis.user where id = #{id};
</delete>
</mapper>
然后在测试类中测试:
package com.learn.dao;
import com.learn.pojo.User;
import com.learn.util.MybatisUtils;
import org.apache.ibatis.session.SqlSession;
import org.junit.Test;
import java.util.HashMap;
import java.util.Map;
import java.util.List;
public class UserMapperTest {
@Test
public void test(){
//获得sqlsession对象
SqlSession sqlSession = MybatisUtils.getSqlSession();
//执行sql
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
List<User> userList = mapper.getUserList();
for (User u : userList){
System.out.println(u);
}
sqlSession.close();
}
@Test
public void getUserById(){
SqlSession sqlSession = MybatisUtils.getSqlSession();
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
User userById = mapper.getUserById(1);
System.out.println(userById);
sqlSession.close();
}
@Test
public void addUser(){
SqlSession sqlSession = MybatisUtils.getSqlSession();
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
int insert = mapper.insert(new User(4, "zhaoliu", "123456"));
sqlSession.commit();
System.out.println(insert);
sqlSession.close();
}
@Test
public void updateUser(){
SqlSession sqlSession = MybatisUtils.getSqlSession();
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
int ww = mapper.update(new User(4, "ww", "123"));
sqlSession.commit();
System.out.println(ww);
sqlSession.close();
}
@Test
public void delete(){
SqlSession sqlSession = MybatisUtils.getSqlSession();
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
int delete = mapper.delete(4);
sqlSession.commit();
System.out.println(delete);
sqlSession.close();
}
}
一个个测试:
getUserById:
delete:
addUser:
updateUser:
需要注意:
- 增删改操作需要提交事务
- 增加时注意主键,别插入相同主键的数据
- 可能出现的错误:找不到Mapper.xml、数据库连接失败、乱码等
可以看这个:Mybatis碰到的问题
关于自动提交事务
增删改操作都是需要提交事务的
前面的执行中都需要sqlSession.commit();
数据库中才能真正的存储数据
设置自动提交事务:
在我们的工具类MybatisUtils中
sqlSessionFactory.openSession(true),参数true就是开启自动提交事务
想深入了解,可以看SqlSessionFactory源码
总结
前面仅仅是完成配置和实现简单的操作,还有很多细节和内部实现需要好好了解
学海无涯苦作舟
看到这里,点个赞呗(^_−)☆