目录
1 Mybatis简介
环境说明:
- jdk 8 +
- MySQL 5.7.19
- maven-3.6.0
- IDEA
预备知识:
- JDBC
- MySQL
- Java 基础
- Maven
- Junit
1.1 定义
- MyBatis 是一款优秀的持久层框架
- MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的过程
- MyBatis 可以使用简单的 XML 或注解来配置和映射原生信息,将接口和 Java 的 实体类 【
POJO
(Plain Old Java Objects),普通的 Java对象】映射成数据库中的记录。 - MyBatis 本是apache的一个开源项目ibatis, 2010年这个项目由apache 迁移到了google code,并且改名为MyBatis 。
- 2013年11月迁移到Github .
- Mybatis官方文档 : http://www.mybatis.org/mybatis-3/zh/index.html
- GitHub : https://github.com/mybatis/mybatis-3
1.2 持久化
持久化是将程序数据在持久状态和瞬时状态间转换的机制。把数据(如内存中的对象)保存到可永久保存的存储设备中(如磁盘)。持久化的主要应用是将内存中的对象存储在数据库中,或者存储在磁盘文件中、XML数据文件中等等。
JDBC就是一种持久化机制。文件IO也是一种持久化机制。
为什么需要持久化服务呢?
内存断电后数据会丢失,但有一些对象是无论如何都不能丢失的,所以会出现持久化机制。
1.3 持久层
完成持久化工作的代码块称之为 “持久层”(dao (Data Access Object) 数据访问对象)。
数据持久化往往也就意味着将内存中的数据保存到磁盘上加以固化,而持久化的实现过程则大多通过各种关系数据库来完成。
所谓的“层”。对于应用系统而言,数据持久层大多是必不可少的组成部分。
在我们的系统架构中,会一个相对独立的逻辑层面,专著于数据持久化逻辑的实现。
而对于系统其他方面而言,这个层面会有着一个较为清晰和严格的数据逻辑边界,用来操作数据的存在。
※与数据库进行交互。
1.4 为什么需要Mybatis
- Mybatis就是帮助程序猿将数据存入数据库中 , 和从数据库中取数据.
- 传统的jdbc,会出现许多重复代码:数据取出的封装,数据库的建立连接,使用框架可以减少此类相关重复代码的出现。
- Mybatis 是一个半自动化的ORM(Object Rekationship Mapping)框架。(对象映射关系)。
- 使用Mybatis机制,可以将许多雍余的代码简单化。
2 依赖配置
搭建实验数据库
CREATE DATABASE `mybatis`;
USE `mybatis`;
DROP TABLE IF EXISTS `user`;
CREATE TABLE `user` (
`id` int(20) NOT NULL,
`name` varchar(30) DEFAULT NULL,
`pwd` varchar(30) DEFAULT NULL,
PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;
insert into `user`(`id`,`name`,`pwd`) values (1,'狂神','123456'),(2,'张三','abcdef'),(3,'李四','987654');
导入MyBatis相关 jar 包
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.2</version>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>5.1.47</version>
</dependency>
编写MyBatis核心配置文件:配置JDBC
<?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"/>
<property name="username" value="root"/>
<property name="password" value="123456"/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="com/sts/dao/userMapper.xml"/>
</mappers>
</configuration>
编写MyBatis工具类
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 {
String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
} catch (IOException e) {
e.printStackTrace();
}
}
//获取SqlSession连接
public static SqlSession getSession(){
return sqlSessionFactory.openSession();
}
}
创建实体类
public class User {
private int id; //id
private String name; //姓名
private String pwd; //密码
//构造,有参,无参
//set/get
//toString()
}
编写Mapper接口类
import com.sts.pojo.User;
import java.util.List;
public interface UserMapper {
List<User> selectUser();
}
编写Mapper.xml配置文件
※Mybatis核心处理功能地方,namespace非常重要
<?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="com.sts.dao.UserMapper">
<select id="selectUser" resultType="com.sts.pojo.User">
select * from user
</select>
</mapper>
测试类(Junit)
public class MyTest {
@Test
public void selectUser() {
SqlSession session = MybatisUtils.getSession();
//方法一:
//List<User> users = session.selectList("com.sts.mapper.UserMapper.selectUser");
//方法二:
UserMapper mapper = session.getMapper(UserMapper.class);
List<User> users = mapper.selectUser();
for (User user: users){
System.out.println(user);
}
session.close();
}
}
3 CRUD
namespace
namespace的名称对应的Mapper接口或是Dao,都是完整的包名,必须一致!
Dao层是进行与数据库关联的持久层。
select (查询用户数据)
select标签是mybatis中最常用的标签之一
select语句有很多属性 可以详细配置每一条的SQL语句
- id
- 命名空间中的唯一标识符;
- 接口的方法名与映射文件中的SQL语句ID交相对应
- parameterType
- 传入SQL语句的参数类型 。【万能的Map,可以多尝试使用】
- resultType
- SQL语句返回值类型。【完整的类名或者别名】
UserMapper.java
- SQL语句返回值类型。【完整的类名或者别名】
public interface UserMapper {
//查询全部用户
List<User> selectUser();
//根据id查询用户
User selectUserById(int id);
}
在UserMapper.xml中添加Select语句
<select id="selectUserById" resultType="com.sts.pojo.User">
select * from user where id = #{id}
</select>
编辑测试类
@Test
public void tsetSelectUserById() {
SqlSession session = MybatisUtils.getSession(); //获取SqlSession连接
UserMapper mapper = session.getMapper(UserMapper.class);
User user = mapper.selectUserById(1);
System.out.println(user); // 打印SQL查询出来的数据
session.close(); // 关闭session
}
※传值方式:
于方法中传值
在接口方法的参数前加 @Param
属性
Sql语句编写的时候,直接取@Param
中设置的值即可,不需要单独设置参数类型
//通过密码和名字查询用户
User selectUserByNP(@Param("username") String username,@Param("pwd") String pwd);
/* --查询语句的sql
<select id="selectUserByNP" resultType="com.kuang.pojo.User">
select * from user where name = #{username} and pwd = #{pwd}
</select>
*/
使用Map传值
在接口方法中,参数直接传递Map;
User selectUserByNP2(Map<String,Object> map);
编写sql语句的时候,需要传递参数类型,parameterType
参数类型为map
<select id="selectUserByNP2" parameterType="map" resultType="com.sts.pojo.User">
select * from user where name = #{username} and pwd = #{pwd}
</select>
在使用方法的时候,Map的 key 为 sql中取的数值。
Map<String, Object> map = new HashMap<String, Object>();
map.put("username","小明"); //前往sql中进行赋值的username
map.put("pwd","123456"); //前往sql中进行赋值的pwd
User user = mapper.selectUserByNP2(map);
注意:如果在使用sql的时候,进行传值的参数过多,可以使用Map实现,如果参数较少,直接传递参数即可。
insert (插入用户信息)
使用insert标签的时候,我们一般进行插入操作,相关配置与select标签一致。
有点需要注意的是:insert、update、delect都是需要进行事务操作,进行commit
操作
在UserMapper接口中添加对应的方法
//添加一个用户
int addUser(User user);
在UserMapper.xml中添加insert语句
<insert id="addUser" parameterType="com.sts.pojo.User">
insert into user (id,name,pwd) values (#{id},#{name},#{pwd})
</insert>
junit测试
@Test
public void testAddUser() {
SqlSession session = MybatisUtils.getSession();
UserMapper mapper = session.getMapper(UserMapper.class);
User user = new User(5,"王五","zxcvbn");
int i = mapper.addUser(user);
System.out.println(i);
session.commit(); //提交事务,重点!不写的话不会提交到数据库
session.close();
}
update (更新用户数据)
//修改一个用户 User集合对象
int updateUser(User user);
<update id="updateUser" parameterType="com.sts.pojo.User">
update user set name=#{name},pwd=#{pwd} where id = #{id}
</update>
@Test
public void testUpdateUser() {
SqlSession session = MybatisUtils.getSession();
UserMapper mapper = session.getMapper(UserMapper.class);
User user = mapper.selectUserById(1);
user.setPwd("asdfgh");
int i = mapper.updateUser(user);
System.out.println(i);
session.commit(); //提交事务,重点!不写的话不会提交到数据库
session.close();
}
delect(删除用户数据)
//删除一个用户 id 单一条件
int deleteUser(int id);
<delete id="deleteUser" parameterType="int">
delete from user where id = #{id}
</delete>
@Test
public void testDeleteUser() {
SqlSession session = MybatisUtils.getSession();
UserMapper mapper = session.getMapper(UserMapper.class);
int i = mapper.deleteUser(5);
System.out.println(i);
session.commit(); //提交事务,重点!不写的话不会提交到数据库
session.close();
}
总结
- 所有的数据有所更新数据库操作的场合都要 提交事务;
- 接口所有的普通参数,尽量都写上
@Parmam
,尤其是传输多个参数的场合; - 有时因为业务需要,使用
map
进行传递参数; - 为相关规范,在SQL的配置中,我们应尽量将
Parameter
和resultType
这两个参数都写上。
拓展
like操作: 模糊查询的操作方式
在java中加入sql通配符
string wildcardname = “%smi%”;
list<name> names = mapper.selectlike(wildcardname);
<select id=”selectlike”>
select * from foo where bar like #{value}
</select>
string wildcardname = “smi”;
list<name> names = mapper.selectlike(wildcardname);
在sql中拼接通配符
<select id=”selectlike”>
select * from foo where bar like "%"#{value}"%"
</select>