mybatis1.0

mybatis

1.1什么是MyBatis

• MyBatis 是一款优秀的持久层框架
• MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的过程
• MyBatis 可以使用简单的 XML 或注解来配置和映射原生信息，将接口和 Java 的 实体类 【Plain Old Java Objects,普通的 Java对象】映射成数据库中的记录。
• MyBatis 本是apache的一个开源项目ibatis, 2010年这个项目由apache 迁移到了google code，并且改名为MyBatis 。
• 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层 【DAO (Data Access Object) 数据访问对象】

大多数情况下特别是企业级应用，数据持久化往往也就意味着将内存中的数据保存到磁盘上加以固化，而持久化的实现过程则大多通过各种关系数据库来完成。

不过这里有一个字需要特别强调，也就是所谓的“层”。对于应用系统而言，数据持久功能大多是必不可少的组成部分。也就是说，我们的系统中，已经天然的具备了“持久层”概念？也许是，但也许实际情况并非如此。之所以要独立出一个“持久层”的概念,而不是“持久模块”，“持久单元”，也就意味着，我们的系统架构中，应该有一个相对独立的逻辑层面，专注于数据持久化逻辑的实现.

• 与系统其他部分相对而言，这个层面应该具有一个较为清晰和严格的逻辑边界。【说白了就是用来操作数据库存在的！】

1.4为什么需要mybatis

• Mybatis就是帮助程序猿将数据存入数据库中 , 和从数据库中取数据 .

传统的jdbc操作 , 有很多重复代码块 .比如 : 数据取出时的封装 , 数据库的建立连接等等… , 通过框架可以减少重复代码,提高开发效率 .

• MyBatis 是一个半自动化的ORM框架 (Object Relationship Mapping) -->对象关系映射

MyBatis的优点

• 简单易学：本身就很小且简单。没有任何第三方依赖，最简单安装只要两个jar文件+配置几个sql映射文件就可以了，易于学习，易于使用，通过文档和源代码，可以比较完全的掌握它的设计思路和实现。
• 灵活：mybatis不会对应用程序或者数据库的现有设计强加任何影响。sql写在xml里，便于统一管理和优化。通过sql语句可以满足操作数据库的所有需求。
• 解除sql与程序代码的耦合：通过提供DAO层，将业务逻辑和数据访问逻辑分离，使系统的设计更清晰，更易维护，更易单元测试。sql和代码的分离，提高了可维护性。
• 提供xml标签，支持编写动态sql。

最重要的一点，使用的人多！公司需要！

2、第一个mybatis程序

思路流程：搭建环境–>导入Mybatis—>编写代码—>测试

搭建数据库
create database mybatis
use mybatis
create table user (id int not null primary key ,name varchar(10) default null,pwd varchar (10) default null)engine =innodb default charset = utf8
insert into user (id ,name ,pwd )values (1,‘杨亭’,‘123’);
insert into user (id ,name ,pwd )values (2,‘张彬’,‘456’);
insert into user (id ,name ,pwd )values (3,‘萍’,‘789’);
select * from user

2.1新建项目

1.新建一个普通的maven项目

2.删除src目录

3.导入maven依赖

<dependencies>
<!--mybatis-->
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis</artifactId>
        <version>3.5.2</version>
    </dependency>
    <!--mysql驱动-->
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>5.1.49</version>
    </dependency>
    <!--junit-->
    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>3.8.2</version>
    </dependency>
</dependencies>

<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>

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?userSSL=true&amp;userUnicode=true&amp;characterEncoding=UTF-8"/>
                <property name="username" value="root"/>
                <property name="password" value="123456"/>
            </dataSource>
        </environment>
    </environments>
    <!--每一个Mapper.xml都需要Mybatis核心配置文件中注册-->
    <mappers>
        <mapper resource="com/leitao/dao/UserMapper.xml"/>
    </mappers>
</configuration>

编写mybatis工具类

//工具类SqlSessionFactory
public class MybatisUtils {
    public 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 提供了在数据库执你可以通过 SqlSession 实例来直接执行已映射的 SQL 语句。行 SQL 命令所需的所有方法。
    public static SqlSession getSqlSession(){
        return sqlSessionFactory.openSession();
    }
}

2.3编写代码

• 实体类

//实体类
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();
}

接口实现类,有原来的UserDaoImpl转表为一个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.leitao.dao.UserDao">
    <!--查询语句-->
    <select id="getUserlist" resultType="com.leitao.pojo.User">
        select * from mybatis.user
    </select>
</mapper>

2.4测试

 @Test
    public void test(){
        //第一步：获取sqlSession对象
        SqlSession sqlSession = MybatisUtils.getSqlSession();
        //方式1：执行sql
        UserDao mapper = sqlSession.getMapper(UserDao.class);
        List<User> userlist = mapper.getUserlist();
        for (User user:userlist){
            System.out.println(user);
        }
        //关闭sqlSession
        sqlSession.close();
    }

3. CRUD

3.1 namespace

namespace中的包名要和Dao/Mapper接口的包名一致

3.2 select

选择，查询语句；

• id：就是对应的namespace中的方法名
• resultType:sql语句执行的返回值
• parameterType:参数类型

1、编写接口

//根据ID查询
    User getUserByID(int id);

2、编写对应的mapper中的sql语句

<select id="getUserByID" parameterType="int" resultType="com.leitao.pojo.User">
        select * from mybatis.user where id = #{id}
    </select>

3、测试

• 注意点：增删改需要提交事务！！！

@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.3 INSERT

<!--对象中的属性可以直接取出来-->
<insert id="addUser" parameterType="com.leitao.pojo.User" >
    insert into mybatis.user value (#{id},#{name},#{pwd})
</insert>

<!--对象中的属性可以直接取出来-->
<insert id="addUser" parameterType="com.leitao.pojo.User" >
    insert into mybatis.user value (#{id},#{name},#{pwd})
</insert>

3.4 UPDATE

<update id="updateUser" parameterType="int" >
    update mybatis.user set name=#{name} , pwd=#{pwd} where id=#{id}
</update>

3.5 DELETE

<delete id="deleteUser" parameterType="com.leitao.pojo.User" >
    delete from mybatis.user where id =#{id}
</delete>

使用万能的Map

1、在接口方法中，参数直接传递Map；

User selectUserByNP2(Map<String,Object> map);

2、编写sql语句的时候，需要传递参数类型，参数类型为map

<select id="selectUserByNP2" parameterType="map" resultType="com.kuang.pojo.User">
  select * from user where name = #{username} and pwd = #{pwd}
</select>

3、在使用方法的时候，Map的 key 为 sql中取的值即可，没有顺序要求！

Map<String, Object> map = new HashMap<String, Object>();
map.put("username","小明");
map.put("pwd","123456");
User user = mapper.selectUserByNP2(map);

总结：如果参数过多，我们可以考虑直接使用Map实现，如果参数比较少，直接传递参数即可

模糊查询like语句该怎么写?

第1种：在Java代码中添加sql通配符。

string wildcardname = “%smi%”;
list<name> names = mapper.selectlike(wildcardname);
 
<select id=”selectlike”>
 select * from foo where bar like #{value}
</select>

第2种：在sql语句中拼接通配符，会引起sql注入

string wildcardname = “smi”;
list<name> names = mapper.selectlike(wildcardname);
 
<select id=”selectlike”>
     select * from foo where bar like "%"#{value}"%"
</select>

4、错误分析

• 标签不要配错

• resource 绑定mapper，需要使用路径///

• 程序配置文件必须正确

• 空指针异常，没有注册到资源

• 输出的xml文件出现中文乱码

• 在build中配置resources,来防止我们资源导致失败问题
  maven资源没有导出问题

5、配置解析

MyBatis 的配置文件包含了会深深影响 MyBatis 行为的设置和属性信息。 配置文档的顶层结构如下：

MyBatis 的配置文件包含了会深深影响 MyBatis 行为的设置和属性信息。 配置文档的顶层结构如下：

configuration（配置）
properties（属性）
settings（设置）
typeAliases（类型别名）
typeHandlers（类型处理器）
objectFactory（对象工厂）
plugins（插件）
environments（环境配置）
environment（环境变量）
transactionManager（事务管理器）
dataSource（数据源）
databaseIdProvider（数据库厂商标识）
mappers（映射器）
<!-- 注意元素节点的顺序！顺序不对会报错 -->

5.1properties优化

数据库这些属性都是可外部配置且可动态替换的，既可以在典型的 Java 属性文件中配置，亦可通过 properties 元素的子元素来传递。

• 第一步 ; 在资源目录下新建一个db.properties

driver=com.mysql.jdbc.Driver
url=jdbc:mysql://localhost:3306/mybatis?userSSL=true&userUnicode=true&characterEncoding=UTF-8
username=root
password=123456

• 第二步 : 将文件导入properties 配置文件

<!--configuration核心配置文件-->
<configuration>
    <!--引入外部配置文件-->
    <properties resource="db.properties"/>

    <environments default="development">
        <environment id="development">
            <transactionManager type="JDBC"/>
            <dataSource type="POOLED">
                <property name="driver" value="${driver}"/>
                <property name="url" value="${url}"/>
                <property name="username" value="${username}"/>
                <property name="password" value="${password}"/>
            </dataSource>
        </environment>
    </environments>
    <!--每一个Mapper.xml都需要Mybatis核心配置文件中注册-->
    <mappers>
        <mapper resource="com/leitao/dao/UserMapper.xml"/>
    </mappers>
</configuration>

5.2typeAliases优化（别名）

类型别名是为 Java 类型设置一个短的名字。

它只和 XML 配置有关，存在的意义仅在于用来减少类完全限定名的冗余。

<!--给实体类起别名-->
    <typeAliases>
        <typeAlias type="com.leitao.pojo.User" alias="user"/>
    </typeAliases>

当这样配置时，User可以用在任何使用com.kuang.pojo.User的地方。

也可以指定一个包名，MyBatis 会在包名下面搜索需要的 Java Bean，比如:

<typeAliases>
        <package name="com.leitao.pojo"/>
    </typeAliases>

在实体类比较少的时候使用第一个，多的话就第二个。

第一中可以DIY起别名，第二种不行，如果一定要改，需要在实体类上增加注解。

//实体类
@Alias("hello")
public class User {

5.3settings设置

• 懒加载

• 日志实现

• 缓存开启关闭

• 一个配置完整的 settings 元素的示例如下：

<settings>
  <setting name="cacheEnabled" value="true"/>
  <setting name="lazyLoadingEnabled" value="true"/>
  <setting name="multipleResultSetsEnabled" value="true"/>
  <setting name="useColumnLabel" value="true"/>
  <setting name="useGeneratedKeys" value="false"/>
  <setting name="autoMappingBehavior" value="PARTIAL"/>
  <setting name="autoMappingUnknownColumnBehavior" value="WARNING"/>
  <setting name="defaultExecutorType" value="SIMPLE"/>
  <setting name="defaultStatementTimeout" value="25"/>
  <setting name="defaultFetchSize" value="100"/>
  <setting name="safeRowBoundsEnabled" value="false"/>
  <setting name="mapUnderscoreToCamelCase" value="false"/>
  <setting name="localCacheScope" value="SESSION"/>
  <setting name="jdbcTypeForNull" value="OTHER"/>
  <setting name="lazyLoadTriggerMethods" value="equals,clone,hashCode,toString"/>
</settings>

5.4映射器（mappers）

MapperRegistry:注册绑定我们的Mapper文件；

方式一：【推荐使用】

<!--每一个Mapper.xml都需要Mybatis核心配置文件中注册-->
<mappers>
    <mapper resource="com/leitao/dao/UserMapper.xml"/>
</mappers>

方式二：使用class文件绑定注册

<mappers>
        <mapper class="com.leitao.dao.UserMapper"/>
    </mappers>

注意点：

• 接口和它的Mapper配置文件必须同名！
• 接口和它的Mapper配置文件必须在同一个包下！

方式三：使用扫描包进行诸如绑定

<mappers>
    <package name="com.leitao.dao"/>
</mappers>

注意点：

• 接口和它的Mapper配置文件必须同名！
• 接口和它的Mapper配置文件必须在同一个包下！

6、生命周期和作用域

生命周期和作用域，是至关重要的，因为错误的使用会导致非常严重的并发问题。

SqlSessionFactoryBuilder:

• 一旦创建了SQLSessionFactoryBuilder，就不需要它了
• 局部变量

SqlSessionFactory:

• 可以想像是：数据连接池
• SQLSessionFactory一旦被创建就应该在应用的运行期间一直存在，没有任何理由丢弃它或重新创建另一个实例
• 因此SQLSessionFactory的最佳作用域是应用作用域
• 最简单的就是使用单例模式或者静态单例模式 .

SqlSession：

• 连接到连接池的一个请求！
• SQLSession的实例不是线程安全的，因此是不能被共享的，所以他的最佳作用域是请求或方法作用域。
• 用完之后需要赶紧关闭，否则资源被占用

7、解决属性名和字段名不一致的问题

7.1问题

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-pe9USWoq-1636351224342)(C:\Users\Administrator\AppData\Roaming\Typora\typora-user-images\1634534757718.png)]

数据库中的字段和实现类中的属性不一样

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-xrsPXHrx-1636351224363)(C:\Users\Administrator\AppData\Roaming\Typora\typora-user-images\1634534827598.png)]

测试出现问题

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-mA20jbe8-1636351224364)(C:\Users\Administrator\AppData\Roaming\Typora\typora-user-images\1634535001675.png)]

解决方法：

• 起别名

<select id="getUserById" resultType="user">
    select id,name as username,pwd as password from mybatis.user where id =#{id}
</select>

7.2ResultMap

结果集映射

id    name       pwd
id    username   password

 <!--结果集映射-->
<resultMap id="UserMap" type="User">
    <!--column数据库中的字段，property实体类中的属性-->
    <result column="id" property="id"/>
    <result column="name" property="username"/>
    <result column="pwd" property="password"/>
</resultMap>
 <select id="getUserById" resultMap="UserMap">
     select * from mybatis.user where id =#{id}
 </select>

8、日志

8.1日志工厂

日志是很好的排错助手

• SLF4J
• LOG4J【掌握】
• JDL_LOGGING
• COMMONS_LOGGING
• STDOUT_LOGGING【掌握】
• NO_LOGGING

在Mybatis中具体使用哪个日志实现，在设置中设定！

8.2STDOUT_LOGGING

在核心配置文件中mybatis-config.xml配置

<!--标准日志工厂实现-->
<settings>
    <setting name="logImpl" value="STDOUT_LOGGING"/>
</settings>

8.3LOG4J

什么是LOG4J?

• Log4j是Apache的一个开源项目，通过使用Log4j，我们可以控制日志信息输送的目的地是控制台、文件、GUI组件
• 可以控制每一条日志的输出格式
• 通过定义每一条日志信息的级别，我们能够更加细致地控制日志的生成过程
• 可以通过一个配置文件来灵活地进行配置，而不需要修改应用的代码

1.首先导包

该模块下的pom.xml文件

<!-- https://mvnrepository.com/artifact/log4j/log4j -->
<dependency>
    <groupId>log4j</groupId>
    <artifactId>log4j</artifactId>
    <version>1.2.17</version>
</dependency>

2.log4j.properties

#将等级为DEBUG的日志信息输出到console和file这两个目的地，console和file的定义在下面的代码
log4j.rootLogger=DEBUG,console,file

#控制台输出的相关设置
log4j.appender.console = org.apache.log4j.ConsoleAppender
log4j.appender.console.Target = System.out
log4j.appender.console.Threshold=DEBUG
log4j.appender.console.layout = org.apache.log4j.PatternLayout
log4j.appender.console.layout.ConversionPattern=[%c]-%m%n

#文件输出的相关设置
log4j.appender.file = org.apache.log4j.RollingFileAppender
log4j.appender.file.File=./log/leitao.log
log4j.appender.file.MaxFileSize=10mb
log4j.appender.file.Threshold=DEBUG
log4j.appender.file.layout=org.apache.log4j.PatternLayout
log4j.appender.file.layout.ConversionPattern=[%p][%d{yy-MM-dd}][%c]%m%n

#日志输出级别
log4j.logger.org.mybatis=DEBUG
log4j.logger.java.sql=DEBUG
log4j.logger.java.sql.Statement=DEBUG
log4j.logger.java.sql.ResultSet=DEBUG
log4j.logger.java.sql.PreparedStatement=DEBUG

3.配置log4j为日志实现

<settings>
        <!--标准日志工厂实现-->
        <setting name="logImpl" value="LOG4J"/>
    </settings>

4.log4j的使用，运行

简单使用

1.在使用log4j的类中，导入包import org.apache.log4j.Logger;

2.日志对象，参数为当前类的class

static Logger logger = Logger.getLogger(UserDaoTest.class);

3.日志级别

@Test
public void testLog4j(){
    logger.info("info：进入了testLog4j");
    logger.debug("debug：进入了testLog4j");
    logger.error("error：进入了testLog4j");
}