【SSM】其一：创建Maven项目、Mybatis基础、常用依赖、Mybatis完整案例

1）创建项目

• 新建JAVA工程，创建Maven模块

2）添加依赖

• 项目创建成功后在pom.xml中更改打包方式，添加相关依赖

1. 在坐标pom.xml中将配置打包方式更改为jar包

2. 继续添加依赖，包含mybatis核心jar包、junit测试、mysql驱动等

<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>
    <!-- MySQL驱动 -->
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>runtime</version>
    </dependency>
    <!-- log4j日志 -->
    <dependency>
		<groupId>log4j</groupId>
		<artifactId>log4j</artifactId>
		<version>1.2.17</version>
   	<!-- lombok简化实体类开发 -->
    <dependency>
        <groupId>org.projectlombok</groupId>
        <artifactId>lombok</artifactId>
	</dependency>
    <!-- pagehelper分页 -->    
    <dependency>
    	<groupId>com.github.pagehelper</groupId>
    	<artifactId>pagehelper</artifactId>
    	<version>5.2.0</version>
	</dependency>
</dependencies>

• 注意对于log4j，还需要引入log4j日志的配置文件，log4j.xml，存放在src/main/resources目录下

• 注意对于pagehelper，需要在mybatis-config.xml核心配置文件的environment之前添加

<plugins>
    <!--设置分页插件-->
    <plugin interceptor="com.github.pagehelper.PageInterceptor"></plugin>
</plugins>

• 分页插件中的变量解释

3）核心配置文件

1. 新建mybatis-config.xml配置文件（配置文件都在resources目录下）
2. 复制粘贴基本配置信息（这里我用的是mybatis-3.5.13，就在官方目录里去找）

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration
	PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
 	"https://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
    <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>
    <mappers>
        <mapper resource="org/mybatis/example/BlogMapper.xml"/>
    </mappers>
</configuration>

4）编写mapper接口与xml映射文件

• 在java中的mapper包下每有一个实体类对应的mapper接口就应该有一个对应同名的在resources中的mappers下的xml配置文件

1. UserMapper接口用于写操纵数据库的方法，每个方法都应该在UserMapper.xml中实现（当然也可以用注解）
2. UserMapper.xml文件（映射文件）用于实现UserMapper接口中各个方法的SQL语句

3. 别忘了在mybatis-config.xml中引入mapper的配置文件

4. 书写测试类MyBatisTest

package com.dadiancao.test;

import com.dadiancao.mapper.UserMapper;
import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.*;
import org.junit.Test;

import java.io.IOException;
import java.io.InputStream;
import java.sql.Connection;

/**
 * @Description: MyBatisTest
 * @Author: Sapphire
 * @Date: 29/05/2023 5:53 PM
 */
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提供的操作数据库的对象(true=>自动提交事务)
        SqlSession sqlSession=sqlSessionFactory.openSession(true);
        // 获取UserMapper的代理实现类对象(因为UserMapper是接口,不能new对象出来,这里用代理实现类)\
        UserMapper mapper=sqlSession.getMapper(UserMapper.class);
        // 调用mapper接口中的方法,实现添加用户信息的功能
        int result=mapper.insertUser();
        System.out.println("结果:"+result);
        sqlSession.close();
    }
}

5）完整案例

1：项目结构

2：User实体类

package com.dadiancao.entity;

import lombok.Data;
import lombok.AllArgsConstructor;
import lombok.NoArgsConstructor;

/**
 * @Description: User
 * @Author: Sapphire
 * @Date: 29/05/2023 1:53 PM
 */
// lombok简化开发
@Data
@AllArgsConstructor
@NoArgsConstructor
public class User {
    private Integer id;
    private String name;
    private Integer age;
    private Integer gender;
    private String phone;
}

3：mybatis-config.xml

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration
    PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
    "https://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"/>

    <!--
        typeAlias:设置类型别名,即为某个具体的类型设置一个别名
        在MyBatis范围中,就可以使用别名表示一个具体的类型
    -->
    <typeAliases>
        <!--
            type:需要设置别名的全类名
            alias:设置某个类型的别名
            如果不要alias属性,则默认别名为这个实体类的名字,但不区分大小写
        -->
        <!--<typeAlias type="com.dadiancao.entity.User" alias="enUser"></typeAlias>-->
        <!--通过包设置类型别名,指定包下所有类型将拥有默认别名,且不区分大小写-->
        <package name="com.dadiancao.entity"/>
    </typeAliases>

    <environments default="development">
    <!--环境不止一个,default用于选择默认开发环境-->
        <!--
            配置连接数据库的环境
            environment:设置一个默认的连接数据库的环境
            id:设置环境的唯一标识,不能重复
        -->
        <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>
        <!--测试环境-->
        <environment id="test">
            <transactionManager type="JDBC"/>
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.cj.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://localhost:3306?mybitis?serverTimezone=UTC"/>
                <property name="username" value="root"/>
                <property name="password" value="123456"/>
            </dataSource>

        </environment>
    </environments>
    <!--引入mybatis的映射文件-->

    <mappers>
        <!--<mapper resource="mappers/UserMapper.xml"/>-->
        <!--
            以包的方式引入映射文件,但是必须满足两个条件:
            1. mapper接口和映射文件所在的包必须一致(编译后Mapper接口和Mapper.xml在同一目录下)
            2. mapper接口的名字和映射文件的名字必须一致
        -->
        <package name="com.dadiancao.mapper"/>
    </mappers>

</configuration>

4：UserMapper

package com.dadiancao.mapper;

import com.dadiancao.entity.User;

import java.util.List;

/**
 * @Description: UserMapper
 * @Author: Sapphire
 * @Date: 29/05/2023 5:29 PM
 */
public interface UserMapper {
    // 存放方法

    /**
     * 添加用户
     * @return 整型
     */
    int insertUser();

    /**
     * 更新用户信息
     */
    void updateUser();

    /**
     * 删除用户
     */
    void deleteUser();

    /**
     * 根据用户id返沪用户信息
     * @return 返回用户信息
     */
    User getUserById();

    /**
     * 获取所有的用户信息
     * @return 返回用户列表
     */
    List<User> getAllUsers();
}

5：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">
<mapper namespace="com.dadiancao.mapper.UserMapper">
    <!--int insertUser();-->
    <insert id="insertUser">
        insert into user values(20,'RoysterCDD',18,1,'15715715715')
    </insert>
    <!--void updateUser()-->
    <update id="updateUser">
        update user set name='Rick',gender=2 where id=3
    </update>
    <!--void deleteUser();-->
    <delete id="deleteUser">
        delete from user where id=3
    </delete>
    <!--User getUserById();-->
    <!--
        resultType:设置结果类型,即查询的数据要转换为的java类型
        resultMap:自定义映射,处理多对一或者一对多的映射关系
    -->
    <select id="getUserById" resultType="com.dadiancao.entity.User">
        select * from user where id=1
    </select>
    <!--List<User> getAllUsers();-->
    <!--这里因为加入了Tlias包扫描所以所以默认是类名(首字母小写）-->
    <select id="getAllUsers" resultType="user">
        select * from user
    </select>
</mapper>

6：java测试类

package com.dadiancao.test;

import com.dadiancao.entity.User;
import com.dadiancao.mapper.UserMapper;
import com.dadiancao.utils.SqlSessionUtil;
import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.*;
import org.junit.Test;

import java.io.IOException;
import java.io.InputStream;
import java.sql.Connection;
import java.util.List;

/**
 * @Description: MyBatisTest
 * @Author: Sapphire
 * @Date: 29/05/2023 5:53 PM
 */
// 基于Junit
public class MyBatisTest {
    // 检验Insert用户
    @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 sqlSession=sqlSessionFactory.openSession();
        // 获取sql的会话对象SqlSession(会自动提交事务),是MyBatis提供的操作数据库的对象
        SqlSession sqlSession=sqlSessionFactory.openSession(true);
        // 获取UserMapper的代理实现类对象(因为UserMapper是接口,不能new对象出来,这里用代理实现类)\
        UserMapper mapper=sqlSession.getMapper(UserMapper.class);
        // 调用mapper接口中的方法,实现添加用户信息的功能
        int result=mapper.insertUser();
        System.out.println("结果:"+result);
        // 提交事务(没有这一句数据库中不会更新),当然也可也设置自动提交事务
        // sqlSession.commit();
        // 关闭sqlSession
        sqlSession.close();
    }

    // 检验update用户
    @Test
    public void testUpdate() {
        SqlSession sqlSession= SqlSessionUtil.getSqlSession();
        UserMapper mapper=sqlSession.getMapper(UserMapper.class);
        mapper.updateUser();
        sqlSession.close(); // 关闭SqlSession
    }

    // 检验delete用户
    @Test
    public void testDelete() {
        SqlSession sqlSession=SqlSessionUtil.getSqlSession();
        UserMapper mapper=sqlSession.getMapper(UserMapper.class);
        mapper.deleteUser();;
        sqlSession.close();
    }

    // 测试select用户
    @Test
    public void testGetUserById() {
        SqlSession sqlSession=SqlSessionUtil.getSqlSession();
        UserMapper mapper=sqlSession.getMapper(UserMapper.class);
        User user=mapper.getUserById();
        System.out.println(user);
        sqlSession.close();
    }

    @Test
    public void testGetAllUsers() {
        SqlSession sqlSession=SqlSessionUtil.getSqlSession();
        UserMapper mapper=sqlSession.getMapper(UserMapper.class);
        List<User> list=mapper.getAllUsers();
        // 方法引用,打印所有的成员嗷
        list.forEach(System.out::println);
        sqlSession.close();
    }
}

6）原理

• 通过UserMapper的全类名→找到映射文件→找到Mapper接口中的映射方法→找到SQL语句