【Mybatis】XML——配置篇

0. 前言

整个项目的目录层级结构如下：

1. 导入依赖

    <dependencies>
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>5.1.40</version>
        </dependency>
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.4.6</version>
        </dependency>
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <version>1.18.12</version>
            <scope>provided</scope>
        </dependency>
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.10</version>
            <scope>test</scope>
        </dependency>
    </dependencies>

2. 创建数据库表

create database mybatis;//创建名为learn_java的数据库
use mybatis;//使用创建的数据库
//创建用户表
CREATE TABLE `tb_user` (
  `id` int(11) NOT NULL auto_increment,
  `username` varchar(32) NOT NULL COMMENT '用户名称',
  `birthday` datetime default NULL COMMENT '生日',
  `sex` char(1) default NULL COMMENT '性别',
  `address` varchar(256) default NULL COMMENT '地址',
  PRIMARY KEY  (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;
// 插入表信息
insert  into `tb_user`(`id`,`username`,`birthday`,`sex`,`address`) values (41,'老王','2018-02-27 17:47:08','男','北京'),(42,'小二王','2018-03-02 15:09:37','女','北京金燕龙'),(43,'小二王','2018-03-04 11:34:34','女','北京金燕龙'),(45,'传智播客','2018-03-04 12:04:06','男','北京金燕龙'),(46,'老王','2018-03-07 17:37:26','男','北京'),(48,'小马宝莉','2018-03-08 11:44:00','女','北京修正');

3. 编写实体类

@Data
public class User {
    private Integer id;
    private String username;
    private Date birthday;
    private String sex;
    private String address;
}

4. 编写Mapper接口类

public interface UserMapper {
    /*
        保存新用户
     */
    void saveUser(User user);

    /**
     * 查询所有用户
     * @return
     */
    List<User> findAll();
}

5. 编写Mapper的xml配置文件

xml存放的位置在resources下，目录层级结构记得和Mapper的接口类相同。

<?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 和 id 在mapper 中查询具体的方法
			resultType 表示返回对象的数据类型
			parameterType 表示传入的数据对象
			id  唯一标识，要与命名空间（抽象方法）中定义的方法名称一致
	-->
<mapper namespace="org.example.mapper.UserMapper">

    <insert id="saveUser" parameterType="User">
        insert into tb_user( username, sex, address)
        values (#{username}, #{sex}, #{address})
    </insert>

    <select id="findAll" resultType="User">
        SELECT * FROM tb_user;
    </select>
</mapper>

6. 创建MyBatis核心配置文件SqlMapConfig.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>
    <!-- 配置文件信息 -->
    <properties resource="db.properties"></properties>
    <typeAliases>
        <!--给这个包下的类都取别名-->
        <package name="org.example.domain"/>
    </typeAliases>
    <environments default="development">
        <environment id="development">
            <transactionManager type="JDBC"/>
            <dataSource type="POOLED">
                <!-- 从配置文件中加载属性 -->
                <property name="driver" value="${db.driver}"/>
                <property name="url" value="${db.url}"/>
                <property name="username" value="${db.user}"/>
                <property name="password" value="${db.password}"/>
            </dataSource>
        </environment>
    </environments>
    <mappers>
        <!-- 加载前面编写的SQL语句的文件 -->
        <!--        <mapper resource="com/yogurt/po/StudentMapper.xml"/>-->
        <mapper resource="org/example/mapper/UserMapper.xml"/>
<!--        <package name="org.example.mapper"/>-->
    </mappers>

</configuration>

这里我们将数据库的连接信息单独创建一个文件db.properties进行解耦。

db.properties 文件内容如下：

db.url=jdbc:mysql://localhost:3306/mybatis?characterEncoding=utf8
db.user=root
db.password=xxxxxxx
db.driver=com.mysql.jdbc.Driver

7. 编写测试类

public class AppTest 

{
        private InputStream in;
        private SqlSessionFactory factory;
        private SqlSession session;
        private UserMapper userMapper;
        @Before
        public void init() throws IOException {
            try {
                in= Resources.getResourceAsStream("SqlMapConfig.xml");
                factory=new SqlSessionFactoryBuilder().build(in);
                session=factory.openSession();
                userMapper=session.getMapper(UserMapper.class);
            } catch (IOException e) {
                throw new RuntimeException(e);
            }
        }
        
        @After
        // 执行测试方法之后执行
        public void destroy() throws Exception{
            session.commit();
            session.close();
            in.close();
        }
        
        @Test
        public void saveUser() {
            User user = new User();
            user.setAddress("wuhan");
            user.setSex("boy");
            user.setUsername("xiaoming");
            userMapper.saveUser(user);
            System.out.println(user);
        }

}

启动测试方法，如果为报错，则会打印保存的信息。