深入浅出JAVA MyBatis-快速入门

目录

• 创建项目前的环境搭建
• 简介
• 特点
• (开始)创建Maven项目，导入依赖
• 创建一个新的Maven项目
• (开始)在数据库中创建表
• 创建表详细信息
• 从 XML 中构建 SqlSessionFactory
• 总结：

创建项目前的环境搭建

本篇使用工具：

1、JDK：jdk1.8

2、Mysql l数据库 ：mysql-5.7.31-winx64

3、Maven 开发工具 ：apache-maven-3.8.1

4、IDEA开发工具： IntelliJ IDEA 2020.1.3 x64

在这里我们使用 MyBatis 开发一个简单的 Java 项目完成增删改查（默认你已安装JDK和MySQL及会使用Maven和IDEA的基本操作）

简介

什么是 MyBatis？

MyBatis 是一款优秀的持久层框架，它支持自定义 SQL、存储过程以及高级映射。MyBatis 免除了几乎所有的 JDBC 代码以及设置参数和获取结果集的工作。MyBatis 可以通过简单的 XML 或注解来配置和映射原始类型、接口和 Java POJO（Plain Old Java Objects，普通老式 Java 对象）为数据库中的记录。

特点

1.简单易学本身就很小且简单。没有任何第三方依赖，最简单安装只要两个jar文件+配置几个sql映射文件易于学习，易于使用，通过文档和源代码，可以比较完全的掌握它的设计思路和实现。

2.灵活：mybatis不会对应用程序或者数据库的现有设计强加任何影响。 sql写在xml里，便于统一管理和优化。通过sql语句可以满足操作数据库的所有需求。

解除sql与程序代码的耦合：通过提供DAO层，将业务逻辑和数据访问逻辑分离，使系统的设计更清晰，更易维护，更易单元测试。sql和代码的分离，提高了可维护性。

(1)提供映射标签，支持对象与数据库的orm字段关系映射

(2)提供对象关系映射标签，支持对象关系组建维护

(3)提供xml标签，支持编写动态sql

(开始)创建Maven项目，导入依赖

创建一个新的Maven项目

第一步：

第二步：

第三步：

第四步

第五步

所需依赖

直接放到 pom.xml中即可

<dependencies>
        <!--junit：测试用的-->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.11</version>
            <scope>test</scope>
        </dependency>
        <!--    mybatis依赖-->
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.5.1</version>
        </dependency>
        <!--    mysql驱动-->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>5.1.9</version>
        </dependency>
    </dependencies>
    <build>
    <resources>
        <resource>
            <directory>src/main/java</directory><!--所在目录-->
            <includes><!--包括目录下的 .properties,.xml 文件都会扫描到-->
                <include>**/*.properties</include>
                <include>**/*.xml</include>
            </includes>
            <filtering>false</filtering>
        </resource>
    </resources>
    </build>

(开始)在数据库中创建表

创建 users 表

表名 ：users

userld ：id
userName ： 姓名
userword ： 密码
sex ： 性别
email ：邮箱 

创建表详细信息

添加几条假数据

创建实体类

包名

给实体类添加 有参，无参方法，get，set方法，toString方法

package com.guanshiang.pojo;
//实体类
public class Users {
    private Integer userId;
    private String userName;
    private String userword;
    private String sex;
    private String email;
    public Users() {
    }
    public Users(Integer userId, String userName, String userword, String sex, String email) {
        this.userId = userId;
        this.userName = userName;
        this.userword = userword;
        this.sex = sex;
        this.email = email;
    }
    public Integer getUserId() {
        return userId;
    }
    public void setUserId(Integer userId) {
        this.userId = userId;
    }
    public String getUserName() {
        return userName;
    }
    public void setUserName(String userName) {
        this.userName = userName;
    }
    public String getUserword() {
        return userword;
    }
    public void setUserword(String userword) {
        this.userword = userword;
    }
    public String getSex() {
        return sex;
    }
    public void setSex(String sex) {
        this.sex = sex;
    }
    public String getEmail() {
        return email;
    }
    public void setEmail(String email) {
        this.email = email;
    }
    @Override
    public String toString() {
        return "Users{" +
                "userId=" + userId +
                ", userName='" + userName + '\'' +
                ", userword='" + userword + '\'' +
                ", sex='" + sex + '\'' +
                ", email='" + email + '\'' +
                '}';
    }
}

创建对应的接口，以及映射,xml文件

接口：

package com.guanshiang.mapper;
import com.guanshiang.pojo.Users;
import java.util.List;
//接口 操作Users表
public interface UsersMapper {
    //增加一条
    int addUsers(Users users);
    //删除一条
    int deleteUsersById(int id);
    //修改一条
    int updateUsers(Users users);
    //查询Users表的所有数据
    List<Users> queryUsers();
    //查询Users一条
    Users queryUsersByid(int id);
}

映射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="com.guanshiang.mapper.UsersMapper">
<!--
    select : 表示查询操作
    id：你要执行的sql语法的唯一标识，mybatis会使用这个id的值来找到要执行的sql语句
        可以自定义，但是要求你使用接口中的方法名称。
      resultType : 表示结果类型的，是sql语句执行后得到ResultSet，遍历这个ResultSet得到java对象的类型   执行完sql语句后，返回的java对象的类型
                值写的类型是权限类名称
 -->
    <!--查询所有-->
    <select id="queryUsers" resultType="com.guanshiang.pojo.Users">
        select * from users
    </select>
</mapper>
<!--
    sql映射文件：写sql语句的，mybatis会执行这些sql
    1、指定约束文件
    <!DOCTYPE mapper
        PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
        "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
         mybatis-3-mapper.dtd是约束文件的名称，扩展名是dtd的。
     2、约束文件的作用：现在，检查在当前文件中出现的标签，属性必须符合mybatis的要求
     3、mapper 是当前文件的根标签，必须的。
        namepace：叫做命名空间，唯一值的，可以是自定义的字符串，
                要求你使用dao接口的全限定名称。
     4、在当前文件中，可以使用特定的标签，表示数据库的特定操作。
        <select>: 表示执行查询
        <update>:表示更新数据库的操作，就是在<update>中 写的是update sql语句
        <insert>:表示插入，放的是insert语句
        <delete>:表示删除，执行的delete语句
-->

从 XML 中构建 SqlSessionFactory

以下来自Mybatis官方文档

每个基于 MyBatis 的应用都是以一个 SqlSessionFactory 的实例为核心的。 SqlSessionFactory 的实例可以通过 SqlSessionFactoryBuilder 获得。而 SqlSessionFactoryBuilder 则可以从 XML 配置文件或一个预先配置的 Configuration 实例来构建出 SqlSessionFactory 实例。 从 XML 文件中构建 SqlSessionFactory 的实例非常简单，建议使用类路径下的资源文 件进行配置。 但也可以使用任意的输入流（InputStream）实例，比如用文件路径字符 串或 file:// URL 构造的输入流。MyBatis 包含一个名叫 Resources 的工具类，它包含 一些实用方法，使得从类路径或其它位置加载资源文件更加容易。

String resource = “org/mybatis/example/mybatis-config.xml”; InputStream inputStream = Resources.getResourceAsStream(resource); SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build (inputStream);

XML 配置文件中包含了对 MyBatis 系统的核心设置，包括获取数据库连接实例的数据 源（DataSource）以及决定事务作用域和控制方式的事务管理器 （TransactionManager）。后面会再探讨 XML 配置文件的详细内容，这里先给出一个 简单的示例：

创建XML配置文件

内容如下：

千万注意：下面连接数据库信息，要写你本地的信息。千万注意：下面连接数据库信息，要写你本地的信息。千万注意：下面连接数据库信息，要写你本地的信息。

<!DOCTYPE configuration
        PUBLIC "-//mybatis.org//DTD Config 3.0/EN"
        "http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
<!--    环境配置：数据库的连接信息
        default：必须和某个environment的id值一样。
        告诉mybatis使用哪个数据库的连接信息，也就是访问哪个数据库
        因为可能会有多个environment，也就是会有多个表数据，配置不同的表用不同的id
-->
        <environments default="mydiv">
<!--       environment     一个数据库信息的配置，环境
        id：一个唯一值，自定义：表示环境的名称
-->
            <environment id="mydiv">
<!--
    transactionManager： mybatis的事物务型
        type：JDBC（表示使用jdbc中的Connection对象的commit，rollback做事务处理）
-->
                <transactionManager type="JDBC"/>
<!--
        dataSource：表示数据源，连接数据库的
            type：表示数据源的类型，POOLED表示使用连接池
-->
                <dataSource type="POOLED">
<!--
    driver，user，username，password 是固定的，不能自定义。
-->
                    <!--数据库的驱动名-->
                    <property name="driver" value="com.mysql.jdbc.Driver"/>
                    <!--连接数据库的url字符串-->
                     <property name="url" value="jdbc:mysql://localhost:3306/guan"/>
<!--                    访问数据库的数据名称-->
                    <property name="username"   value="root"/>
<!--                    密码-->
                     <property name="password" value="guanshiang"/>
                </dataSource>
            </environment>
        </environments>
<!--    指定 sql mapper（sql映射文件）的位置-->
        <mappers>
<!--       一个1mapper标签指定一个文件的位置
            从类路径开始的路径信息。 target/clasess(类路径)
     -->
<!--            可出现多次mapper -->
            <mapper resource="com\guanshiang\dao\StudentDao.xml"/>
        </mappers>
</configuration>
<!--
    myvatis的主配置文件：主要定义了数据库的配置信息，sql映射文件的位置。

    1、约束文件的说明
    <!DOCTYPE configuration
        PUBLIC "-//mybatis.org//DTD Config 3.0/EN"
        "http://mybatis.org/dtd/mybatis-3-config.dtd">
        mybatis-3-config.dtd：约束文件名称
    2、configuration：根标签
-->

注意：看文件是否正确

    <mappers>
        <mapper resource="com\guanshiang\dao\StudentDao.xml"/>
    </mappers>

在测试类中测试

在test中创建 测试类 Test01

package com.guanshiang;
import com.guanshiang.pojo.Users;
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.Test;
import java.io.IOException;
import java.io.InputStream;
import java.util.List;
public class Test01 {
    @Test
    public void test() throws IOException {
        //访问mybatis 读取student数据
        //1、定义mybatis主配置文件的名称，从类路径的根开始（target/clasess）
        String config="mybatis.xml";
        //2、读取这个config表示的文件
        InputStream in = Resources.getResourceAsStream(config);
        //3、创建SqlSessionFactoryBuider对象
        SqlSessionFactoryBuilder builder = new SqlSessionFactoryBuilder();
        //4、创建SqlSessionFactory对象
        SqlSessionFactory factory = builder.build(in);
        //5、【重要】获取SqlSession对象，从SqlSessionFactory中获取SqlSession
        SqlSession sqlSession = factory.openSession();
        //6、【重要】指定要执行的sql语句的标识。sql映射文件中的namecapce + "." + 标签的id值
        String sqlId = "com.guanshiang.mapper.UsersMapper"+"."+"queryUsers";
        //7、执行sql语句，通过sqlId执行
        List<Users> users = sqlSession.selectList(sqlId);
        //8、输出
        for (Users u:users){
            System.out.println(u);
        }
        //9、关闭sqlSession对象
        sqlSession.close();
    }
}

运行结果：

Users{userId=2, userName='管世轩', userword='1234', sex='男', email='21@qq.com'}
Users{userId=3, userName='管世盎', userword='weqrwr', sex='男', email='2722696413@qq.com'}
Users{userId=4, userName='管世千', userword='guanshiang', sex='男', email='1234@qq.com'}
Users{userId=10, userName='花花', userword='123456', sex='女', email='2722696413@qq.com'}
Users{userId=11, userName='李博', userword='asdfasf', sex='男', email='2722696413@qq.com'}

总体目录

总结：

本次没有采用Mybatis工具类等。

如果想完成增删改查等，只需要

先写接口，在写对应的sql映射文件.xml

在测试类中测试即可，改变 6、7、8步骤即可

接口已在上面写好。

本篇就先完成一个查询。

备注：感谢前辈们提供的学习资源，
本片借鉴于 ：MyBatis官网文档

本篇文章就到这里了，希望能给你带来帮助，也希望您能够多多关注我们的更多内容！