Mybatis入门程序

Mybatis入门程序

1:创建一个maven项目

2:检查maven配置

3:删除src

删除src目录，因为是父工程，所以不需要src

父模块一般作为子模块依赖的管理，它只需要定义好依赖的版本和必须的依赖即可

在父模块的pom.xml导入依赖

<?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.dong</groupId>
    <artifactId>mybatis-demo</artifactId>
    <version>1.0-SNAPSHOT</version>
    <dependencies>
<!--        mybatis依赖-->
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.5.2</version>
        </dependency>
<!--        mysql驱动-->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>5.1.46</version>
        </dependency>
<!--        junit单元测试依赖-->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.12</version>
        </dependency>
    </dependencies>
</project>

## 5:创建一个maven模块

注意：父模块的检查 因为依赖继承

6: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>
    <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>
       <!--每一个Mapper.xml都需要在核心配置文件里注册-->
  <mappers>
    <mapper resource="org/mybatis/example/BlogMapper.xml"/>
  </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>
    <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?useUnicode=true&amp;characterEncoding=utf-8&amp;useSSL=false"/>
                <property name="username" value="root"/>
                <property name="password" value="root"/>
            </dataSource>
        </environment>
    </environments>
      <!--每一个Mapper.xml都需要在核心配置文件里注册-->
  <mappers>
    <mapper resource="com/dong/mapper/UserMapper.xml"/>
  </mappers>
</configuration>   

7:从 XML 构建 SqlSessionFactory,从 SqlSessionFactory 中获取 SqlSession

//从 XML 中构建 SqlSessionFactory
//每个基于 MyBatis 的应用都是以一个 SqlSessionFactory 的实例为核心的。SqlSessionFactory 的实例可以通过 SqlSessionFactoryBuilder 获得。
// 而 SqlSessionFactoryBuilder 则可以从 XML 配置文件或一个预先配置的 Configuration 实例来构建出 SqlSessionFactory 实例。
public class MyBatisUtils {
    private static SqlSessionFactory sqlSessionFactory;
    static {
        try {//第一步：获取sqlSessionFactory对象
            String resource = "mybatis-config.xml";
            InputStream inputStream = Resources.getResourceAsStream(resource);
            sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
    //既然有了 SqlSessionFactory，顾名思义，我们可以从中获得 SqlSession 的实例。
    // SqlSession 提供了在数据库执行 SQL 命令所需的所有方法。你可以通过 SqlSession 实例来直接执行已映射的 SQL 语句
    public static SqlSession getSqlSession(){
        return sqlSessionFactory.openSession();
    }
}

8:编写代码

1：实体类

public class User {
    private Integer id;
    private String name;
    private String pwdd;

    public User() {
    }

    public User(Integer id, String name, String pwdd) {
        this.id = id;
        this.name = name;
        this.pwdd = pwdd;
    }

    public Integer getId() {
        return id;
    }

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

    public String getName() {
        return name;
    }

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

    public String getPwdd() {
        return pwdd;
    }

    public void setPwdd(String pwdd) {
        this.pwdd = pwdd;
    }

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

2:Mapper接口

public interface UserMapper {
     List<User> getUserList();
}

3:接口实现类由原来UserMapperImpl接口变为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="org.mybatis.example.BlogMapper">
  <select id="selectBlog" resultType="Blog">
    select * from Blog where id = #{id}
  </select>
</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:命名空间 Mapper接口全限定类名-->      
<mapper namespace="com.dong.mapper.UserMapper">
    <!--id:接口方法名 resultType:返回值类型(resultType要求类的类名和数据库字段名一致)-->
    <select id="getUserList" resultType="com.dong.pojo.User">
    select * from mybatis.user;
    </select>
</mapper>    

4:bug
1:没有在核心配置文件中配置mapper.xml

org.apache.ibatis.binding.BindingException: Type interface com.dong.mapper.UserMapper is not known to the MapperRegistry.
解决：在核心配置文件中配置mapper.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?userSSl=false"/>
                <property name="username" value="root"/>
                <property name="password" value="root"/>
            </dataSource>
        </environment>
    </environments>
<!--!!!!!!!!每一个Mapper.xml都需要在核心配置文件里注册!!!!!!!-->
    <mappers>
        <mapper resource="com/dong/mapper/UserMapper.xml"/>
    </mappers>
</configuration>

2:Mvaen资源过滤问题

The error may exist in com/dong/mapper/UserMapper.xml
意思是：找不到UserMapper.xml。
原因是：没有把xml放到resource目录下边。idea 的maven项目不会加载非resource目录下边的xml文件。

解决：在pom.xml文件中添加资源过滤，放在<dependencies></dependencies>外边。(防止加载不但建议父子模块pom.xml都放一份)
    
    
    <build>
        <resources>
            <resource>
                <directory>src/main/java</directory>
                <includes>
                    <include>**/*.properties</include>
                    <include>**/*.xml</include>
                </includes>
                <filtering>true</filtering>
            </resource>
            <resource>
                <directory>src/main/resources</directory>
                <includes>
                    <include>**/*.properties</include>
                    <include>**/*.xml</include>
                </includes>
                <filtering>true</filtering>
            </resource>
        </resources>
    </build>
    

9:测试

public class UserDaoTest {
    @Test
    public void test(){
        //获取sqlSession对象
        SqlSession sqlSession = MyBatisUtils.getSqlSession();
        //执行sql
        //方式1：
        //UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        // List<User> userList = mapper.getUserList();
        //方式2：
        List<User> userList = sqlSession.selectList("com.dong.mapper.UserMapper.getUserList");

        for (User user : userList) {
            System.out.println(user);
        }
        sqlSession.close();
    }
}

建议：所有配置文件不要由中文注释 容易出BUG(以上加中文注释方便学习)