java小新创建第一个MyBatis程序

课前小知识：

1、创建数据库：CREATE DATABASE 数据库名;

# 创建mybatis数据库
CREATE DATABASE `mybatis`;

2、创建表：CREATE TABLE 表名;

#创建user表
CREATE TABLE `user` (
`id` INT(20) NOT NULL PRIMARY KEY,
`name` VARCHAR(30) DEFAULT NULL,
`pwd` VARCHAR(30) DEFAULT NULL
)ENGINE=INNODB DEFAULT CHARSET=utf8

3、插入数据

INSERT INTO `user` (`id`,`name`,`pwd`) VALUES
(1,'张三','123123'),
(2,'李四','123123'),
(3,'王五','123123')

创建第一个MyBatis项目

1、搭建数据库（参考课前小知识）
2、新建一个普通的Maven项目
3、删除src文件夹
4、导入依赖：mybatis依赖、数据库依赖、单元测试依赖

<!-- mybatis依赖 -->
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.5.6</version>
        </dependency>
        <!-- 数据库依赖 -->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>5.1.47</version>
        </dependency>
        <!-- Junit依赖 -->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.12</version>
            <scope>test</scope>
        </dependency>

5、创建一个新的模块
（1）编写实体类、接口和xml文件（省略service层）
①实体类

public class User {

private Integer id;
private String name;
private String pwd;
// ...
// 省略构造方法、getter、setter方法、toString方法
}

②Dao接口

public interface UserMapper {

    // 查询所有用户集合
    List<User> getUserList();
    // 根据id查询用户
    User getUserById(int id);
    // 添加用户信息
    int addUser(@Param("user") User user);
    // 更新用户信息
    int updateUser(@Param("user") User user);
    // 根据id删除用户信息
    int deleteById(int id);

}

③Dao接口实现类（UserDaoImpl转换为UserMapper.xml配置文件）
注意：UserMapper.xml放在resource下新建的文件夹下（包名需要和UserMapper的包名相同）

<!-- resources文件夹下编写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">
<!--namespace 命名空间-->
<mapper namespace="dao.UserMapper">
<!--  id：对应接口名， resultType：对应返回结果集的泛型  -->
    <select id="getUserList" resultType="pojo.User">
      select * from user;
     </select>

    <select id="getUserById" parameterType="int" resultType="pojo.User">
        select * from `user` where `id` = #{id};
    </select>
    
    <insert id="addUser" parameterType="pojo.User" >
        insert into `user` (`id`,`name`,`pwd`) value (#{user.id},#{user.name},#{user.pwd});
    </insert>

    <update id="updateUser" parameterType="pojo.User">
        update `user` set `name` = #{user.name}, `pwd` = #{user.pwd} where `id` = #{user.id};
    </update>

    <delete id="deleteById" parameterType="int">
        delete from `user` where `id` = #{id};
    </delete>
</mapper>

（2）resources文件夹下编写配置文件mybatis-config.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>
    <!--  环境（可以配置多套）  -->
    <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?useSSL=true&amp;useUnicode=true&amp;characterEncoding=UTF-8"/>
                <property name="username" value="root"/>
                <property name="password" value="root"/>
            </dataSource>
        </environment>
    </environments>

   <!-- 注册mapper -->
    <mappers>
<!--        <mapper resource="com/ma/dao/UserMapper.xml"/>-->
        <mapper class="com.ma.dao.UserMapper"/>
    </mappers>
</configuration>

（3）编写mybatis工具类，用来获取SqlSession

public class MyBatisUtils {

    private static SqlSessionFactory sqlSessionFactory;

    // 加载核心配置文件
    static {
        try {
            String resource = "mybatis-config.xml";
            InputStream inputStream = Resources.getResourceAsStream(resource);
            sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
    // 有了SqlSessionFactory，就可以获取SqlSession。SqlSession中包含了面向数据库执行SQL命令所需要的所有方法
    public SqlSession getSqlSession() {
        return sqlSessionFactory.openSession();
    }
}

（4）测试

  @Test
    public void getUserList() {
        // ①获取SqlSession对象
        SqlSession sqlSession = MyBatisUtils.getSqlSession();
        // ②getMapper
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        List<User> userList = mapper.getUserList();
        for (User user : userList) {
            System.out.println(user);
        }

        // ③关闭SqlSession
        sqlSession.close();
    }

    @Test
    public void getUserById() {
        // 获取SqlSession
        SqlSession sqlSession = MyBatisUtils.getSqlSession();
        // 获取Mapper对象
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        // 调用查询方法
        User user = mapper.getUserById(4);
        System.out.println(user);
    }

    @Test
    public void addUser() {
        SqlSession sqlSession = MyBatisUtils.getSqlSession();
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        User user = new User(4, "赵六", "123123");
        int res = mapper.addUser(user);
        if (res > 0) {
            System.out.println("插入成功");
        }
        // 提交事务
        sqlSession.commit();
        // 关闭SqlSession
        sqlSession.close();
    }

    @Test
    public void updateUser() {
        SqlSession sqlSession = MyBatisUtils.getSqlSession();
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        User user = new User(4, "田七", "111111");
        int res = mapper.updateUser(user);
        if (res > 0 ) {
            System.out.println("更新成功");
        }
        sqlSession.commit();
        sqlSession.close();
    }

    @Test
    public void deleteById() {
        SqlSession sqlSession = MyBatisUtils.getSqlSession();
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        int res = mapper.deleteById(4);
        if (res > 0 ) {
            System.out.println("删除成功！");
        }
        sqlSession.commit();
        sqlSession.close();
    }

注意：增删改需要提交事务！
扩展：作用域（Scope）和生命周期

1、SqlSessionFactoryBuilder
这个类可以被实例化、使用和丢弃，一旦创建了 SqlSessionFactory，就不再需要它了。 因此 SqlSessionFactoryBuilder 实例的最佳作用域是方法作用域（也就是局部方法变量）。 你可以重用 SqlSessionFactoryBuilder 来创建多个 SqlSessionFactory 实例，但最好还是不要一直保留着它，以保证所有的 XML 解析资源可以被释放给更重要的事情。
2、SqlSessionFactory
SqlSessionFactory一旦被创建就应该在应用的运行期间一直存在，没有任何理由丢弃它或重新创建另一个实例。 使用 SqlSessionFactory的最佳实践是在应用运行期间不要重复创建多次，多次重建SqlSessionFactory 被视为一种代码“坏习惯”。因此SqlSessionFactory 的最佳作用域是应用作用域。 有很多方法可以做到，最简单的就是使用单例模式或者静态单例模式。
3、SqlSession 每个线程都应该有它自己的 SqlSession 实例。SqlSession的实例不是线程安全的，因此是不能被共享的，所以它的最佳的作用域是请求或方法作用域。 绝对不能将 SqlSession实例的引用放在一个类的静态域，甚至一个类的实例变量也不行。 也绝不能将 SqlSession 实例的引用放在任何类型的托管作用域中，比如Servlet 框架中的 HttpSession。 如果你现在正在使用一种 Web 框架，考虑将 SqlSession 放在一个和 HTTP请求相似的作用域中。 换句话说，每次收到 HTTP 请求，就可以打开一个 SqlSession，返回一个响应后，就关闭它。这个关闭操作很重要，为了确保每次都能执行关闭操作，你应该把这个关闭操作放到 finally 块中。 下面的示例就是一个确保SqlSession 关闭的标准模式：

try (SqlSession session = sqlSessionFactory.openSession()) { 
  //你的应用逻辑代码 
  }

在所有代码中都遵循这种使用模式，可以保证所有数据库资源都能被正确地关闭。
4、映射器实例
映射器是一些绑定映射语句的接口。映射器接口的实例是从 SqlSession 中获得的。虽然从技术层面上来讲，任何映射器实例的最大作用域与请求它们的 SqlSession 相同。但方法作用域才是映射器实例的最合适的作用域。 也就是说，映射器实例应该在调用它们的方法中被获取，使用完毕之后即可丢弃。 映射器实例并不需要被显式地关闭。尽管在整个请求作用域保留映射器实例不会有什么问题，但是你很快会发现，在这个作用域上管理太多像 SqlSession 的资源会让你忙不过来。 因此，最好将映射器放在方法作用域内。就像下面的例子一样：

try (SqlSession session = sqlSessionFactory.openSession()) {
  BlogMapper mapper = session.getMapper(BlogMapper.class);
  // 你的应用逻辑代码
}

扩展知识参考MyBatis中文文档，点击进入博客，该博客内含有中文文档链接:MyBatis相关概念及面试常见问题