【Mybatis 源码分析 1】使用maven配置mybatis

目录

1. 创建一个空maven项目

2. pom.xml中配置mybatis、 mysql 数据库连接以及测试用的jar包

3. 配置mybatis的全局配置文件

4. 定义一个pojo类和数据库中表字段对应，并定义数据库映射文件mapper.xml

5. 在mybatis的全局配置文件中引用4的映射文件

6. 整个项目主要文件结构

7. 记录一些我在配置的过程中遇到的问题

 

1. 创建一个空maven项目

2. pom.xml中配置mybatis、 mysql 数据库连接以及测试用的jar包

http://www.mybatis.cn/查mybatis最新版本

http://central.maven.org/maven2/mysql/mysql-connector-java/ 查mysql-connection-java的最新版本

    <dependencies>
        <!-- mybatis核心包 -->
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.5.4</version>
        </dependency>
        <!-- jdbc的包 -->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>8.0.20</version>
        </dependency>
    </dependencies>

 

3. 配置mybatis的全局配置文件

IDEA没有mybatid的配置文件模板，需要自己创建

点击File->Settings->搜索框里输入template找到File and Code Templates->Files->+->Name中输入mybatis-cfg.xml(可以自定义其他的名字)，Extensior输入xml，文本框中输入下面内容->Apply。就创建好了mybatis的配置模板

<?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>


</configuration>

在src/main/resource资源文件夹下添加mybatis配置文件，

我这里的mybatis配置文件名为mybatis-conf.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">
            <!--使用JDBC事务管理器-->
            <transactionManager type="JDBC"/>
            <!--配置数据库连接的信息 -->
            <dataSource type="POOLED">
                <!--使用${}获取配置文件db.properties中配置的字段 -->
                <property name="driver" value="com.mysql.cj.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://localhost:3306/testmybatisdb?serverTimezone=GMT%2B8&allowMultiQueries=true"/>
                <property name="username" value="root"/>
                <property name="password" value="18721426"/>
            </dataSource>

        </environment>
    </environments>


</configuration>

我们知道可以使用properties配置文件来设置数据库的信息,使用MySql数据库，数据库名为testmybatisdb

我这里数据库的配置文件名为db.properties

driver=com.mysql.cj.jdbc.Driver
url=jdbc:mysql://localhost:3306/testmybatisdb?serverTimezone=GMT%2B8&allowMultiQueries=true
username=root
password=18721426

然后再在mybatis-conf.xml中引用db.properties

<?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"/>

    <environments default="development">
        <environment id="development">
            <!--使用JDBC事务管理器-->
            <transactionManager type="JDBC"/>
            <!--配置数据库连接的信息 -->
            <dataSource type="POOLED">
                <!--使用${}获取配置文件db.properties中配置的字段 -->
                <property name="driver" value="${driver}"/>
                <property name="url" value="${url}"/>
                <property name="username" value="${username}"/>
                <property name="password" value="${password}"/>
            </dataSource>

        </environment>
    </environments>


</configuration>

4. 定义一个pojo类和数据库中表字段对应，并定义数据库映射文件mapper.xml

testmybatisdb数据库中建立一个manage表，包含一个自增id和一个varchar类型的name字段。

定义一个pojo类User，包含一个int类型的id和一个String类型的name成员，对应manage表。

package Entity;

public class User {

    private int id;
    private String name;

    public int getId() {
        return id;
    }

    public void setId(int id) {
        this.id = id;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    @Override
    public String toString() {
        return "User{" +
                "id=" + id +
                ", name='" + name + '\'' +
                '}';
    }
}

然后创建数据库映射文件，IDEA也没有提供mybatis的映射文件模板，同样需要自己定义

<?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>

</mapper>

同样的需要在src/main/resource资源文件夹下创建映射文件

<?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="mybatis-mapper">

    <!--这里写sql操作，外部程序通过id访问 -->
    <select id="selectAll" resultType="Entity.User">
        select * from manage
    </select>


</mapper>

5. 在mybatis的全局配置文件中引用4的映射文件

<?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"/>

    <environments default="development">
        <environment id="development">
            <!--使用JDBC事务管理器-->
            <transactionManager type="JDBC"/>
            <!--配置数据库连接的信息 -->
            <dataSource type="POOLED">
                <!--使用${}获取配置文件db.properties中配置的字段 -->
                <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="mybatis-mapper.xml"/>
    </mappers>

</configuration>

6. 整个项目主要文件结构

到这里，mybatis就配置好了。

7. 记录一些我在配置的过程中遇到的问题

1）maven导入依赖包太慢

解决：为了帮助程序快速从远端仓库下载依赖包，可以去http://maven.apache.org/download.cgi下载Apache Maven这个软件项目管理及自动构建工具，然后在File->Settings->Build,Execution,Deployment->Maven中替换本地的settings.xml

2） 有的帖子说mybatis全局配置文件直接在添加在src下，结果使用的时候加载不到

Exception in thread "main" java.io.IOException: Could not find resource mybatis-conf.xml
	at org.apache.ibatis.io.Resources.getResourceAsStream(Resources.java:114)
	at org.apache.ibatis.io.Resources.getResourceAsStream(Resources.java:100)
	at Service.UserService.main(UserService.java:18)

解决：IDEA的配置文件必须放在资源文件夹下才会被扫描，scr/main下有resources文件夹，就是用来放配置文件的，拖过去。

3）有的帖子说pojo类和相关的映射文件放在同一个文件下，也会出现上面的问题，同样的，将映射文件拖到resources里去