【Mybatis】入门：环境搭建和案例测试

mybatis 概述

mybatis是一个持久层框架，用Java编写。它封装了jdbc操作的细节，使开发者只关注sql语句本身，而无需关注注册驱动、创建连接等繁琐 过程。它使用了ORM思想实现了结果集的封装。
ORM：Object Relational Mapping，把数据库表和实体类及实体类的属性对应起来，操作实体类就是操作数据库表。例如用一个User类对应数据库中的user表，表中的id,username等字段分别对应User类中的属性id，name等。
mybatis将SQL语句写在配置文件中，降低了数据库与java代码的耦合性，更有利于针对数据库进行优化。

mybatis入门

mysql表格信息

mybatis的环境搭建

1. 创建maven工程并导入坐标
   配置maven安装路径，setting.xml和本地仓库路径
   导入坐标(jar包下载地址)，在pom.xml中添加依赖

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.mj</groupId>
    <artifactId>day01_01mybatistest</artifactId>
    <version>1.0-SNAPSHOT</version>
    <packaging>jar</packaging>

    <dependencies>
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.4.5</version>
        </dependency>

        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>8.0.19</version>
        </dependency>
    </dependencies>
    
</project>

2. 创建实体类和dao接口

public class User implements Serializable {
    //变量名称与数据库表中字段一致
    private Integer id;
    private  String username;
    private Date birthday;
    private  String sex;
    /* 补充驼峰命名规则：若数据库中含字段名形式为：xx_xx,
   则在java中对应形式为xxXx(_后面字母大写)
   开启驼峰命名：在主配置文件中设置参数mapUnderscoreToCamelCase的值为true
 */
}

public interface IUserDao {
    /*查询所有操作
    * @return
    * */
    List<User> findAll();
    public  User getUserById(Integer id);
}

3. 创建Mybatis的主配置文件
   Mybatis约束和mysql环境配置

 <?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="mysql">
        <!--配置mysql环境-->
        <environment id="mysql">
            <!--配置事务类型-->
            <transactionManager type="JDBC"></transactionManager>
            <!--配置数据源(连接池)-->
            <dataSource type="POOLED">
            <!--配置数据库信息-->
            <property name="driver" value="com.mysql.jdbc.Driver"/>
            <property name="url" value="jdbc:mysql://localhost:3306/mytest?serverTimezone=GMT"/>
            <property name="username" value="root"/>
            <property name="password" value="1234567890"/>
            </dataSource>
        </environment>
    </environments>

    <!--指定映射配置文件的位置，每个dao独立的配置文件-->
    <mappers>
        <mapper resource="com/mj/dao/IUserDao.xml"/>
    </mappers>

</configuration>

环境配置的第二种方式：

<?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>
<!--注意：标签设置由固定的先后顺序！！！-->

    <properties resource="dbconfig.properties"></properties>

<!--   驼峰命名：
        <settings>
        <setting name="mapUnderscoreToCamelCase" value="true"/>
        </settings>
-->

    <!--配置环境-->
    <environments default="mysql"> <!--修改默认环境的值可以切换数据源-->
        <!--配置mysql环境-->
        <environment id="mysql">
            <!--配置事务类型-->
            <transactionManager type="JDBC"></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>

<!--resource:从类路径下获取资源-->
<!--url:从磁盘或者网络路径下获取资源-->
<!--class:直接引用接口的全类名
    需要将xml文件名与接口名字一致，路径一致
    此方式还可以用于用注解替代接口配置文件-->

    <!--指定映射配置文件的位置，每个dao独立的配置文件-->
    <mappers>
        <mapper resource="com/mj/dao/IUserDao.xml"/>
        <!-- 批量注册使用package
           <package name="dao所在的包名"/>
         -->
    </mappers>
</configuration>

dbconfig.properties文件

driver=com.mysql.cj.jdbc.Driver
url=jdbc:mysql://localhost:3306/mytest?serverTimezone=GMT
username=root
password=1234567890

4. 创建映射配置文件

 <?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="com.mj.dao.IUserDao">
<!-- 配置查询操作 -->
<!--id为Dao文件中的方法名称，result为返回值类型
#{属性名}，取出传递过来的参数值
-->
    <select id=" findAll" resultType="com.mj.domain.User">
        select * from User
    </select>
    <select id="getUserById" resultType="com.mj.domain.User">
        select * from User where id=#{id}
    </select>
</mapper>

入门案例

test代码

public class MybatisTest {
    public static void main(String[] args) throws IOException {
        //1.读取配置文件
        InputStream in= Resources.getResourceAsStream("SqlMapConfig.xml");

        //2.创建SqlSessionFactory工厂
        SqlSessionFactoryBuilder builder=new SqlSessionFactoryBuilder();//通过SqlSessionFactoryBuilder隐藏了工厂创建的细节
        SqlSessionFactory factory=builder.build(in);//SqlSessionFactory是一个接口，不可以通过new创建实例
        //Mybatis由此封装了与数据库建立连接的细节

        //3.使用工厂生成sqlSession对象
        SqlSession session=factory.openSession(true);//开启自动提交

        //4.使用sqlSession创建Dao接口的代理对象
        IUserDao userDao=session.getMapper(IUserDao.class);

        //5.使用代理对象执行方法
        List<User> users=userDao.findAll();
        for (User user:users){
            System.out.println(user);
        }

        //6.释放资源
        session.close();
        in.close();
    }
}

环境搭建注意事项

常见运行错误分析

1.WARNING:An illegal reflective access operation has occurred

不影响代码运行，
想消除警告的可在 VM options 添加参数： --illegal-access=deny --add-opens java.base/java.lang=ALL-UNNAMED

验证结果如下：

2.com.mysql.cj.exceptions.InvalidConnectionAttributeException: The server time zone value ‘XXX’ is unrecognized or represents more than one time zone.

新版本的数据库连接程序需要指定UTC时区，改正方法将主配置文件中的“url”后面加上指定的时区，更改如下：

<property name="url" value="jdbc:mysql://localhost:3306/mytest？serverTimezone=GMT"/>

3. Intellij idea 报错：Error : java 不支持发行版本5

解决方案链接: https://blog.csdn.net/qq_22076345/article/details/82392236.

Mybatis配置文件的结构

参考链接:http://www.mybatis.cn/680.html
https://mybatis.org/mybatis-3/zh/configuration.html#databaseIdProvider
设置databaseIdProvider可以使得程序具有可移植性(Mysql，Oracle， Sql Server的语言规范不同)
注意：这些结构标签在使用的时候有固定的先后顺序，违反该顺序会报错。