MyBatis-入门

第一个MyBatis程序

学习任何东西的思路都是：

搭建环境 -> 导入依赖 -> 编写代码 -> 测试

搭建环境

首先安装数据库和数据库管理软件，这里直接使用以前的MySQL和SQLyog，

然后创建相关的数据库和数据表

-- 每个sql语句以分号结尾
CREATE DATABASE mybatis;
USE mybatis;
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;
 
 INSERT INTO `user` VALUES(1,'张三','111'),(2,'李四','000'),(3,'王五','666');

创建父子工程

• 创建父Maven - 空项目

  

• 删除src目录，父工程不写代码的，只管导入依赖

• 配置父工程的pom.xml文件

  
  
      4.0.0
      
      com.hong
      MyBatis-Study
      1.0-SNAPSHOT
  
      
      
          
              mysql
              mysql-connector-java
              5.1.47
          
          
              org.mybatis
              mybatis
              3.4.6
          
          
              junit
              junit
              4.11
          
      
  
  

• 创建模块 -- Maven子项目继承父项目的依赖

  

  

编写配置文件

在子项目的resources目录下创建mybatis-config.xml配置文件

封装工具类

MybatisUtils.java

package com.hong.util;

import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;

import java.io.IOException;
import java.io.InputStream;

/**
 * 封装工具类
 */
public class MybatisUtils {
    private static  SqlSessionFactory sqlSessionFactory ;

    static {
        try {
            // 使用MyBatis的第一步就是获取sqlSessionFactory对象
            String resource = "mybatis-config.xml";
            InputStream inputStream = Resources.getResourceAsStream(resource);
            sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }

    /**
     * 通过工厂生产sqlSession对象
     * @return sql操作对象
     */
    public static SqlSession getSqlSession() {
        return sqlSessionFactory.openSession();
    }
}

编写代码

实体类

Dao接口

接口实现类

1. pojo

   package com.hong.pojo;
   // 实体类
   public class User {
       private int id;
       private String name;
       private String pwd;
   
       public User() {
       }
   
       public User(int id, String name, String pwd) {
           this.id = id;
           this.name = name;
           this.pwd = pwd;
       }
   
       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;
       }
   
       public String getPwd() {
           return pwd;
       }
   
       public void setPwd(String pwd) {
           this.pwd = pwd;
       }
   
       @Override
       public String toString() {
           return "User{" +
                   "id=" + id +
                   ", name='" + name + '\'' +
                   ", pwd='" + pwd + '\'' +
                   '}';
       }
   }
   

2. dao

   package com.hong.dao;
   
   import com.hong.pojo.User;
   
   import java.util.List;
   
   /**
    * 以后的dao都写成mapper
    */
   public interface UserDao {
       // 获取用户列表
       List getUserList();
   }
   

3. 实现类由原来的UserDaoImpl转变为Mapper配置文件

   原来的实现类(对比而已，现在不用了！)

   package com.hong.dao;
   
   import com.hong.pojo.User;
   
   import java.util.List;
   
   /**
    * 以前jdbc时都是写这种实现类
    * 使用MyBatis之后就用xml实现
    */
   public class UserDaoImpl implements UserDao {
       public List getUserList() {
           // 底层的JDBC跟数据库打交道，拿到用户列表后返回
           return null;
       }
   }
   

   Mybatis的Mapper配置文件

   UserMapper.xml

   
   
   
       
       
           select * from mybatis.user
       
   
   

   解释：在xml中不能导入包，所以要写全路径。id绑定的是接口的方法，返回结果是列表中的泛型。中间写sql语句

测试

运行出错跳转到后面看看

UserDaoTest.java

package com.hong.dao;

import com.hong.pojo.User;
import com.hong.util.MybatisUtils;
import org.apache.ibatis.session.SqlSession;
import org.junit.Test;

import java.util.List;

public class UserDaoTest {
    @Test
    public void test() {
        // 获取数据库操作对象
        SqlSession sqlSession = MybatisUtils.getSqlSession();
        try {
            // 方式1 建议使用
            UserDao userDao = sqlSession.getMapper(UserDao.class);
            List userList = userDao.getUserList();

            // 方式2 老版本的获取方式
            // List userList = sqlSession.selectList("com.hong.dao.UserDao.getUserList");
            for (User user : userList) {
                System.out.println(user);
            }
        } catch (Exception e) {
            e.printStackTrace();
        } finally {
            sqlSession.close();
        }
    }
}

解决完报错之后的运行结果

User{id=1, name='张三', pwd='111'}
User{id=2, name='李四', pwd='000'}
User{id=3, name='王五', pwd='666'}

遇到的问题

注意点！这里有很多坑要注意啦

• 没有注册mapper -> 绑定异常 Type interface com.hong.dao.UserDao is not known to the MapperRegistry.

  • 回到核心配置文件mybatis-config.xml中注册mapper

• 找不到资源 -> 可能是静态资源被过滤，查看target目录下有没有UserMapper.xml。也可能是路径写错了

  • 如果在target目录下找不到，则在子项目的pom.xml添加一下代码

     
            
                
                    src/main/resources
                    
                        **/*.properties
                        **/*.xml
                    
                    true
                
                
                    src/main/java
                    
                        **/*.properties
                        **/*.xml
                    
                
            
        
    
    

  • 注册mapper时，路径使用斜杠分隔。com/hong/dao/UserMapper.xml

• 版本兼容问题，报错一字节错误时，将的 UTF-8 改成 UTF8

• 建议不要在xml内出现中文，包括注释

总结

使用配置文件替代原来繁杂的JDBC操作，但思想都是一样的。