Mybatis 系列全解(1)
- 1. 第一个小程序
- 2. CURD 增删改查
- 3. 模糊查询
- 4. 配置解析
- 4.1 核心配置文件
- 4.2 环境配置
- 4.3 属性
- 4.4 类型别名
- 4.5 设置
- 4.6 映射器 mappers
1. 第一个小程序
1)创建一个数据库,一个表,填入一些数据。(这里不做演示,可以参考我前面写的数据库文章有具体介绍:在介绍DDL数据库操作中有创建数据库代码,链接:DDL数据库操作,或者在介绍数据库的约束中举例介绍了加上约束创建数据库,链接:约束)。
2)新建一个普通的maven项目
3)删除src项目
4)搭建环境
- 在pom.xml中导入依赖:
<dependencies><dependency><groupId>mysql</groupId><artifactId>mysql-connector-java</artifactId><version>5.1.6</version></dependency><dependency><groupId>org.mybatis</groupId><artifactId>mybatis</artifactId><version>3.5.1</version></dependency><dependency><groupId>junit</groupId><artifactId>junit</artifactId><version>4.12</version><scope>test</scope></dependency>
</dependencies>
5)创建一个module模块(子模块)
-
编写mybatis的核心配置文件
在resources下创建mybatics-config.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=UTF-8"/><property name="username" value="root"/><property name="password" value="root"/></dataSource></environment></environments><mappers><mapper resource="com/kuang/dao/UserMapper.xml"/>
</mappers>
</configuration>
注:mappers 标签不写会报错“Type interface com.kuang.dao.UserDao is not known to the MapperRegistry”
- main-java下创建com-kuang-dao pojo 和utils文件夹 在utils下创建工具类MybaticsUtils
package com.kuang.utils;
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 org.apache.ibatis.session.defaults.DefaultSqlSessionFactory;
import java.io.IOException;
import java.io.InputStream;//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命令所需的所有方法
public static SqlSession getSqlSession() {return sqlSessionFactory.openSession();
}
}
-
在pojo下创建User 根据数据库创建有参无参 getter/setter toString等
-
在dao下创建接口UserDao
package com.kuang.dao;
import com.kuang.pojo.User;
import java.util.List;
public interface UserDao {List<User> getUserList();
}
- 在dao下创建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">
<!-- namespace 绑定一个对应的Dao/Mapper接口-->
<mapper namespace="com.kuang.dao.UserDao">
<!--select查询语句-->
<select id="getUserList" resultType="com.kuang.pojo.User">select * from mybatis.user
</select>
</mapper>
resultMap是集合,返回多个 resultType是返回一个。
6)测试(为了工整与创建文件夹一样的格式 )
- UserDaoTest里写入
package com.kuang.dao;
import com.kuang.pojo.User;
import com.kuang.utils.MybatisUtils;
import org.apache.ibatis.session.SqlSession;
import org.junit.Test;
import java.util.List;
public class UserDaoTest {@Testpublic void test(){//第一步 获得sqlsession对象SqlSession sqlSession = MybatisUtils.getSqlSession();//方式一 getMapperUserDao userDao = sqlSession.getMapper(UserDao.class);List<User> userList = userDao.getUserList();for(User user:userList){System.out.println(user);}sqlSession.close();}
}
可能遇到的问题1:Type interface com.kuang.dao.UserDao is not known to the MapperRegistry
因为没有在核心配置文件中配置mapper
可能遇到的问题2:maven资源导出失败的问题。在主模块和子模块的pom.xml中写入:
<build><resources><resource><directory>src/main/java</directory><includes><include>**/*.xml</include><include>**/*.properties</include></includes></resource><resource><directory>src/main/resources</directory><includes><include>**/*.xml</include><include>**/*.properties</include></includes></resource></resources>
</build>
记得刷新maven或者关掉软件再打开。
可能遇到的问题3:绑定接口错误。
可能遇到的问题4:返回类型不对。
可能遇到的问题5:方法名不对。
可能遇到的问题6:resource路径对应的是/分开。
2. CURD 增删改查
1)nameplace
nameplace中的包名必须和Dao/Mapper接口的包名一致。
2)select
选择查询语句。
id:就是对应的nameplace的方法名。
resultType:sql语句执行的返回值。
parameterType:参数类型。
3)增删改查过程:
- 编写接口
//插入一个用户
int addUser(User user);
- 编写对应的mapper中的sql语句(select/insert/delect/update)
<insert id="addUser" parameterType="com.kuang.pojo.User">insert into mybatis.user(id,name,pwd) values (#{id},#{name},#{pwd});
</insert>
- 测试
@Test
public void addUser(){SqlSession sqlSession = MybatisUtils.getSqlSession();UserMapper mapper = sqlSession.getMapper(UserMapper.class);int number = mapper.addUser(new User(4,"王先正","123456"));if (number > 0) {System.out.println("插入成功!");}sqlSession.commit();sqlSession.close();
}
注意: 增删改需要提交事务不然不能改数据库的的内容:sqlSession.commit();
3. 模糊查询
- java代码执行的时候,传递通配符% _
List<User> userList = mapper.getUserLike("%王%");
解析:
中间为王的姓名。
王% 以王开头的姓名 %王 最后为王的姓名 _是一个字符。
- 在sql拼接中使用通配符!!!
<select id="getUserLike" resultType="com.kuang.pojo.User">select * from mybatis.user where name like #{value}"%";
</select>
4. 配置解析
4.1 核心配置文件
-
mybatis.config.xml
-
MyBatis 的配置文件包含了会深深影响 MyBatis 行为的设置和属性信息。
-
configuration(配置)
-
properties(属性)
-
settings(设置)
-
typeAliases(类型别名)
-
typeHandlers(类型处理器)
-
objectFactory(对象工厂)
-
plugins(插件)
-
environments(环境配置)
environment(环境变量)
transactionManager(事务管理器)
tdataSource(数据源) -
databaseIdProvider(数据库厂商标识)
-
mappers(映射器)
4.2 环境配置
-
Mybatis可以配置成适应多种环境
-
尽管可以配置多个环境,但每个sqlsessionfactory实例只能选择一种环境(environments
中default可以选择相关environment的id) -
Mybatis默认的事务管理器就是JDBC 连接池是POOLED
-
学会使用多套运行环境
注意一些关键点:
-
默认使用的环境 ID(比如:default=“development”)。
-
每个 environment 元素定义的环境 ID(比如:id=“development”)。
-
事务管理器的配置(比如:type=“JDBC”)
-
数据源的配置(比如:type=“POOLED”)
默认环境和环境 ID 顾名思义。 环境可以随意命名,但务必保证默认的环境 ID 要匹配其中一个环境 ID。
4.3 属性
-
这些属性可以在外部进行配置,并可以进行动态替换。你既可以在典型的 Java 属性文件中配置这些属性,也可以在 properties元素的子元素中设置。(db.properties)
-
在recourse下编写一个配置文件db.properties
driver=com.mysql.jdbc.Driver
url=jdbc:mysql://localhost:3306/mybatis?useSSL=true&useUnicode=true&characterEncoding=UTF-8
username=root
password=root
- 再把mybatis-config.xml中改为
<property name="driver" value="${driver}"/>
<property name="url" value="${url}"/>
<property name="username" value="${username}"/>
<property name="password" value="${password}"/>
<!--再引入外部配置文件-->
<properties resource="db.properties"/>
一定要按规定的顺序写标签
如果一个属性在不只一个地方进行了配置,那么,MyBatis 将按照下面的顺序来加载:
-
首先读取在 properties 元素体内指定的属性
-
然后根据 properties 元素中的 resource 属性读取类路径下属性文件,或根据 url 属性指定的路径读取属性文件,并覆盖之前读取过的同名属性
-
最后读取作为方法参数传递的属性,并覆盖之前读取过的同名属性
因此,通过方法参数传递的属性具有最高优先级,resource/url 属性中指定的配置文件次之,最低优先级的则是 properties 元素中指定的属性。(外部引用的)
4.4 类型别名
-
类型别名可为 Java 类型设置一个缩写名字。 它仅用于 XML 配置,意在降低冗余的全限定类名书写
-
和propeties标签一样一定要按规则写人
-
typeAlias和package
//为java类型设置一个短名字
<typeAliases>
<typeAlias type="com.kuang.pojo.User" alias="User"/>
//指定一个包名
<package name="com.kuang.pojo" />
在没有注解的情况下,会使用 Bean 的首字母小写的非限定类名来作为它的别名。
第一种可以自定义别名 第二种不行,若非要改则需要在实体上增加注解,使用其注解值。
@Alias("hello")
public class User {
java类型内建的类型别名,不区分大小,采取特殊命名风格:映射类型int–>别名_int 映射类型Integer–>别名int 等。
4.5 设置
这是 MyBatis 中极为重要的调整设置,它们会改变 MyBatis 的运行时行为。
4.6 映射器 mappers
MapperRegistry:注册绑定我们的Mapper文件;
- 方式一 使用相对于类路径的资源引用 (resour测对应/)推荐使用
<mapper resource="com/kuang/dao/UserMapper.xml"/>
- 方式二 使用映射器接口实现类的完全限定类名(class对应。)
<mapper class="com.kuang.dao.UserMapper"/>
注意点:接口和他的Mapper配置文件必须同名!
接口和他的Mapper配置文件必须在同一个包下。
方式三 使用扫描包进行注入绑定
<package name = "com.kuang.dao">
注意点和方式二一样!