mybaits快速入门
1 Mybatis概念
MyBatis 是一款优秀的持久层框架,用于简化 JDBC 开发 MyBatis 本是 Apache 的一个开源项目iBatis,
2010年这个项目由apache software foundation 迁移到了google code,并且改名为MyBatis
2013年11月迁移到Github
官网:https://mybatis.org/mybatis-3/zh/index.html
持久层:
负责将数据到保存到数据库的那一层代码。
Java代码作为持久层。而Mybatis就是对jdbc代码进行了封装。
JavaEE三层架构:表现层、业务层、持久层
三层架构在后期会给大家进行讲解,今天先简单的了解下即可。
框架:
框架就是一个半成品软件,是一套可重用的、通用的、软件基础代码模型
在框架的基础之上构建软件编写更加高效、规范、通用、可扩展
Mybatis 优化;
- 硬编码可以配置到配置文件
- 操作繁琐的地方mybatis都自动完成
1创建user表
create database mybatis;
use mybatis;
drop table if exists tb_user;
create table tb_user(
id int primary key auto_increment,
username varchar(20),
password varchar(20),
gender char(1),
addr varchar(30)
);
INSERT INTO tb_user VALUES (1, 'zhangsan', '123', '男', '北京');
INSERT INTO tb_user VALUES (2, '李四', '234', '女', '天津');
INSERT INTO tb_user VALUES (3, '王五', '11', '男', '西安');
1.创建模块,导入坐标
在创建好的模块中的 pom.xml 配置文件中添加依赖的坐标
注意mysql版本
<dependencies>
<!--mybaits依赖 -->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.5</version>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.20</version>
</dependency>
<!--junit 单元测试-->
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.13</version>
<scope>test</scope>
</dependency>
<!-- 添加slf4j日志api -->
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-api</artifactId>
<version>1.7.20</version>
</dependency>
<!-- 添加logback-classic依赖 -->
<dependency>
<groupId>ch.qos.logback</groupId>
<artifactId>logback-classic</artifactId>
<version>1.2.3</version>
</dependency>
<!-- 添加logback-core依赖 -->
<dependency>
<groupId>ch.qos.logback</groupId>
<artifactId>logback-core</artifactId>
<version>1.2.3</version>
</dependency>
</dependencies>
2编写Mybaits核心配置文件
在模块下的 resources 目录下创建mybatis的配置文件 mybatis-config.xml
进入Mybaits官网https://mybatis.net.cn/getting-started.html有代码提示
<?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.cj.jdbc.Driver"/>
<property name="url" value="jdbc:mysql:///mybatis?useSSL=false&serverTimezone=UTC"/>
<property name="username" value="root"/>
<property name="password" value="123321"/>
</dataSource>
</environment>
</environments>
<mappers>
<!--加载映射文件-->
<mapper resource="UserMapper.xml"/>
</mappers>
</configuration>
3.编写sql映射文件
在模块的 resources 目录下创建映射配置文件 UserMapper.xml (命名规则xxxMapper.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">
<!--
namespace:名称空间
-->
<mapper namespace="test">
<!-- id="selectALL" id后内容为唯一标识 resultType="com.itwq.User" 使用代码块 -->
<select id="selectALL" resultType="com.itwq.User">
select * from tb_user;
</select>
</mapper>
4.创建User表
下创建 User类,基础属性的输入和输出
public class User {
private Integer id ;
private String username ;
private String password ;
private String gender ;
private String addr ;
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 getPassword() {
return password;
}
public void setPassword(String password) {
this.password = password;
}
public String getGender() {
return gender;
}
public void setGender(String gender) {
this.gender = gender;
}
public String getAddr() {
return addr;
}
public void setAddr(String addr) {
this.addr = addr;
}
@Override
public String toString() {
return "User{" +
"id=" + id +
", username='" + username + '\'' +
", password='" + password + '\'' +
", gender='" + gender + '\'' +
", addr='" + addr + '\'' +
'}';
}
}
5.编程
Alt + Enter 强制提示
我的sql映射文件的<mapper namespace="test">
,所以后面参数为List<User> users = sqlSession.selectList("test.selectALL");
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;
import java.util.List;
public class MyBaitsDemo {
public static void main(String[] args) throws IOException {
//1. 加载mybatis的核心配置文件,获取 SqlSessionFactory
// String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream("mybatis-config.xml");
//获取SqlSession对象,用它来执行sql
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
SqlSession sqlSession = sqlSessionFactory.openSession();
//参数是一个字符串,该字符串必须是映射配置文件的namespace.id
List<User> users = sqlSession.selectList("test.selectALL");
System.out.println(users);
sqlSession.close();
}
}
解决SQL映射文件的警告提示:
在入门案例映射配置文件中存在报红的情况。问题如下
产生的原因:Idea和数据库没有建立连接,不识别表信息。但它并不影响程序的执行。
解决方式:在Idea中配置MySQL数据库连接。 IDEA中配置MySQL数据库连接 点击IDEA右边框的 Database
,在展开的界面点击 + 选择 Data Source ,再选择 MySQL
成功后可以看到
而此界面就和 navicat 工具一样可以进行数据库的操作。也可以编写SQL语句
以上为普通创建,而Mapper代理开发是以接口进行处理
使用Mapper代理方式,必须满足以下要求:
- 定义与SQL映射文件同名的Mapper接口,并且将Mapper接口和SQL映射文件放置在同一目录下。
- 设置SQL映射文件的namespace属性为Mapper接口全限定名
注意:resource目录创建包要将.
换成/
才可以分级
1:Mapper代理实现
1.1创建mapper接口,一般接口名与类名对应(简单的sql代码可以通过注释执行)
1.2将sql映射文件放到对应目录下,并进行修改
<?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:名称空间,后跟com.itwq.mapper.UserMapper必须为接口的路径
-->
<mapper namespace="com.itwq.mapper.UserMapper">
<!-- id="selectALL" id后内容为唯一标识 resultType="com.itwq.User" 使用代码块 -->
<select id="selectALL" resultType="User">
select * from tb_user;
</select>
</mapper>
2.3因为Mapper接口名称和SQL映射文件名称相同,并在同一目录下,则可以使用包扫描的方式简化SQL映射文件的加载。也就是将核心配置文件的加载映射配置文件的配置修改为
<mappers>
<!--加载sql映射文件-->
<!-- <mapper resource="com/itheima/mapper/UserMapper.xml"/>-->
<!--Mapper代理方式-->
<package name="com.itheima.mapper"/>
</mappers>
在映射配置文件中的 resultType 属性需要配置数据封装的类型(类的全限定名)。而每次这样写是特别麻烦的,Mybatis 提供了类型别名 (typeAliases) 可以简化这部分的书写。
首先需要现在核心配置文件中配置类型别名,也就意味着给pojo包下所有的类起了别名(别名就是类名),不区分大小写。
内容如下:
<typeAliases>
<package name="com.itwq"/>
</typeAliases>
查询所有有时会出现有些内容查询不出来,经过比较是创建类对象时属性名称不一致
解决方法:
1.1起别名as
例如 brand_name as brandName
但由于查询内容过多,我们可以借用sql
片段将重复代码进行提取,id属性值是唯一标识,引用时也是通过该值进行引用。
<sql id="brand_column">
id, brand_name as brandName, company_name as companyName, ordered, description, status
</sql>
<select id="selectAll" resultType="brand">
select
<include refid="brand_column" />
from tb_brand;
</select>
1.2 使用resultMap解决上述问题
起别名 + sql片段的方式可以解决上述问题,但是它也存在问题。如果还有功能只需要查询部分字段,而不是查询所有字段,那么我们就需要再定义一个 SQL 片段,这就显得不是那么灵活。
那么我们也可以使用resultMap来定义字段和属性的映射关系的方式解决上述问题。
<resultMap id="brandResultMap" type="brand">
<!--
id:完成主键字段的映射
column:表的列名
property:实体类的属性名
result:完成一般字段的映射
column:表的列名
property:实体类的属性名
-->
<result column="brand_name" property="brandName"/>
<result column="company_name" property="companyName"/>
</resultMap>
<select id="selectAll" resultMap="brandResultMap">
select *
from tb_brand;
</select>