mybatis+maven+入门

MyBatis

1.1 概念

MyBatis 本是apache的一个开源项目iBatis, 2010年这个项目由apache software foundation 迁移到了google code，并且改名为MyBatis 。2013年11月迁移到Github。

iBATIS一词来源于“internet”和“abatis”的组合，是一个基于Java的持久层框架。iBATIS提供的持久层框架包括SQL Maps和Data Access Objects（DAOs）

当前，最新版本是MyBatis 3.5.4 ，其发布时间是2020年2月4日。

1.2 基本信息

MyBatis 是一款优秀的持久层框架，它支持定制化 SQL、存储过程以及高级映射。

MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集。

MyBatis 可以使用简单的 XML 或注解来配置和映射原生信息，将接口和 Java 的 POJOs(Plain Ordinary Java Object,普通的 Java对象)映射成数据库中的记录。

1.3 特点

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

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

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

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

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

• 提供xml标签，支持编写动态sql。

1.4 准备工作

1.4.1 准备jar包

mybatis （3.4.6） pom.xml

<dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis</artifactId>
    <version>3.4.6</version>
</dependency>

mysql-connector-java (5.1.6) pom.xml

<!-- https://mvnrepository.com/artifact/mysql/mysql-connector-java -->
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>5.1.6</version>
</dependency>
​

1.4.2 编码

1. 新建库，表（mysql）

database --- books

table --------- tbl_books

2. 新建表的对应实体类（Book.java）com.mf.pojo

            public class Book {
                //只写属性的定义-其余工具产生
                private int bid;
                private String bname;
                private String bauthor;
                private double bprice;
                private String bpublisher;
                private Date bdate;
                private String burl;
                //getters seters  constructor
​
            }

3.mybatis 的核心配置文件（参照官方网站）

3.1 配置mybatis-config.xml文件(获取数据库连接实例的数据源（DataSource）以及决定事务作用域和控制方式的事务管理器（TransactionManager）)

编写mybatis的配置文件 mybatis-config.xml

1- idea开发软件中，默认没有xml文件格式，创建文件时，

a-可以选择普通文件的创建new--file-->文件名.xml-->文件默认为空白文件

b- 自行配置想要的文件类型

 

 

 

<?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://127.0.0.1:3306/books?characterEncoding=utf8"/>
                <property name="username" value="root"/>
                <property name="password" value="mysql"/>
            </dataSource>
        </environment>
    </environments>
  <mappers>
        <!--全局配置文件中，需要映射指定sql文件  注册-->
        <mapper resource="com/mf/dao/BookSqlMapper.xml"/>
    </mappers>
</configuration>

4. mybatis框架中需要开发者自定义一个编写SQL语句的xml文件，一般这个文件是XxxMapper.xml(实体类pojo包)，定义管理该对象（实体类pojo包）SQL语句

BookSqlMapper.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">
<!--namespace:命名空间 文件所在包名+文件名的格式-->
<mapper namespace="com.mf.dao.BookSqlMapper">
    <!--select:写执行查询语句的代码
    id:mybatis中调用方法时需要用的参数
    resultType：sql执行后的返回值类型-->
    <select id="selectBlog" resultType="com.mf.pojo.Book">
        select bid,bname,bauthor from tbl_books
    </select>
</mapper>

5. mybatis执行查询操作

public class TestMybatis {
    @Test
    public void test() throws IOException {
        String resource = "conf/mybatis-config.xml";
        //1- 加载mybatis的配置文件
        InputStream inputStream = Resources.getResourceAsStream(resource);
        //2- 创建一个执行sql语句的工厂对象
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
        //3- 创建一个SqlSession对象： 提供了在数据库执行 SQL 命令所需的所有方法
        SqlSession sqlSession = sqlSessionFactory.openSession();
        //4- 调用SqlSession对象提供的方法，执行sql语句
        List<Book> books =  sqlSession.selectList("com.mf.dao.BookSqlMapper.selectBook");
       //5- 释放资源
        sqlSession.close();
        //6- 查看结果
        for (Book b: books) {
            System.out.println(b);
        }
​
    }
}

6. 补充：

maven项目中，.xml配置文件按照约定需要放在resource文件夹中，如果没有放置，程序无法正确运行，所以需要特别设置pom.xml文件。

​
<!-- 程序放置在  </dependencies>标签结束后
maven项目中，约定大于配置 ,写的配置文件是无法找到，解决方案
    在resources中配置filtering 过滤文件-->
  <build>
    <resources>
        <resource>
            <directory>src/main/java</directory>
            <includes>
                <include>**/*.xml</include>
            </includes>
            <filtering>true</filtering>
        </resource>
    </resources>
  </build>
​