MyBatis的用法简介

MyBatis 1.简介

MyBatis 是一款优秀的持久层框架
MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的过程
MyBatis 可以使用简单的 XML 或注解来配置和映射原生信息，将接口和 Java 的实体类【Plain Old Java Objects,普通的 Java对象】映射成数据库中的记录。
MyBatis 本是apache的一个开源项目ibatis, 2010年这个项目由apache 迁移到了google code，并且改名为MyBatis 。2013年11月迁移到Github .
Mybatis官方文档 : http://www.mybatis.org/mybatis-3/zh/index.html
GitHub : https://github.com/mybatis/mybatis-3

1.1 为什么学习MyBatis

传统的JDBC编程步骤

1、加载数据库驱动
2、创建并获取数据库链接
3、创建jdbc statement对象
4、设置sql语句
5、设置sql语句中的参数(使用preparedStatement)
6、通过statement执行sql并获取结果
7、对sql执行结果进行解析处理
8、释放资源(resultSet、preparedstatement、connection)

public static void main(String[] args) {
	Connection connection = null;
	PreparedStatement preparedStatement = null;
	ResultSet resultSet = null;

	try {
		// 加载数据库驱动
		Class.forName("com.mysql.jdbc.Driver");

		// 通过驱动管理类获取数据库链接
		connection = DriverManager.getConnection("jdbc:mysql://localhost:3306/mybatis?characterEncoding=utf-8", "root", "root");
		// 定义sql语句 ?表示占位符
		String sql = "select * from user where username = ?";
		// 获取预处理statement
		preparedStatement = connection.prepareStatement(sql);
		// 设置参数，第一个参数为sql语句中参数的序号（从1开始），第二个参数为设置的参数值
		preparedStatement.setString(1, "王五");
		// 向数据库发出sql执行查询，查询出结果集
		resultSet = preparedStatement.executeQuery();
		// 遍历查询结果集
		while (resultSet.next()) {
			System.out.println(resultSet.getString("id") + "  " + resultSet.getString("username"));
		}
	} catch (Exception e) {
		e.printStackTrace();
	} finally {
		// 释放资源
		if (resultSet != null) {
			try {
				resultSet.close();
			} catch (SQLException e) {
				// TODO Auto-generated catch block
				e.printStackTrace();
			}
		}
		if (preparedStatement != null) {
			try {
				preparedStatement.close();
			} catch (SQLException e) {
				// TODO Auto-generated catch block
				e.printStackTrace();
			}
		}
		if (connection != null) {
			try {
				connection.close();
			} catch (SQLException e) {
				// TODO Auto-generated catch block
				e.printStackTrace();
			}
		}
	}
}

MyBatis解决的问题

1、数据库连接创建、释放频繁造成系统资源浪费从而影响系统性能，如果使用数据库连接池可解决此问题。
解决：在SqlMapConfig.xml中配置数据连接池，使用连接池管理数据库链接。
2、Sql语句写在代码中造成代码不易维护，实际应用sql变化的可能较大，sql变动需要改变java代码。
解决：将Sql语句配置在XXXXmapper.xml文件中与java代码分离。
3、向sql语句传参数麻烦，因为sql语句的where条件不一定，可能多也可能少，占位符需要和参数一一对应。
解决： Mybatis自动将java对象映射至sql语句，通过statement中的parameterType定义输入参数的类型。
4、对结果集解析麻烦，sql变化导致解析代码变化，且解析前需要遍历，如果能将数据库记录封装成pojo对象解析比较方便。
解决： Mybatis自动将sql执行结果映射至java对象，通过statement中的resultType定义输出结果的类型。

1.2 MyBatis的优缺点

优点
1. 基于SQL语句编程，相当灵活，不会对应用程序或者数据库的现有设计造成任
  何影响，SQL写在XML里，解除sql与程序代码的耦合，便于统一管理；提供XML
  标签，支持编写动态SQL语句，并可重用。
2. 与JDBC相比，减少了50%以上的代码量，消除了JDBC大量冗余的代码，不需
  要手动开关连接；
3. 很好的与各种数据库兼容（因为MyBatis使用JDBC来连接数据库，所以只要
  JDBC支持的数据库MyBatis都支持）。
4. 能够与Spring很好的集成；
5. 提供映射标签，支持对象与数据库的ORM字段关系映射；提供对象关系映射标
  签，支持对象关系组件维护。
6. 使用的人多（SSM）
缺点
1. SQL语句的编写工作量较大，尤其当字段多、关联表多时，对开发人员编写
  SQL语句的功底有一定要求。
2. SQL语句依赖于数据库，导致数据库移植性差，不能随意更换数据库。

1.3 MyBatis和Hibernate的区别

1 相同点

Hibernate与MyBatis都可以是通过SessionFactoryBuider由XML配置文件生成SessionFactory，然后由SessionFactory 生成Session，最后由Session来开启执行事务和SQL语句。

其中SessionFactoryBuider，SessionFactory，Session的生命周期都是差不多的。Hibernate和MyBatis都支持JDBC和JTA事务处理。
2 不同点

（1）hibernate是全自动，而mybatis是半自动

hibernate完全可以通过对象关系模型实现对数据库的操作，拥有完整的JavaBean对象与数据库的映射结构来自动生成sql。而mybatis仅有基本的字段映射，对象数据以及对象实际关系仍然需要通过手写sql来实现和管理。

（2）hibernate数据库移植性远大于mybatis

hibernate通过它强大的映射结构和hql语言，大大降低了对象与数据库（Oracle、MySQL等）的耦合性，而mybatis由于需要手写sql，因此与数据库的耦合性直接取决于程序员写sql的方法，如果sql不具通用性而用了很多某数据库特性的sql语句的话，移植性也会随之降低很多，成本很高。

（3）hibernate拥有完整的日志系统，mybatis则欠缺一些

hibernate日志系统非常健全，涉及广泛，包括：sql记录、关系异常、优化警告、缓存提示、脏数据警告等；而mybatis则除了基本记录功能外，功能薄弱很多。

（4）mybatis相比hibernate需要关心很多细节

hibernate配置要比mybatis复杂的多，学习成本也比mybatis高。但也正因为mybatis使用简单，才导致它要比hibernate关心很多技术细节。mybatis由于不用考虑很多细节，开发模式上与传统jdbc区别很小，因此很容易上手并开发项目，但忽略细节会导致项目前期bug较多，因而开发出相对稳定的软件很慢，而开发出软件却很快。hibernate则正好与之相反。但是如果使用hibernate很熟练的话，实际上开发效率丝毫不差于甚至超越mybatis。

（5）sql直接优化上，mybatis要比hibernate方便很多

由于mybatis的sql都是写在xml里，因此优化sql比hibernate方便很多。而hibernate的sql很多都是自动生成的，无法直接维护sql；虽有hql，但功能还是不及sql强大，见到报表等变态需求时，hql也歇菜，也就是说hql是有局限的；hibernate虽然也支持原生sql，但开发模式上却与orm不同，需要转换思维，因此使用上不是非常方便。总之写sql的灵活度上hibernate不及mybatis。

（6）缓存机制上，hibernate要比mybatis更好一些

MyBatis的二级缓存配置都是在每个具体的表-对象映射中进行详细配置，这样针对不同的表可以自定义不同的缓存机制。并且Mybatis可以在命名空间中共享相同的缓存配置和实例，通过Cache-ref来实现。

而Hibernate对查询对象有着良好的管理机制，用户无需关心SQL。所以在使用二级缓存时如果出现脏数据，系统会报出错误并提示。
3 总结

MyBatis：机械工具，使用方便，拿来就用，但工作还是要自己来作，不过工具是活的，怎么使由我决定。（小巧、方便、高效、简单、直接、半自动）

Hibernate：智能机器人，但研发它（学习、熟练度）的成本很高，工作都可以摆脱他了，但仅限于它能做的事。（强大、方便、高效、复杂、绕弯子、全自动）

2. 入门 2.1 使用Maven创建

项目工程如下：

建立数据库

CREATE DATAbase `jpa`;
USE `jpa`;
CREATE TABLE `user`(
    `id` INT(20) NOT NULL PRIMARY KEY,
    `age` INT(30) DEFAULT NULL,
    `name` VARCHAR(30) DEFAULT NULL
)ENGINE=INNODB DEFAULT CHARSET=utf8;
INSERT INTO `user`(`id`,`age`,`name`) VALUES
(1,10,'小明'),
(2,34,'小李'),
(3,21,'小王');

建pom

  
  
      
          Mybatis
          com.ui
          1.0-SNAPSHOT
      
      4.0.0
  
      Demo
      
          
          
          
              mysql
              mysql-connector-java
              5.1.46
          
          
          
          
              org.mybatis
              mybatis
              3.5.2
          
          
          
          
              junit
              junit
              4.12
              test
          
  
      
      
          UTF-8
      
  
      
          
              
                  src/main/resources
                  
                      ***.xml
                  
                  true
              
              
                  src/main/java
                  
                      ***.xml
                  
                  true

写配置文件

文件名：mybatis-config.xml

编写业务类

public class User {
    private Integer id;
    private String name;
    private Integer age;

    public User(String name, Integer age){
        this.name = name;
        this.age = age;
    }

编写DAO接口

public interface UserDao {
    List getUserList(); //实现查询数据库
}

编写Mapper文件

通常在此处进行编写sql语句。





    
    
        select * from jpa.user

编写Mapper文件
编写连接工具类

//sqlSessionFactory
public class MybatisUtils {
    private static  SqlSessionFactory sqlSessionFactory;
    static {
        try {
            //使用Mybatis第一步：获取sqlSessionFactory对象
            String resource = "mybatis-config.xml";
            InputStream inputStream = Resources.getResourceAsStream(resource);
            sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
    //既然有了 SqlSessionFactory，顾名思义，我们可以从中获得 SqlSession 的实例。
    // SqlSession 提供了在数据库执行 SQL 命令所需的所有方法。
    public static SqlSession getSqlSession(){
        return sqlSessionFactory.openSession();
    }
}

测试

public class UserDaoTest {
    @Test
    public void test(){
        //第一步：获取sqlsession对象
        SqlSession sqlSession = MybatisUtils.getSqlSession();

        //1.getmapper(推荐)
        //该方法有很多优势，首先它不依赖于字符串字面值，会更安全一点；其次，如果你的 IDE 有代码补全功能，那么代码补全可以帮你快速选择到映射好的 SQL 语句
        UserDao mapper = sqlSession.getMapper(UserDao.class);
        //List userList = mapper.getUserList();
        //2.直接使用
        //List userList = sqlSession.selectList("com.ui.dao.UserDao.getUserList");

        
        List userList = mapper.getUserList();
        for (User user : userList) {
            System.out.println(user);
        }
        sqlSession.close();

    }
}

测试结果

2.2 Spring Boot整合MyBatis (推荐)

项目工程如下：

建立数据库

CREATE DATAbase `jpa`;
USE `jpa`;
CREATE TABLE `user`(
    `id` INT(20) NOT NULL PRIMARY KEY,
    `age` INT(30) DEFAULT NULL,
    `name` VARCHAR(30) DEFAULT NULL
)ENGINE=INNODB DEFAULT CHARSET=utf8;
INSERT INTO `user`(`id`,`age`,`name`) VALUES
(1,10,'小明'),
(2,34,'小李'),
(3,21,'小王');

建pom



    4.0.0

    com.yinan
    SpringBootMyBatis
    1.0-SNAPSHOT

    
        org.springframework.boot
        spring-boot-starter-parent
        2.1.4.RELEASE
         
    
    


        
        
            org.mybatis.spring.boot
            mybatis-spring-boot-starter
            1.3.1
        
        
        
            mysql
            mysql-connector-java
            8.0.22
        
        
        
            org.springframework.boot
            spring-boot-starter-web
        
        
        
            org.springframework.boot
            spring-boot-starter-test
            test
        

        
            junit
            junit
            4.11
            test

写Application.properties

## Mybatis 配置
##mybatis.typeAliasesPackage指向实体类包路径。
mybatis.typeAliasesPackage=com.yinan.springboot.entities
# mybatis.mapperLocations 配置为 classpath 路径下 mapper 包下， * 代表会扫描所有 xml ?件。
mybatis.mapperLocations=classpath:mapper/*.xml


spring.datasource.name=jpa
spring.datasource.url=jdbc:mysql://localhost:3306/jpa?useSSL=false&serverTimezone=GMT%2B8
spring.datasource.username=root
spring.datasource.password=12345

启动类

@SpringBootApplication
// ⽤这个注解可以注册 Mybatis mapper 接⼝类。
@MapperScan("com.yinan.springboot.dao")
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class,args);
    }
}

业务类

public class User {
    private Integer id;
    private String name;
    private Integer age;

    public User(String name, Integer age) {
        this.name = name;
        this.age = age;
    }

    public User() {
    }

    public User(Integer id, String name, Integer age) {
        this.id = id;
        this.name = name;
        this.age = age;
    }
    //getset方法

dao层

@Component
public interface UserDao {
    User findById(@Param("id") Integer name);
}

Mapper配置文件





    
    
        select  *
        from user
        where id = #{id,jdbcType=INTEGER}

Service层

public interface UserService {
    //通过用户id获取对象
    User getUserById(Integer id);
}

Service层实现类

@Service
public class UserServiceImpl implements UserService {

    @Autowired
    private UserDao userDao;
    @Override
    public User getUserById(Integer id) {
        User user = userDao.findById(id);
        return user;
    }
}

Controller层

@RestController
@RequestMapping(value = "/users")
public class UserController {
    @Autowired
    private UserService userService;
    @GetMapping(value = "/{id}")
    public User getUser(@PathVariable(name = "id") Integer id){
        //路径：http://localhost:8080/users/1
        return userService.getUserById(id);
    }
//    @GetMapping
//    public User getUser(@RequestParam(name = "id") Integer id){
          //http://localhost:8080/users?id=1
//        return userService.getUserById(id);
//    }
}

启动主启动类进行web测试

3. CRUD 3.1 select

选择、查询语句：
- id：就是对应的namespace中的方法名
- resultType: sql语句执行的返回值！
- parameterType:参数类型
1.编写接口

//根据id查询用户
User getUserById(int id);

2.编写mapper中对应的sql语句