MyBatis 学习总结 01 快速入门 OLD

Posted 2020-10-07

 

 一、Mybatis介绍

　　

　　MyBatis是一个支持普通SQL查询，存储过程和高级映射的优秀持久层框架。MyBatis消除了几乎所有的JDBC代码和参数的手工设置以及对结果集的检索封装。MyBatis可以使用简单的XML或注解用于配置和原始映射，将接口和Java的POJO（Plain Old Java Objects，普通的Java对象）映射成数据库中的记录。mybatis提供一种“半自动化”的ORM实现。这里的“半自动化”，是相对Hibernate等提供了全面的数据库封装机制的“全自动化”ORM实现而言，“全自动”ORM实现了POJO和数据库表之间的映射，以及 SQL 的自动生成和执行。mybatis的重点是在于POJO与SQL之间的映射关系。

　　MyBatis官方网址： http://www.mybatis.org

　　MyBatis官网的简体中文地址，有兴趣的小伙伴去逛逛吧。

       MyBatista api 地址：http://tool.oschina.net/apidocs/apidoc?api=mybatis-3.1.1

　　MyBatis在github上的网址： https://github.com/mybatis/mybatis-3

　   MyBatis参考PPT： https://wenku.baidu.com/view/86e643d055270722182ef7ae.html

二、mybatis快速入门

1 准备开发环境

1 首先建立项目java web

　　使用Eclipse创建测试项目，创建的测试项目是Java项目或JavaWeb项目都可以。

　　使用Eclipse创建JavaWeb项目步骤， File -> New -> Dynamic Web Project 新建一个Java Web项目，项目名字为： MyBatis01 

2 添加mybatis所需的jar包

 

mybatis需要jar包：mybatis-3.4.5.jar
mysql驱动jar包：mysql-connector-java-5.1.6n.jar
日志记录jar包：log4j-1.2.17.jar

3 创建数据库和表

　　针对mysql数据库。创建数据库和表的脚本。

DROP TABLE IF EXISTS `myDb`;

create database myDb;

use myDb

  CREATE TABLE users(id INT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(20), age INT);

 

　INSERT INTO users( username , age ) VALUES ( ‘zhangsan‘ , ‘21‘);

  INSERT INTO users( username , age ) VALUES ( ‘lisi‘ , ‘22‘);

　　至此，前期的开发环境准备工作全部完成。还可以使用以下脚本创建一个与users表同样结构的测试表 user1

create table user1 as select * from users;

 

2 使用myBatist查询表中的数据

1 添加mybatis的配置文件 mybatis.cfg.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/myDb?useUnicode=true&amp;characterEncoding=utf8" />
                <property name="username" value="root" />
                <property name="password" value="123456" />
            </dataSource>
        </environment>
    </environments>
    
</configuration>

 

2 定义表对应的实体类，如下图所示

User类的代码如下：

package com.mybatis.pojo;

/**
 * 
 * users表所对应的实体类
 * 
 * */
public class User  
{
    //实体类的属性和表的字段名称一一对应
    private int id;
    private String username ;
    private int age;
    public int getId()
    {
        return id;
    }
    public void setId(int id)
    {
        this.id = id;
    }
    public String getUsername()
    {
        return username;
    }
    public void setUsername(String username)
    {
        this.username = username;
    }
    public int getAge()
    {
        return age;
    }
    public void setAge(int age)
    {
        this.age = age;
    }
    @Override
    public String toString()
    {
        return "User [id=" + id + ", username=" + username + ", age=" + age + "]";
    }

 
}

 

3 定义操作users表的sql映射文件userMapper.xml 

 　　创建一个com.mybatis.mapping包，专门用于存放sql映射文件，在包中创建一个userMapper.xml文件，如下图所示：

　　userMapper.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，namespace的值习惯上设置成包名+sql映射文件名，这样就能够保证namespace的值是唯一的
例如namespace="com.mybatis.mapping.userMapper"就是com.mybatis.mapping(包名)+userMapper(userMapper.xml文件去除后缀)
 -->
<mapper namespace="com.mybatis.mapping.userMapper">
    <!-- 在select标签中编写查询的SQL语句， 设置select标签的id属性为getUser，id属性值必须是唯一的，不能够重复
    使用parameterType属性指明查询时使用的参数类型，resultType属性指明查询返回的结果集类型
    resultType="com.mybatis.pojo.User"就表示将查询结果封装成一个User类的对象返回
    User类就是users表所对应的实体类
    -->
    <!-- 
        根据id查询得到一个user对象
     -->
    <select id="getUser" parameterType="int" 
        resultType="com.mybatis.pojo.User">
        select * from users where id=#{id}
    </select>
</mapper>

 　　通过 <select>节点映射数据库中的表与java中的实体类User。尝试 把查询语句改为以下内容，是否还会有相同内容呢。

 select * from user1 where id=#{id}

4 在 mybatis.conf.xml文件中注册  userMapper.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/myDb?useUnicode=true&amp;characterEncoding=utf8" />
                <property name="username" value="root" />
                <property name="password" value="123456" />
            </dataSource>
        </environment>
    </environments>
    
     <mappers>
        <!-- 注册userMapper.xml文件， 
        userMapper.xml位于com.mybatis.mapping这个包下，所以resource写成com/mybatis/mapping/userMapper.xml -->
        <mapper resource="com/mybatis/mapping/userMapper.xml"/>
    </mappers>
    
</configuration>

 连接数据库配置的url地址，可以指定字符串的编码格式为UTF8， 其中 &amp代表转义字符，可以参考网友的这篇文章。

 

5 编写测试代码：执行定义的select语句

　　创建一个TestMyBatis1类，编写如下的测试代码： 

package com.mybatis.test;

import java.io.InputStream;
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;

import com.mybatis.pojo.User;

public class TestMyBatis1
{
    public void testSel1(){
        try{
             //mybatis的配置文件
            String resource = "mybatis.cfg.xml";
            //使用类加载器加载mybatis的配置文件（它也加载关联的映射文件）
            InputStream is = TestMyBatis1.class.getClassLoader().getResourceAsStream(resource);
            //构建sqlSession的工厂
            SqlSessionFactory sessionFactory = new SqlSessionFactoryBuilder().build(is);
            //使用MyBatis提供的Resources类加载mybatis的配置文件（它也加载关联的映射文件）
            //Reader reader = Resources.getResourceAsReader(resource); 
            //构建sqlSession的工厂
            //SqlSessionFactory sessionFactory = new SqlSessionFactoryBuilder().build(reader);
            //创建能执行映射文件中sql的sqlSession
            SqlSession session = sessionFactory.openSession();
            
            /**
             * 映射sql的标识字符串，
             * com.mybatis.mapping.userMapper是userMapper.xml文件中mapper标签的namespace属性的值，
             * getUser是select标签的id属性值，通过select标签的id属性值就可以找到要执行的SQL
             */
            String statement = "com.mybatis.mapping.userMapper.getUser";//映射sql的标识字符串
            //执行查询返回一个唯一user对象的sql
            User user = session.selectOne(statement, 1);
            System.out.println(user);
        }catch(Exception e){
            e.printStackTrace();
        }
    }
    
    public void testSel2(){
        try{
             //mybatis的配置文件
            String resource = "mybatis.cfg.xml";
         
            //使用MyBatis提供的Resources类加载mybatis的配置文件（它也加载关联的映射文件）
            Reader reader = Resources.getResourceAsReader(resource); 
            //构建sqlSession的工厂
            SqlSessionFactory sessionFactory = new SqlSessionFactoryBuilder().build(reader);
            //创建能执行映射文件中sql的sqlSession
            SqlSession session = sessionFactory.openSession();
            
            /**
             * 映射sql的标识字符串，
             * com.mybatis.mapping.userMapper是userMapper.xml文件中mapper标签的namespace属性的值，
             * getUser是select标签的id属性值，通过select标签的id属性值就可以找到要执行的SQL
             */
            String statement = "com.mybatis.mapping.userMapper.getUser";//执行查询返回一个唯一user对象的sql
            User user = session.selectOne(statement, 1);
            System.out.println(user);
        }catch(Exception e){
            e.printStackTrace();
        }
    }
    
    public static void main(String[] args)
    {
        TestMyBatis1 demo = new TestMyBatis1();
        //demo.testSel1();
        demo.testSel2();

    }

}

执行结果如下：

 可以看到，数据库中的记录已经成功查询出来了。

 

6 本节完整例子下载地址为： http://onl5wa4sd.bkt.clouddn.com/MyBatis01.rar

7  使用Maven工程创建以上实验。

pom.xml参考内容：

<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.bank</groupId>
  <artifactId>MyBatis04</artifactId>
  <version>0.0.1</version>
  <packaging>jar</packaging>

  <name>MyBatis04</name>
  <url>http://maven.apache.org</url>

  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
  </properties>

  <dependencies>
    
    <dependency>
        <groupId>log4j</groupId>
        <artifactId>log4j</artifactId>
        <version>1.2.17</version>
    </dependency>
    
     <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis</artifactId>
        <version>3.4.5</version>
    </dependency>
    
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>5.1.6</version>
    </dependency>

  </dependencies>
</project>

　　测试完整例子可以从以下地址下载 ： http://ovy7j2mnc.bkt.clouddn.com/MavenMyBatis01.rar