mybatis配置解析

此时最好打开https://mybatis.org/mybatis-3/zh/configuration.html

1.核心配置文件

mybatis-config.xml 系统核心配置文件

MyBatis 的配置文件包含了会深深影响 MyBatis 行为的设置和属性信息。

能配置的内容如下：

configuration（配置）
properties（属性）
settings（设置）
typeAliases（类型别名）
typeHandlers（类型处理器）
objectFactory（对象工厂）
plugins（插件）
environments（环境配置）
environment（环境变量）
transactionManager（事务管理器）
dataSource（数据源）
databaseIdProvider（数据库厂商标识）
mappers（映射器）

我们可以阅读 mybatis-config.xml 上面的dtd的头文件！

environments元素

<environments default="development">
 <environment id="development">
   <transactionManager type="JDBC">
     <property name="..." value="..."/>
   </transactionManager>
   <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>

配置MyBatis的多套运行环境，将SQL映射到多个不同的数据库上，必须指定其中一个为默认运行环境（通过default指定）
子元素节点：environment
————————————————————————————————————————————————————
dataSource元素

dataSource 元素使用标准的 JDBC 数据源接口来配置 JDBC 连接对象的资源。

数据源是必须配置的。

有三种内建的数据源类型

type="[UNPOOLED|POOLED|JNDI]"）
unpooled：这个数据源的实现只是每次被请求时打开和关闭连接。

pooled：这种数据源的实现利用“池”的概念将 JDBC 连接对象组织起来 , 这是一种使得并发 Web 应用快速响应请求的流行处理方式。

jndi：这个数据源的实现是为了能在如 Spring 或应用服务器这类容器中使用，容器可以集中或在外部配置数据源，然后放置一个 JNDI 上下文的引用。

数据源也有很多第三方的实现，比如dbcp，c3p0，druid等等…

详情：点击查看官方文档

这两种事务管理器类型都不需要设置任何属性。

具体的一套环境，通过设置id进行区别，id保证唯一！

子元素节点：transactionManager - [ 事务管理器 ]

<!-- 语法 -->
<transactionManager type="[ JDBC | MANAGED ]"/>

子元素节点：数据源（dataSource）
————————————————————————————————————————————————————
Properties优化
数据库这些属性都是可外部配置且可动态替换的，既可以在典型的 Java 属性文件中配置，亦可通过 properties 元素的子元素来传递。具体的官方文档
我们来优化我们的配置文件

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

driver=com.mysql.jdbc.Driver
url=jdbc:mysql://localhost:3306/mybatis?useSSl=false&useUnicode=true&characterEncoding=UTF-8
username=root
password=123

第二步：在核心配置文件中引入
在mybatis-conflg.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核心配置文件-->
<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>
    <!--每一个meapper.Xml都需要在Mybatis核心配置文件中注册-->
    <mappers>
        <mapper resource="com/lyh/dao/UserMapper.xml"/>
    </mappers>
</configuration>

或者可以在properties标签中的子标签property中写一半，在db,properties中写一半
在db,properties中

driver=com.mysql.jdbc.Driver
url=jdbc:mysql://localhost:3306/mybatis?useSSl=false&useUnicode=true&characterEncoding=UTF-8

在properties标签中的子标签property中

<?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>
    <!--引入配置文件-->
    <properties resource="db.properties">
        <property name="username" value="root"/>
        <property name="password" value="123"/>
    </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>
    <!--每一个meapper.Xml都需要在Mybatis核心配置文件中注册-->
    <mappers>
        <mapper resource="com/lyh/dao/UserMapper.xml"/>
    </mappers>
</configuration>

————————————————————————————————————————————————————
类型别名（typeAliases）
类型别名是为 Java 类型设置一个短的名字。它只和 XML 配置有关，存在的意义仅在于用来减少类完全限定名的冗余。
使用方法选择:在实体类比较少时，使用第一种
如果实体类非常多，建议使用第二种
第一种可以DIY别名，第二种不行，如果非要改，需要在实体类加上注解名
第一种

<!--配置别名,注意顺序-->
<typeAliases>
   <typeAlias type="com.lyh.pojo.User" alias="user"/>
</typeAliases>

例如：

<?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>
    <!--引入配置文件-->
    <properties resource="db.properties">
        <property name="username" value="root"/>
        <property name="password" value="123"/>
    </properties>
    <!--可以给实体类起别名（此处要小心typeAlias的标签位置要在properties和setting后面）-->
    <typeAliases>
        <typeAlias type="com.lyh.pojo.user" alias="user"/>
    </typeAliases>

    <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>
    <!--每一个meapper.Xml都需要在Mybatis核心配置文件中注册-->
    <mappers>
        <mapper resource="com/lyh/dao/UserMapper.xml"/>
    </mappers>
</configuration>

在使用当这样配置时，user可以用在任何使用com.lyh.pojo.user的地方。
例如;这里的返回类型剋以直接写我们取得别名user而非com.lyh.pojo.user

    <select id="getUserList" resultType="user">
     select * from mybatis.user;
 </select>

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

 <typeAliases>
        <package name="com.lyh.pojo.user" />
    </typeAliases>

每一个在包 com.lyh.pojo 中的 Java Bean，在没有注解的情况下，会使用 Bean 的首字母小写的非限定类名来作为它的别名。
就是如果com.lyh.pojo 包中有很多javabean这时候他会去扫描包中的javabean用他们的名字的小写来代表这个javabean;
例子：
1.在配置文件mybatis-conflg.xml文件中配置

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

2.在UserMapper.xml文件中运用

 <select id="getUserList" resultType="user">
     select * from mybatis.user;
 </select>

3.测试

public class UserDaoTest {
    @Test
    public void test(){
        //第一步:获取 SqlSession对象
        SqlSession sqlSession= MybatisUtils.getSqlSession();
        //第二步执行sql
        UserMapper userDao= sqlSession.getMapper(UserMapper.class);
        List<user> userList=userDao.getUserList();
        for(user u:userList){
            System.out.println(u);
        }
        sqlSession.close();
    }

若有注解，则别名为其注解值。见下面的例子
1.在实体类中给一个注解名

package com.lyh.pojo;

import org.apache.ibatis.type.Alias;

@Alias("uuuu")<!--注解名-->
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 + '\'' +
                '}';
    }
}

2.在mybatis-conflg.xml文件中运用typeAliases的第二种方法、

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

3.在UserMapper.xml文件中配置返回值为注解名

    <select id="getUserList" resultType="uuuu">
     select * from mybatis.user;
 </select>

4.测试
————————————————————————————————————————————————————
mappers元素
mappers

映射器 : 定义映射SQL语句文件

既然 MyBatis 的行为其他元素已经配置完了，我们现在就要定义 SQL 映射语句了。但是首先我们需要告诉 MyBatis 到哪里去找到这些语句。Java 在自动查找这方面没有提供一个很好的方法，所以最佳的方式是告诉 MyBatis 到哪里去找映射文件。你可以使用相对于类路径的资源引用， 或完全限定资源定位符（包括 file:/// 的 URL），或类名和包名等。映射器是MyBatis中最核心的组件之一，在MyBatis 3之前，只支持xml映射器，即：所有的SQL语句都必须在xml文件中配置。而从MyBatis 3开始，还支持接口映射器，这种映射器方式允许以Java代码的方式注解定义SQL语句，非常简洁。
引入资源方式

<!-- 使用相对于类路径的资源引用 -->
<mappers>
 <mapper resource="com/lyh/dao/UserMapper.xml"/>
</mappers>

<!--
使用映射器接口实现类的完全限定类名
需要配置文件名称和接口名称一致，并且位于同一目录下
-->
<mappers>
 <mapper class="com.lyh.dao.UserMapper"/>
</mappers>

<!--
将包内的映射器接口实现全部注册为映射器
但是需要配置文件名称和接口名称一致，并且位于同一目录下
-->
<mappers>
 <package name="com.lyh.dao"/>
</mappers>

Mapper文件

<?xml version="1.0" encoding="UTF-8" ?> namespace中文意思：命名空间，作用如下：

namespace的命名必须跟某个接口同名

接口中的方法与映射文件中sql语句id应该一一对应

namespace和子元素的id联合保证唯一 , 区别不同的mapper

绑定DAO接口

namespace命名规则 : 包名+类名

MyBatis 的真正强大在于它的映射语句，这是它的魔力所在。由于它的异常强大，映射器的 XML 文件就显得相对简单。如果拿它跟具有相同功能的 JDBC 代码进行对比，你会立即发现省掉了将近 95% 的代码。MyBatis 为聚焦于 SQL 而构建，以尽可能地为你减少麻烦。