【MyBatis】MyBatis之如何配置

1,MyBatis简介

MyBatis 是支持普通 SQL查询，存储过程和高级映射的优秀持久层框架。MyBatis 消除了几乎所有的JDBC代码和参数的手工设置以及结果集的检索。MyBatis 使用简单的 XML或注解用于配置和原始映射，将接口和 Java 的POJOs（Plain Ordinary Java Objects，普通的 Java对象）映射成数据库中的记录。

2,搭建MyBatis框架

首先就是导入MyBatis.jar的jar包，然后把jar包和数据库连接的包放置到项目的lib目录下。笔者这里使用的是Oracle数据库。

项目结构图如下：

上面这张图片是整个项目结构，下面开始建立文件。

sqlmap-config.xml文件：

<?xml version="1.0" encoding="UTF-8" ?>  <!DOCTYPE configuration             PUBLIC "-//ibatis.apache.org//DTD Config 3.0//EN"            "http://ibatis.apache.org/dtd/ibatis-3-config.dtd">
<configuration>
    <!--引入数据库信息文件-->
    <properties resource="db.properties" />
    
    <environments default="environment">
        <environment id="environment">
            <transactionManager type="JDBC" />
            <dataSource type="POOLED">
                <property name="driver" value="${driverClassName}" />
                <property name="url" value="${url}"/>
                <property name="username" value="${username}" />
                <property name="password" value="${password}" />
            </dataSource>
        </environment>
    </environments>
    <!-- 加载SQL定义文件 -->
    <mappers>
        <mapper resource="cn/test/sql/DeptMapper.xml" />
    </mappers>
</configuration> 

DeptMapper.xml文件：

<?xml version="1.0" encoding="UTF-8" ?>  
<!DOCTYPE mapper PUBLIC "-//ibatis.apache.org//DTD Mapper 3.0//EN"      
 "http://ibatis.apache.org/dtd/ibatis-3-mapper.dtd">
<mapper namespace="cn.test.mapper.DeptMapper">
    
    <!-- 查询操作-->
    <select id="findAll" resultType="cn.test.entity.Dept">
        select * from DEPT
    </select>
    <select id="findById" resultType="cn.test.entity.Dept" parameterType="int">
        select * from DEPT where DEPTNO=#{no}
    </select>
    
    <!--增加操作-->
    <insert id="save" parameterType="cn.test.entity.Dept">
        <!--#{deptno},#{dname},#{loc} 对应着Dept类中变量名称-->
        insert into DEPT(DEPTNO,DNAME,LOC) values (#{deptno},#{dname},#{loc})
    </insert>
    
    <!--修改操作-->
    <update id="upadteNameByNo" parameterType="java.util.Map">
        <!--在map集合中，必需存在两个key，分别为name和no-->
        update DEPT set dname=#{name} where deptno=#{no}
    </update>
    <update id="update" parameterType="cn.test.entity.Dept">
        update DEPT set DNAME=#{dname},LOC=#{loc} where DEPTNO=#{deptno}
    </update>
    
    <!-- 如果parameterType为单个值，#{标识符}表达式标识符没有约定 -->
    <delete id="delete" parameterType="int">
        delete from DEPT where DEPTNO=#{id}
    </delete>
</mapper>

在文件中我们看见 #{deptno} 的代码，表示Dept类实例中的deptno变量。这里除了写成 #{deptno} 还可以写成 ${deptno} 。两者的区别就是#在底层是采用SQL语句预编译插入参数的，$在底层是采用拼接SQL语句插入参数的。

db.properties文件：

driverClassName=oracle.jdbc.OracleDriver
url=jdbc:oracle:thin:@localhost:1521:xe
password=517839
username=system

Dept.java文件：

package cn.test.entity;

import java.io.Serializable;

import org.apache.ibatis.type.Alias;

public class Dept implements Serializable{
    
    private int deptno;
    private String dname;
    private String loc;
    
    public int getDeptno() {
        return deptno;
    }
    public void setDeptno(int deptno) {
        this.deptno = deptno;
    }
    public String getDname() {
        return dname;
    }
    public void setDname(String dname) {
        this.dname = dname;
    }
    public String getLoc() {
        return loc;
    }
    public void setLoc(String loc) {
        this.loc = loc;
    }
    @Override
    public String toString() {
        return "Dept [deptno=" + deptno + ", dname=" + dname + ", loc=" + loc + "]";
    }
}

该实体类的建立，其中实体类的变量名称必须和数据库中表的字段名称一致，否则通过反射就不能赋上正确的值。还有一个小细节，如果数据库中对应表的字段类型为NUMBER，那么在实体类中最好声明为Integer类，而不是基本数据类型int，不过这误伤大雅，因为自从JDK1.5开始支持了自动装箱和自动拆箱了。

笔者的数据库中Dept表结构如下：

DeptMapper.java文件：

package cn.test.mapper;

import java.util.List;
import java.util.Map;

import cn.test.entity.Dept;
/**
*  方法定义参考 SQL 定义的 id 、 parameterType 、 resultType 属性
* @author Administrator
* 1. 方法名与 id 属性一致
* 2. 参数类型与 parameterType 属性一致
* 3. 返回结果：多行查询 List<resultType> ；单行查询 resultType ；增删改为 void 或 int
* 4.SQL 定义文件中 namespace="cn.test.mapper.DeptMapper"
*/
public interface DeptMapper {

    public List<Dept> findAll();
    
    public Dept findById(int id);
    
    public int save(Dept dept);
    
    public int update(Dept dept);
    
    public int delete(int id);

    public int upadteNameByNo(Map map);
}

该接口中所有方法，都必须和DeptMapper.xml中配置的语句方法相对应。语法为id对应方法名，resultType对应返回值类型（如果有多个结果，可以加上List集合），parameterType为参数类型。比如DeptMapper.xml文件中的：

    <select id="findById" resultType="cn.test.entity.Dept" parameterType="int">
        select * from DEPT where DEPTNO=#{no}
    </select>

应该在DeptMapper.java中对应一个方法：

public Dept findById(int id);

MyBatisUtil.java文件：

package cn.test.util;

import java.io.IOException;
import java.io.Reader;

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

public class MyBatisUtil {
    
    public static SqlSession getSession() throws IOException{
        SqlSessionFactoryBuilder builder = new SqlSessionFactoryBuilder();
        Reader reader = Resources.getResourceAsReader("sqlmap-config.xml");
        SqlSessionFactory factory = builder.build(reader);
        SqlSession session = factory.openSession();
        return session;
    }
}

这是一个简单的工具类，该工具用于简化SqlSession对象的获取。

MyBatisTest.java文件：

package cn.test.test;

import java.util.HashMap;
import java.util.List;
import java.util.Map;

import org.apache.ibatis.session.SqlSession;
import org.junit.Test;

import cn.test.entity.Dept;
import cn.test.mapper.DeptMapper;
import cn.test.util.MyBatisUtil;

public class MyBatisTest {

    @Test
    public void testName1() throws Exception {
          SqlSession session = MyBatisUtil.getSession();
          DeptMapper deptDao=session.getMapper(DeptMapper.class);
          Map map=new HashMap();
          map.put("name", "'goslings'");
          map.put("no",40);
          
          //通过编号更新部门名称
          deptDao.upadteNameByNo(map);
         
          //查询所有信息
           List<Dept> list=deptDao.findAll();
           for(Dept d:list){
               System.out.println(d);
           }
           //提交事务，mybatis默认不提交
          session.commit();
          session.close();
    }
}

MyBatis提交事务默认是关闭的，也就是需要手动提交， session.commit(); 。可以进行一些设置，使得Mybatis自动提交事务。

这样为止，一个简单的MyBatis框架就搭建好了。