Mybatis复习——day01_搭建Mybatis

目录

1、开发环境

2、创建Maven工程

3、创建MyBatis核心配置文件

4、创建Mapper接口

5、创建Mybatis映射文件

6、通过junit测试功能

7、加入log4j的配置文件

8、项目结构

---

1、开发环境

IDE：idea 2021.1

构建工具：maven 3.6.3

MySQL版本：MySQL 5.7

MyBatis版本：MyBatis 3.5.7

MySQL连接的的注意事项
1、驱动类driver-class-name
MySQL 5版本使用jdbc5驱动，驱动类使用：com.mysql.jdbc.Driver
MySQL 8版本使用jdbc8驱动，驱动类使用：com.mysql.cj.jdbc.Driver
2、连接地址url
我一般使用的是
jdbc:mysql://localhost:3306/SSM?useUnicode=true&characterEncoding=utf-8&serverTimezone=UTC&useSSL=false
在这个MySQL的url中：
    localhost：地址
    3306：端口，默认是3306
    SSM：数据库名
    useUnicode=true：true表示使用unicode编码
    characterEncoding=UTF-8：字符集
    serverTimezone=UTC：设置时区
    有一些坑，可以参考：https://blog.csdn.net/baidu_38837718/article/details/104981617
    useSSL=false：使用JDBC跟你的数据库连接的时候，你的JDBC版本与MySQL版本不兼容，MySQL的版本更高一些，在连接语句后加上“useSSL=‘false’” ，就可以连接到数据库了。

2、创建Maven工程

引入依赖

<?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.itwpf</groupId>
    <artifactId>day01_Mybatis_Helloword</artifactId>
    <version>1.0-SNAPSHOT</version>
    <packaging>jar</packaging>

    <dependencies>
<!--        Mybatis核心-->
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.5.7</version>
        </dependency>
<!--    junit测试-->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.12</version>
            <scope>test</scope>
        </dependency>
<!--    数据库驱动-->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>5.1.49</version>
        </dependency>
        <!-- log4j日志 -->
        <dependency>
            <groupId>log4j</groupId>
            <artifactId>log4j</artifactId>
            <version>1.2.17</version>
        </dependency>
    </dependencies>
    
    
</project>

3、创建MyBatis核心配置文件

习惯上命名为mybatis-config.xml，这个文件名仅仅只是建议，并非强制要求。将来整合Spring 之后，这个配置文件可以省略，所以大家操作时可以直接复制、粘贴。

核心配置文件主要用于配置连接数据库的环境以及MyBatis的全局配置信息

核心配置文件存放的位置是src/main/resources目录下

<?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>
<!--
    mybatis核心配置文件中的标签必须要按照指定的顺序配置
    properties?,settings?,typeAliases?,
    typeHandlers?,objectFactory?,
    objectWrapperFactory?,reflectorFactory?,
    plugins?,environments?,
    databaseIdProvider?,mappers?
-->

<!--    引入properties文件，此后就可以在当前文件中使用${key}的方式访问value-->
    <properties resource="jdbc.properties"/>
    
    <!--
    typeAliases类型别名
        设置类型别名，即为某个具体的类型设置一个别名
        在Mybatis范围中，就可以使用别名表示一个具体的类型
    -->
    <typeAliases>
<!--
        type：设置需要起别名的类型
        alias：设置某个类型的别名
        如果没有设置alias，当前的类型就拥有默认的别名，即类名且不区分大小写
-->
<!--        <typeAlias type="com.itwpf.pojo.User" alias="User"/>-->
<!--        <typeAlias type="com.itwpf.pojo.User" alias="abc"/>-->

        <!--通过包类设置类型别名，指定包下所有的类型将全部拥有默认的别名，即类名且不区分大小写-->
        <package name="com.itwpf.pojo"/>
    </typeAliases>
    
<!--   environments:配置连接数据库的环境
        default:设置默认使用的环境的id
        属性：
            id：设置环境的唯一标识，不能重复
-->
    <environments default="development">
        <environment id="development">
<!--            transactionManager：设置事务管理器-->
<!--            属性：-->
<!--                type:设置事务管理的方式-->
<!--            type="JDBC|MANAGED-->
<!--            JDBC:表示使用JDBC原生的事务管理方式-->
<!--            MANAGED：被管理，例如spring-->
            <transactionManager type="JDBC"/>
<!--            dataSource：设置数据源
                属性：
                   type：设置数据源类型
                    type="POOLED|UNPOOLED|JNDI"
                    POOLED:表示使用数据库连接池
                    UNPOOLED：表示不是要给你数据库连接池
                    JNDI：表示使用上下文中的数据源
-->
            <dataSource type="POOLED">
                <property name="driver" value="${jdbc.driver}"/>
                <property name="url" value="${jdbc.url}"/>
                <property name="username" value="${jdbc.username}"/>
                <property name="password" value="${jdbc.password}"/>
            </dataSource>
        </environment>
    </environments>
<!--    引入mybatis的映射文件-->
    <mappers>
    
<!--        <mapper resource="mappers/UserMapper.xml"/>-->
<!--
        以包的方式引入映射文件，但是必须满足两个条件；
            1、mapper接口和映射文件所在的包必须一致
            2、mapper接口的名字和映射文件的名字必须一致
-->
        <package name="com.itwpf.mapper"/>
    </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>
    <!--
    mybatis核心配置文件中的标签必须要按照指定的顺序配置
    properties?,settings?,typeAliases?,
    typeHandlers?,objectFactory?,
    objectWrapperFactory?,reflectorFactory?,
    plugins?,environments?,
    databaseIdProvider?,mappers?
-->
    <properties resource="jdbc.properties"/>
    
    <typeAliases>
        <package name="com.itwpf.pojo"/>
    </typeAliases>
    
    <environments default="development">
        <environment id="development">
            <transactionManager type="JDBC"/>
            <dataSource type="POOLED">
                <property name="driver" value="${jdbc.driver}"/>
                <property name="url" value="${jdbc.url}"/>
                <property name="username" value="${jdbc.username}"/>
                <property name="password" value="${jdbc.password}"/>
            </dataSource>
        </environment>
    </environments>
    <!--    引入mybatis的映射文件-->
    <mappers>
        <package name="com.itwpf.mapper"/>
    </mappers>
</configuration>

4、创建Mapper接口

（1）创建实体类

先创建pojo包，再创建User实体类

package com.itwpf.pojo;

public class User {
    private Integer id;

    private String username;

    private String password;

    private Integer age;

    private String gender;

    private String email;

    public User() {
    }

    public User(Integer id, String username, String password, Integer age, String gender, String email) {
        this.id = id;
        this.username = username;
        this.password = password;
        this.age = age;
        this.gender = gender;
        this.email = email;
    }

    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 Integer getAge() {
        return age;
    }

    public void setAge(Integer age) {
        this.age = age;
    }

    public String getGender() {
        return gender;
    }

    public void setGender(String gender) {
        this.gender = gender;
    }

    public String getEmail() {
        return email;
    }

    public void setEmail(String email) {
        this.email = email;
    }

    @Override
    public String toString() {
        return "User{" +
                "id=" + id +
                ", username='" + username + '\'' +
                ", password='" + password + '\'' +
                ", age=" + age +
                ", gender='" + gender + '\'' +
                ", email='" + email + '\'' +
                '}';
    }
}

 （2）MyBatis中的mapper接口相当于以前的dao。但是区别在于，mapper仅仅是接口，我们不需要 提供实现类。

public interface UserMapper {

    /**
    * 添加用户信息
    */
    int insertUser();

}

5、创建Mybatis映射文件

（1）创建数据库表（id自增长，不为null）

CREATE TABLE `t_user` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `username` varchar(20) DEFAULT NULL,
  `password` varchar(20) DEFAULT NULL,
  `age` int(11) DEFAULT NULL,
  `gender` char(1) DEFAULT NULL,
  `email` varchar(50) DEFAULT NULL,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=12 DEFAULT CHARSET=utf8

（2）创建映射文件

1、映射文件的命名规则：

表所对应的实体类的类名+Mapper.xml

例如：表t_user，映射的实体类为User，所对应的映射文件为UserMapper.xml 因此一个映射文件对应一个实体类，对应一张表的操作

MyBatis映射文件用于编写SQL，访问以及操作表中的数据 MyBatis映射文件存放的位置是src/main/resources/mappers目录下

2、 MyBatis中可以面向接口操作数据，要保证两个一致：

（a）mapper接口的全类名和映射文件的命名空间（namespace）保持一致

（b）mapper接口中方法的方法名和映射文件中编写SQL的标签的id属性保持一致

<?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">
<mapper namespace="com.itwpf.mapper.UserMapper">
<!--    int insertUser();-->
        <!--
        mapper接口和映射文件要保证两个一致
        1、mapper接口的全类名和映射文件的namespace一致
        2、mapper接口中的方法名要和映射文件中的sql的id保持一致
        -->
    <insert id="insertUser">
        insert into t_user value (null,'admin','123456',23,'男','123456@qq你.com')
    </insert>
    
</mapper>

6、通过junit测试功能

public class MyBatisTest {
    @Test
    public void testInsert() throws IOException {
        //获取核心配置文件的输入流
        InputStream is = Resources.getResourceAsStream("mybatis-config.xml");
        //获取SQLSessionFactoryBuilder
        SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
        //获取SqlSessionFactory对象
        SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(is);
        //获取sql的会话对象sqlSession，是Mybatis提供的操作数据库的对象
        //不加参数，不会自动提交事务，需要手动提交事务 SqlSession.commit
        //加上参数true，会自动提交事务
        SqlSession sqlSession = sqlSessionFactory.openSession(true);
        //获取UserMapper的代理实现类对象
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        //调用mapper接口中的方法，实现添加用户信息的功能
        int i = mapper.insertUser();
        //提交事务
//        sqlSession.commit();
        //关闭sqlsession对象
        sqlSession.close();
    }
}

SqlSession：代表Java程序和数据库之间的会话。（HttpSession是Java程序和浏览器之间的 会话）

SqlSessionFactory：是“生产”SqlSession的“工厂”。

工厂模式：如果创建某一个对象，使用的过程基本固定，那么我们就可以把创建这个对象的 相关代码封装到一个“工厂类”中，以后都使用这个工厂类来“生产”我们需要的对象。

我们此时可以将上述代码封装为一个工具类，利于我们快速使用

public class SqlSessionUtil {
    public static SqlSession getSqlSession(){
        SqlSession sqlSession = null;
        try {
            //1.获取核心配置文件的输入流
            InputStream is = Resources.getResourceAsStream("mybatis-config.xml");
            //2.获取SqlSessionFactoryBuilder对象
            SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
            //3.获取SqlSessionFactory
            SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(is);
            //4.获取SqlSession对象，设置为true，自动提交事务
            sqlSession = sqlSessionFactory.openSession(true);

        } catch (IOException e) {
            e.printStackTrace();
        }
        return sqlSession;
    }
}

使用时直接调用即可

@Test
    public void testInsertUser(){
        //通过工具类获取SqlSession对象
        SqlSession sqlSession = SqlSessionUtil.getSqlSession();
        //获取UserMapper的代理实现类对象
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        //调用mapper接口中的方法，实现添加用户信息的功能
        int i = mapper.insertUser();
        System.out.println(i);
    }

7、加入log4j的配置文件

（1）加入依赖：

<!-- log4j日志 -->
<dependency>
    <groupId>log4j</groupId>
    <artifactId>log4j</artifactId>
    <version>1.2.17</version>
</dependency>

（2）加入log4j的配置文件

log4j的配置文件名为log4j.xml，存放的位置是src/main/resources目录下

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
<log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">
    <appender name="STDOUT" class="org.apache.log4j.ConsoleAppender">
        <param name="Encoding" value="UTF-8" />
        <layout class="org.apache.log4j.PatternLayout">
            <param name="ConversionPattern" value="%-5p %d{MM-dd HH:mm:ss,SSS}%m (%F:%L) \n" />
        </layout>
    </appender>
    <logger name="java.sql">
        <level value="debug" />
    </logger>
    <logger name="org.apache.ibatis">
        <level value="info" />
    </logger>
    <root>
        <level value="debug" />
        <appender-ref ref="STDOUT" />
    </root>
</log4j:configuration>

此时控制台就会出现SQL语句，利于我们观察和调试

DEBUG 08-23 17:38:27,687==>  Preparing: insert into t_user value (null,'admin','123456',23,'男','123456@qq你.com') (BaseJdbcLogger.java:137) 
DEBUG 08-23 17:38:27,706==> Parameters:  (BaseJdbcLogger.java:137) 
DEBUG 08-23 17:38:27,710<==    Updates: 1 (BaseJdbcLogger.java:137) 
1

8、项目结构