MyBatis学习（一）

简介

1、MyBatis 是一款优秀的持久层框架，它支持定制化 SQL、存储过程以及高级映射。MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集。MyBatis 可以使用简单的 XML 或注解来配置和映射原生信息，将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java对象)映射成数据库中的记录。

2、MyBatis让程序将主要精力放在SQL上，通过MyBatis提供的映射方式，自由灵活生成（半自动化，大部分需要程序员编写SQL）满足需要SQL语句。

3、MyBatis可以将向 preparedStatement中的输入参数自动进行输入映射，将查询结果集灵活映射成Java对象。（输出映射）

MyBatis的执行流程

 

搭建环境

1、创建一个Java工程

2、在 WEB-INF/lib 中添加相应的jar包，下载地址：https://github.com/mybatis/mybatis-3/releases

这里的jar文件分为两类，一类是MyBaits本生的jar包，另一类在lib文件夹，MyBaits项目所依赖的jar包

• lib下：依赖包
• mybatis-3.4.6.jar：核心 包
• mybatis-3.4.6.pdf，操作指南

要进行连接数据库还需要数据库的l驱动包

第一个入门实例

1、工程结构

2、创建表

--自增长生成主键
DROP TABLE IF EXISTS t_role;

CREATE TABLE t_role(
    id INT(5) NOT NULL AUTO_INCREMENT COMMENT '角色id',
    role_name VARCHAR(150) COMMENT '角色姓名',
    note VARCHAR(150) COMMENT '角色备注',
    PRIMARY KEY (id)
);


INSERT INTO t_role( role_name, note) VALUES ("Saber","fate stay night");
INSERT INTO t_role( role_name, note) VALUES ("鸣人","火影忍者");
INSERT INTO t_role( role_name, note) VALUES ("佐助","火影忍者");

--uuid生成主键
DROP TABLE IF EXISTS t_role;

CREATE TABLE t_role(
    id VARCHAR(36) NOT NULL COMMENT '角色id' ,
    role_name VARCHAR(150) COMMENT '角色姓名',
    note VARCHAR(150) COMMENT '角色备注',
    PRIMARY KEY (id)
);

INSERT INTO t_role( id,role_name, note) VALUES (UUID(),"Saber","fate stay night");
INSERT INTO t_role( id,role_name, note) VALUES (UUID(),"鸣人","火影忍者");
INSERT INTO t_role( id,role_name, note) VALUES (UUID(),"佐助","火影忍者");

3、创建一个POJO(Plain Ordinary Java Object，简单的Java对象)类

package ecut.first.po;

import java.io.Serializable;

public class Role implements Serializable{

    private static final long serialVersionUID = -4663460700843152533L;

    private Integer id;
    
    private String roleName;
    
    private String note;

    public Integer getId() {
        return id;
    }

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

    public String getRoleName() {
        return roleName;
    }

    public void setRoleName(String roleName) {
        this.roleName = roleName;
    }

    public String getNote() {
        return note;
    }

    public void setNote(String note) {
        this.note = note;
    }

    @Override
    public String toString() {
        String s ="id ="+id+",name =" + roleName+", note = " +note;
        return s;
    }
    
    
}

4、添加log4j的支持

在src目录下增加log4j.properties配置文件，内容如下

# Global logging configuration
log4j.rootLogger=DEBUG, stdout
# MyBatis logging configuration...
log4j.logger.ecut.first.mapper=TRACE
# 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

5、编写XML配置文件

参考http://www.mybatis.org/mybatis-3/zh/configuration.html 配 置mybatis的运行环境，数据源、事务已经引入映射文件等。

让Eclipse支持mybatis-config.xml的智能提示，将mybatis-3.4.6.jar中的/org/apache/ibatis/builder/xml/mybatis-3-config.dtd和/org/apache/ibatis/builder/xml/mybatis-3-mapper.dtddtd文件复制到容易查找的目录下，在Eclipse的导航选择Widow下的preferences，选择如下目录

点击Add,显示如下页面，Key Type选择URI

 Location 选择dtd文件所在路径，Key填入http://mybatis.org/dtd/mybatis-3-config.dtd，用一样的方式配置映射文件。

<?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事务管理，事务控制由mybatis-->
            <transactionManager type="JDBC" />
            <!-- 数据库连接池，由mybatis管理-->
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.jdbc.Driver" />
                <property name="url" value="jdbc:mysql://localhost:3306/test?useUnicode=true&amp;characterEncoding=UTF8" />
                <property name="username" value="root" />
                <property name="password" value="123456" />
            </dataSource>
        </environment>

    </environments>

</configuration>

 6、编写映射文件

在配置文件中给role类取别名，方便在映射文件中引用角色类

     <!-- 别名定义 -->
    <typeAliases>
    
        <!-- 批量别名定义 
        指定包名，mybatis自动扫描包中的po类，自动定义别名，别名就是类名（首字母大写或小写都可以）
        -->
        <!-- <package name="ecut.first.po"/> -->
        
        <!-- 针对单个别名定义
        type：类型的路径
        alias：别名
         -->
        <typeAlias type="ecut.first.po.Role" alias="Role"/>
        
    </typeAliases>

编写映射文件

<?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命名空间，作用就是对sql进行分类化管理，理解sql隔离 
注意：使用mapper代理方法开发，namespace有特殊重要的作用
-->
  <mapper namespace="test">
  
     <!-- 在 映射文件中配置很多sql语句 -->
    <!-- 需求：通过id查询角色表的记录 -->
    <!-- 通过 select执行数据库查询
    id：标识 映射文件中的 sql
    将sql语句封装到mappedStatement对象中，所以将id称为statement的id
    parameterType：指定输入 参数的类型，这里指定Integer型 
    #{}表示一个占位符号
    #{id}：其中的id表示接收输入 的参数，参数名称就是id，如果输入 参数是简单类型，#{}中的参数名可以任意，可以value或其它名称
    
    resultType：指定sql输出结果 的所映射的java对象类型，select指定resultType表示将单条记录映射成的java对象。
     -->
      
      <select id="getRole" parameterType="java.lang.Integer" resultType="Role">
          SELECT id , role_name as roleName , note FROM t_role WHERE id = #{value}
      </select>
      
      <!-- 根据note模糊查询角色信息，可能返回多条
    resultType：指定就是单条记录所映射的java对象 类型
    ${}:表示拼接sql串，将接收到参数的内容不加任何修饰拼接在sql中。
    使用${}拼接sql，引起 sql注入
    ${value}：接收输入 参数的内容，如果传入类型是简单类型，${}中只能使用value
     -->
      <select id="getRoles" parameterType="java.lang.String" resultType="Role">
          SELECT id , role_name AS roleName , note FROM t_role WHERE note LIKE '%${value}%'
      </select>
      
      <!-- 添加角色 
    parameterType：指定输入 参数类型是pojo（包括 角色信息）
    #{}中指定pojo的属性名，接收到pojo对象的属性值，mybatis通过OGNL获取对象的属性值
    -->
      <insert id="insertRole" parameterType="Role">
          <!-- 
        将插入数据的主键返回，返回到role对象中
        
        SELECT LAST_INSERT_ID()：得到刚insert进去记录的主键值，只适用与自增主键
        
        keyProperty：将查询到主键值设置到parameterType指定的对象的哪个属性
        order：SELECT LAST_INSERT_ID()执行顺序，相对于insert语句来说它的执行顺序
        resultType：指定SELECT LAST_INSERT_ID()的结果类型
         -->
          <selectKey keyProperty="id" order="AFTER" resultType="java.lang.Integer">
              SELECT LAST_INSERT_ID()
          </selectKey>
          INSERT INTO t_role(role_name, note) VALUES (#{roleName},#{note})
          
          <!-- 
        使用mysql的uuid（）生成主键
        执行过程：
        首先通过uuid()得到主键，将主键设置到role对象的id属性中
        其次在insert执行时，从role对象中取出id属性值
         -->
          <!-- 
          <selectKey keyProperty="id" order="BEFORE" resultType="java.lang.String">
              SELECT UUID()
          </selectKey>
          INSERT INTO t_role(id, role_name, note) VALUES (#{id},#{roleName},#{note}) -->
          
      </insert>
      <!-- 根据id删除角色-->
      <delete id="deleteRole" parameterType="java.lang.Integer" >
          DELETE FROM t_role WHERE id = #{value}
      </delete>
      
      
    <!-- 根据id更新角色
    分析：
    需要传入角色的id
    需要传入角色的更新信息
    parameterType指定role对象，包括 id和更新信息，注意：id必须存在
    #{id}：从输入 role+对象中获取id属性值
     -->
      <update id="updateRole" parameterType="Role" >
          UPDATE t_role SET role_name = #{roleName} , note=#{note} WHERE id = #{id}
      </update>
      
  </mapper>

parameterType和resultType

• 在映射文件中通过parameterType指定输入 参数的类型。
• 在映射文件中通过resultType指定输出结果的类型。

#{}和${}

• #{}表示一个占位符号，#{}接收输入参数，类型可以是简单类型，pojo、hashmap。
• 如果接收简单类型，#{}中可以写成value或其它名称。
• #{}接收pojo对象值，通过OGNL读取对象中的属性值，通过属性.属性.属性...的方式获取对象属性值

• ${}表示一个拼接符号，会引用sql注入，所以不建议使用${}。
• ${}接收输入参数，类型可以是简单类型，pojo、hashmap。
• 如果接收简单类型，${}中只能写成value。
• ${}接收pojo对象值，通过OGNL读取对象中的属性值，通过属性.属性.属性...的方式获取对象属性值。

selectKey标签：

• 在插入数据时候可以通过配置selectKey的方式将插入数据的主键返回，必须指定resultType，不然会抛出org.apache.ibatis.executor.ExecutorException: A query was run and no Result Maps were found for the Mapped Statement 'test.insertRole!selectKey'.  It's likely that neither a Result Type nor a Result Map was specified.

• 对于MySQL自增主键 ，是在执行insert提交之前自动生成一个自增主键。通过LAST_INSERT_ID()函数获取到刚插入记录的自增主键，因此selectKey标签的order是BEFORE
• 对于MySQL非自增返回而是通过UUID()函数生成的主键，是先通过uuid()查询到主键，将主键输入 到sql语句中，需要修改表中id字段类型为string，长度设置成35位。执行uuid()语句顺序相对于insert语句之前执行，因此selectKey标签的order是AFTER

selectOne和selectList

• selectOne表示查询出一条记录进行映射。如果使用selectOne可以实现使用selectList也可以实现（list中只有一个对象）。
•  selectList表示查询出一个列表（多条记录）进行映射。如果使用selectList查询多条记录，不能使用selectOne。
• 如果使用selectOne报错：org.apache.ibatis.exceptions.TooManyResultsException: Expected one result (or null) to be returned by selectOne(), but found:3

在配置文件中加载映射文件

 　　<!-- 加载 映射文件 -->
    <mappers>
        
         <!--通过resource方法一次加载一个映射文件 -->
        <mapper resource="ecut/first/mapper/Role.xml"/>
        <!-- 通过mapper接口加载单个 映射文件
        遵循一些规范：需要将mapper接口类名和mapper.xml映射文件名称保持一致，且在一个目录 中
        上边规范的前提是：使用的是mapper代理方法
         -->
         <!-- <mapper class="ecut.first.mapper.RoleMapper"/> -->
         
         <!-- 批量加载mapper
        指定mapper接口的包名，mybatis自动扫描包下边所有mapper接口进行加载
        遵循一些规范：需要将mapper接口类名和mapper.xml映射文件名称保持一致，且在一个目录 中
        上边规范的前提是：使用的是mapper代理方法
         -->
         <!-- <package name="ecut.first.mapper"/> -->
    </mappers>

 7、编写测试类

package ecut.first.test;

import java.io.IOException;
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 ecut.first.po.Role;

public class FirstTest {

    private SqlSessionFactory factory;

    
    public @Before void init() throws IOException {
        // mybatis配置文件
        String resource = "ecut/first/mybaits-config.xml";
        // 得到配置文件流
        InputStream inputStream = Resources.getResourceAsStream(resource);
        // 创建会话工厂，传入mybatis的配置文件信息
        factory = new SqlSessionFactoryBuilder().build(inputStream);
        // 通过工厂得到SqlSession
    }

    // 根据id查询角色信息，得到一条记录结果
    public @Test void testGetRole() {
        // 通过SqlSession操作数据库
        SqlSession session = factory.openSession();
        // 第一个参数：映射文件中statement的id，等于=namespace+"."+statement的id
        // 第二个参数：指定和映射文件中所匹配的parameterType类型的参数
        // sqlSession.selectOne结果 是与映射文件中所匹配的resultType类型的对象
        // selectOne查询出一条记录
        Role r = session.selectOne("test.getRole", 1);
        System.out.println(r);
        // 释放资源
        session.close();

    }

    // 根据note模糊查询角色列表
    public @Test void testGetRoles() {
        SqlSession session = factory.openSession();
        // list中的role和映射文件中resultType所指定的类型一致
        List<Role> r = session.selectList("test.getRoles", "火影");
        // List<Role> r = session.selectList("test.getRoles", "' or 1=1 or '");
        System.out.println(r);
        // 释放资源
        session.close();

    }
    
    //添加角色信息
    public @Test void testInsertRole() {
        SqlSession session = factory.openSession();
        Role r = new Role();
        r.setRoleName("鸣人");
        r.setNote("火影忍者");
        session.insert("test.insertRole", r);
        System.out.println(r.getId());
        // 提交事务
        session.commit();
        // 获取角色信息主键
        System.out.println(r.getId());
        // 释放资源
        session.close();

    }
    
    //根据id删除角色信息
    public @Test void testDeleteRole() {
        SqlSession session = factory.openSession();
        session.delete("test.deleteRole",2);
        session.commit();
        // 释放资源
        session.close();
    }
    
    //更新角色信息
    public @Test void testUpdatRole(){
        SqlSession session = factory.openSession();
        Role r = new Role();
        //必须设置id
        r.setId(1);
        r.setRoleName("鸣人");
        r.setNote("火影忍者");
        session.update("test.updateRole", r);
        session.commit();
        // 释放资源
        session.close();
    }
    

}

${}表示一个拼接符号，会引用sql注入，所谓的sql注入就是利用现有应用程序，将（恶意）的SQL命令注入到后台数据库执行一些恶意的操作，比如在模糊查询的测试案例中，传入的note是‘or 1=1 or‘ 使我们原本的意图发生了改变，将所有的数据都查询了出来，所以不建议使用${}。

MyBaits和Hibernate的区别和应用场景

hibernate：是一个标准ORM框架（对象关系映射）。入门门槛较高的，不需要程序写sql，sql语句自动生成了。对sql语句进行优化、修改比较困难的。

应用场景：

        适用与需求变化不多的中小型项目，比如：后台管理系统，erp、orm、oa。。

mybatis：专注是sql本身，需要程序员自己编写sql语句，sql修改、优化比较方便。mybatis是一个不完全 的ORM框架，虽然程序员自己写sql，mybatis 也可以实现映射（输入映射、输出映射）。

应用场景：

        适用与需求变化较多的项目，比如：互联网项目。

转载请于明显处标明出处

https://www.cnblogs.com/AmyZheng/p/9346890.html