（二）初学者学习Mybatis首先需要了解什么？

野性酷女 2022-11-22 10:19 158阅读 0赞

这篇文章主要讲述初学者学习Mybatis需要学习的一些常识，本篇文章主要来源于官方文档整理，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧。

## 1、导入依赖 ##

想要使用Mybatis首先我们需要导入Mybatis的jar包，这里我们通过Maven坐标形式引入即可。

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

## 2、创建SqlSessionFactory ##

每个MyBatis应用程序都围绕着Sql会话工厂（SqlSessionFactory）的实例。 使用SqlSessionFactoryBuilder可以获取SqlSessionFactory实例。 Sql Session Factory Builder可以从XML配置文件或配置类的自定义准备实例构建Sql Session Factory实例。

### 通过xml构建SqlSessionFactory ###

从类路径或其他位置加载资源

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

创建xml  
下一篇博客重点讲解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/mybatis" />
    				<property name="username" value="root" />
    				<property name="password" value="123456" />
    			</dataSource>
    		</environment>
    	</environments>
    	
    	<mappers>
    		<mapper resource="EmployeeMapper.xml" />
    	</mappers>
    </configuration>

### Java构建配置SqlSessionFactory ###

如果您希望直接从Java构建配置，而不是XML，或者创建自己的配置生成器，MyBatis提供了一个完整的配置类，它提供了与XML文件相同的所有配置选项

DataSource dataSource = BlogDataSourceFactory.getBlogDataSource();
    TransactionFactory transactionFactory = new JdbcTransactionFactory();
    Environment environment = new Environment("development", transactionFactory, dataSource);
    Configuration configuration = new Configuration(environment);
    configuration.addMapper(BlogMapper.class);
    SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(configuration);

Mapper类是包含SQL Mapping Annotations的Java类，它避免了XML的需要，如果我们是用xml来写的sql，MyBatis将自动查找并加载该文件(在本例中，BlogMapper.xml将根据BlogMapper.class的类路径和名称加载)。

## 3、从Sql会话工厂获取Sql会话 ##

Sql Session绝对包含对数据库执行SQL命令所需的所有方法。 您可以直接针对Sql Session实例执行映射的SQL语句。 例如：

try(SqlSession session = sqlSessionFactory.openSession()) { 
     Blog blog = session.selectOne(
     "org.mybatis.example.BlogMapper.selectBlog", 101);
    }

虽然这种方法是有效的，并且对以前版本的MyBatis用户很熟悉，但是现在有了一种更干净的方法。 使用接口(例如。 正确描述给定语句的参数和返回值的BlogMapper.class，现在可以执行更干净和更类型的安全代码，而不需要容易出错的字符串文字和转换。

try (SqlSession session = sqlSessionFactory.openSession()) { 
     BlogMapper mapper = session.getMapper(BlogMapper.class);
     Blog blog = mapper.selectBlog(101);
    }

## 4、 探索映射SQL语句 ##

在上面的任何一个示例中，语句都可以由XML或注释定义。 让我们先看看XML。 MyBatis提供的全套功能可以通过使用基于XML的映射语言来实现，这使得MyBatis多年来很受欢迎。下面是一个基于XML的映射语句的示例，它将满足上述Sql Session调用。

<?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="org.mybatis.example.BlogMapper">
    	 <select id="selectBlog" resultType="Blog">
    	 	select * from Blog where id = #{ id}
    	 </select>
    </mapper>

他在名称空间定义了org.mybatis.example.BlogMapper，我们就可以通过完整的名称来调用他 名称空间+id = org.mybatis.example.BlogMapper.selectBlog

Blog blog = session.selectOne("org.mybatis.example.BlogMapper.selectBlog", 101);

此名称可以直接映射到与名称空间同名的Mapper类，方法将名称、参数和返回类型匹配为映射的select语句。  
也就是xml当中这个namespace，他相当于和接口的映射。

BlogMapper mapper = session.getMapper(BlogMapper.class);
    Blog blog = mapper.selectBlog(101);

第二种方法有很多优点。 首先，它不依赖于字符串文字，所以它更安全。

## 5、名称空间 ##

名称空间以前在Mybatis是可选的，现在是必填的，命名空间启用了接口绑定。名称空间尽量填写全类名，避免不同包下同id，这样会导致找不到映射id然后报错。

## 6、注解添加sql ##

对于一些sql比较简单的，我们可以直接使用java注解省略xml。当然语句复杂的不建议使用这种

package org.mybatis.example;
    public interface BlogMapper { 
     @Select("SELECT * FROM blog WHERE id = #{id}")
     Blog selectBlog(int id);
    }

## 7、范围和生命周期 ##

依赖注入框架可以创建线程安全、事务性的Sql Sessions和映射器，并将它们直接注入到bean中，这样您就可以忘记它们的生命周期了。

### SqlSessionFactoryBuilder ###

该类可以被实例化、使用和丢弃。 一旦您创建了Sql Session Factory，就没有必要保留它。 因此，Sql SessionFactoryBuilder实例的最佳范围是方法范围(即。 局部方法变量)。 您可以重用Sql Session Factory Builder来构建多个Sql Session Factory实例，但最好不要保留它，以确保所有XML解析资源都被释放出来用于更重要的事情

### SqlSessionFactory ###

一旦创建，Sql Session Factory应该在应用程序执行期间存在。 应该很少或根本没有理由去处理或重新创造它。 不在应用程序运行中多次重建Sql Session Factory是最好的做法。 最简单的方法是使用单例模式或静态单例模式

### SqlSession ###

每个线程都应该有自己的Sql会话实例。 Sql Session的实例不能共享，线程也不安全。 因此，最佳范围是请求或方法范围。 不要将对Sql会话实例的引用保存在静态字段中，甚至是类的实例字段中。 不要将对Sql Session的引用保留在任何托管范围内，例如Servlet框架的Http Session。在收到HTTP请求时，您可以打开Sql会话，然后在返回响应时，您可以关闭它。

openSession.close();

### Mapper Instances ###

映射器是您为绑定到映射语句而创建的接口。 映射器接口的实例是从Sql会话获取的。 因此，从技术上讲，任何映射器实例的最广泛范围与请求它们的Sql会话相同。 然而，映射器实例的最佳范围是方法范围。 也就是说，它们应该在使用它们的方法中被请求，然后被丢弃。 它们不需要明确关闭。

try (SqlSession session = sqlSessionFactory.openSession()) { 
     BlogMapper mapper = session.getMapper(BlogMapper.class);
     // do work
    }