关于搭建MyBatis框架

Posted 2020-10-29 美国大兵

由于在【关于使用Mybatis的使用说明（一）http://www.cnblogs.com/zdb292034/p/8675766.html】中存在不太完善地方，通过此片文档进行修订；

阅读指南：（1）本Mybatis中使用最简洁的方式；（2）使用mapper接口代理的形式，实现dao层；（3）使用oracle数据库，需要创建user1表；

（一）搭建Mybatis环境：

（1）新建java工程，导入jar包：jar包下载可以在百度云盘中（待上传）

（2）创建文件夹config,配置log4j.properties

# Global logging configuration
log4j.rootLogger=DEBUG, stdout
# Console output...
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%5p [%t] - %m%n

（3）配置db.properties

jdbc.driver=oracle.jdbc.driver.OracleDriver
jdbc.url=jdbc:oracle:thin:@localhost:1521:cmskf
jdbc.username=cmskf
jdbc.password=cmskf

（4）配置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"/>
     <!-- 定义单个pojo类别名
         type:pojo类的全路径名称
         alias:别名 
     -->
    <!--<typeAliases>
          <typeAlias type="com.dbzhand.pojo.User" alias="user"/>
     </typeAliases> -->
     <!-- 也可以使用包扫描方式定义批量别名
     定义别名等于类型，不区分大小写，但是建议按照java命名规则，首字母小写，以后每个单词的首字母大写
      -->
     <typeAliases>
         <package name="com.dbzhand.pojo"/>
     </typeAliases>
    <environments default="development">
    <!-- 配制该标签的时候要有一定的顺序：事务管理器、数据库连接 -->
        <environment id="development">
            <transactionManager type="JDBC"/>
            <dataSource type="POOLED">
                <property name="driver" value="${jdbc.driver}"/>
                <property name="url" value="${jdbc.url}"/>
                <property name="username" value="${jdbc.username}"/>
                <property name="password" value="${jdbc.password}"/>
            </dataSource>
        </environment>
    </environments>
    <!-- 加载映射配置文件 -->
    <mappers>
        <!-- 加载mapper接口所在的包，否则会报绑定无效 -->
        <package name="com.dbzhang.mapper"/>
    </mappers>
</configuration>

（5）创建pojo类：

package com.dbzhand.pojo;

import java.util.Date;

public class User {
    private int id;
    @Override
    public String toString() {
        return "User [id=" + id + ", name=" + name + ", sex=" + sex
                + ", birthday=" + birthday + ", address=" + address + "]";
    }
    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;
    }
    public String getSex() {
        return sex;
    }
    public void setSex(String sex) {
        this.sex = sex;
    }
    public Date getBirthday() {
        return birthday;
    }
    public void setBirthday(Date birthday) {
        this.birthday = birthday;
    }
    public String getAddress() {
        return address;
    }
    public void setAddress(String address) {
        this.address = address;
    }
    private String sex;
    private Date birthday;
    private String address;
    
}

（6）创建映射文件和映射接口：主要这个两个文件要在同一个包下：

package com.dbzhang.mapper;

import java.util.List;

import com.dbzhand.pojo.User;

public interface UserMapper {

    public User findUserById(Integer id);
    //动态代理形式中，如果返回的结果集为list，mybatis会在生成实现类的时候自动调用selectList方法
    public List<User> fingUserByName(String username);
    public void insertUser(User user);
}

 

<?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接口代理实现编写规则：
 1.映射文件中namespace要等于接口的全路径名称
 2.映射文件中sql语句id要等于接口的方法名称
 3.映射文件中传入参数的类型要和接口方法的传入参数类型一样
 4.映射文件中返回结果集类型要等于接口方法的返回值类型
  -->
  <mapper namespace="com.dbzhang.mapper.UserMapper">
          
    <!-- 
    id:sql语句唯一标识
    parameterType:指定传入参数类型
    resultType:返回结果集的类型
    #{}占位符：启到占位作用，如果传入参数类型为基本类型，那么#{}中的变量名称可以随便写。
     -->
     <select id="findUserById" parameterType="java.lang.Integer" resultType="com.dbzhand.pojo.User">
         select * from user1 where id=#{id}
     </select>
     
    <!-- 
    如果返回结果为集合，可以调用selectList方法，这个方法返回的就是一个集合，所以映射文件中应该配置成集合泛型的类型
    ${}拼接符：字符串原样拼接，如果传入的参数为基本类型（String/long/double/int/boolean/float等），那么${}中的变量名称必须为value
    注意：拼接符sql会有注入的风险
     -->
     <select id="fingUserByName" parameterType="java.lang.String" resultType="user">
         select * from user1 where name like \'%${value}%\'
     </select>
  
  </mapper>

（7）创建测试类：

package com.dbzhang.test;


import java.io.InputStream;
import java.util.List;

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 org.junit.Before;
import org.junit.Test;
import com.dbzhand.pojo.User;
import com.dbzhang.mapper.UserMapper;

public class UserMapperTest {
    private SqlSessionFactory factory;
    //在测试方法之前执行
    @Before
    public void setUp() throws Exception{
        String resource = "SqlMapConfig.xml";
        //通过流将核心配制文件加载进来
        InputStream inputStream = Resources.getResourceAsStream(resource);
        //通过核心流创建会话工厂
        factory = new SqlSessionFactoryBuilder().build(inputStream);
    }
    @Test
    public void testFindUserById(){
        //通过工厂创建会话
        SqlSession sqlSession = factory.openSession();
        //通过getMapper方法来实例化接口
        UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
        User user = userMapper.findUserById(2);
        System.out.println(user);
    }
    @Test
    public void testFingUserByName(){
        //打开会话
        SqlSession sqlSession = factory.openSession();
        //通过getMapper这个方法实例化接口
        UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
        List<User> list = userMapper.fingUserByName("张");
        System.out.println(list);
    }
}