MyBatis 学习总结---理论化知识点（一）

      之前都是以编写实例代码为切入点来学习了MyBatis框架，现在以理论化的知识为切入点来学习。

提供个MyBatis官方用户指南的网址：http://www.mybatis.org/mybatis-3/zh/configuration.html    毕竟是第一手资料。

1.1    简介MyBatis 3.2.2

什么是MyBatis?
MyBatis 是支持普通 SQL
查询,存储过程和高级映射的优秀持久层框架。MyBatis 消除 了几乎所有的 JDBC 代码和参数的手工设置以及结果集的检索。MyBatis 使用简单的
XML或注解用于配置和原始映射,将接口和 Java 的POJOs(PlanOld Java Objects,普通的Java对象)映射成数据库中的记录。

1.2    入门

每 一 个 MyBatis 的 应 用 程 序 都 以 一 个 SqlSessionFactory 对 象 的 实 例 为 核 心 。SqlSessionFactory对 象 的 实 例 可 以 通 过SqlSessionFactoryBuilder 对 象 来 获得 。SqlSessionFactoryBuilder 对象可以从 XML 配置文件,或从 Configuration 类的习惯准备的实例中构建 SqlSessionFactory 对象。

1.2.1       从 XML 中构建 SqlSessionFactory

从 XML 文件中构建 SqlSessionFactory 的实例非常简单。这里建议你使用类路径下的资源文件来配置,但是你可以使用任意的 Reader 实例,这个实例包括由文字形式的文件路径或URL形式的文件路径 file://来创建。MyBatis 包含了一些工具类,称作为资源,这些工具类包含一些方法,这些方法使得从类路径或其他位置加载资源文件更加简单。
Stringresource = "org/mybatis/example/mybatis-config.xml";
InputStreaminputStream = Resources.getResourceAsStream(resource);
sqlSessionFactory= new SqlSessionFactoryBuilder().build(inputStream);
XML 配置文件包含对MyBatis系统的核心设置,包含获取数据库连接实例的数据源和 决定事务范围和控制的事务管理器。关于 XML 配置文件的详细内容可以在后面找到, 这里给出一个简单的示例:
<?xmlversion="1.0" encoding="UTF-8" ?>
<!DOCTYPEconfiguration
PUBLIC"-//mybatis.org//DTD Config 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
<environmentsdefault="development">
<environmentid="development">
<transactionManagertype="JDBC"/>
<dataSourcetype="POOLED">
<propertyname="driver" value="${driver}"/>
<propertyname="url" value="${url}"/>
<propertyname="username" value="${username}"/>
<propertyname="password" value="${password}"/>
</dataSource>
</environment>
</environments>
<mappers>
<mapperresource="org/mybatis/example/BlogMapper.xml"/>
</mappers>
</configuration>
要注意 :
  XML头部的声明,需要用来验证 XML 文档正确性。
  environment 元素体中包含对事 务管理和连接池的环境配置。
  mappers 元素是包含所有 mapper 映射器的列表,
  mapper 的 XML 文件包含 SQL代码和映射定义信息。

1.2.2       不使用 XML 构建 SqlSessionFactory

可以从Java 程序而不是 XML 文件中直接创建配置实例, 或创建你自己的配置构建
器,MyBatis 也提供完整的配置类,提供所有从 XML 文件中加载配置信息的选项。

DataSourcedataSource = BlogDataSourceFactory.getBlogDataSource();
TransactionFactorytransactionFactory = new JdbcTransactionFactory();
Environmentenvironment = new Environment("development", transactionFactory,dataSource);
Configurationconfiguration = new Configuration(environment);
configuration.addMapper(BlogMapper.class);
SqlSessionFactory  sqlSessionFactory= new SqlSessionFactoryBuilder().build(configuration);
注意这种情况下配置是添加映射类。映射类是 Java 类,这些类包含 SQL 映射语句的注解从而避免了XML文件的依赖, XML 映射仍然在大多数高级映射 (比如: 嵌套 Join 映射) 时需要。出于这样的原因,如果存在
XML 配置文件的话,MyBatis
将会自动查找和加载一 个对等的 XML
文件(这种情况下,基于类路径下的
BlogMapper.class 类的类名,那么
BlogMapper.xml 将会被加载)。此句不知道啥意思。

1.3    从 SqlSessionFactory 中获取SqlSession

现在,我们已经知道如何获取 SqlSessionFactory 对象了,基于同样的启示,我们就可以获得SqlSession的实例了。

SqlSession 对象完全包含以数据库为背景的所有执行 SQL 操作的 方法。
获取它的方法同样有两种：

  你可以用 SqlSession 实例来直接执行已映射的 SQL 语句。（调用xml中的sql）
  使用合理描述参数和 SQL 语句返回值的接口(比如 BlogMapper.class) ,这样现在就 可以至此那个更简单更安全的代码,没有容易发生的字符串文字和转换的错误。(把xml映射成对象来调用其中方法。)

1.4    探究已映射的 SQL 语句

上面提到的任何一个示例,语句是通过 XML 或注解定义的。

  基于xml的sql映射语句。

在 命 名 空 间“com.mybatis.example.BlogMapper”中,它定义了一个名为“selectBlog”的映射语句,这 样它允许你使用完全限定名 “org.mybatis.example.BlogMapper.selectBlog” 来调用映射语句, 我们下面示例中所有的写法也是这样的。 Blog blog = (Blog) session.selectOne("org.mybatis.example.BlogMapper.selectBlog", 101);

<?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" parameterType="int" resultType="Blog"> select * from Blog where id = #{id} </select> </mapper>

  第二种方式

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

第二种方式有很多优点,首先它不是基于文字的,那就更安全了。 第二,如果你的 IDE 有代码补全功能,那么你可以利用它来操纵已映射的 SQL 语句。 第三,不需要强制类型转 换,同时 BlogMapper 接口可以保持简洁,返回值类型很安全(参数类型也很安全) 。

1.5    重要 命名空间的一点注释

命名空间 在之前版本的 MyBatis 中是可选项,非常混乱也没有帮助。现在,命名空间是必须的,而且有一个目的,它使用更长的完全限定名来隔离语句。命名空间使得接口绑定成为可能,就像你看到的那样,如果之前不了解,那么现在你 就会使用它们了,你应该按照下面给出示例的来练习,以免改变自己的想法。使用命名空 间,并将它放在合适的 Java 包空间之下,将会使你的代码变得简洁,在很长的时间内提高MyBatis的作用。
命名解析: 为了减少输入量,MyBatis 对所有的命名配置元素使用如下的命名解析规 则,包括语句,结果映射,缓存等。
n  直接查找完全限定名(比如“com.mypackage.MyMapper.selectAllThings”, )如果发现就使用。
n  短名称(比如“selectAllThings” )可以用来引用任意含糊的对象。而如果有两个 或两个以上的(比如“com.foo.selectAllThings ”和“com.bar.selectAllThings” ), 那么就会得到错误报告,说短名称是含糊的,因此就必须使用完全限定名。
 
如 BlogMapper 这样的映射器类来说,还有一个妙招。它们中间映射的语句可以不需要在 XML 中来写,而可以使用 Java 注解来替换。比如,上面的 XML 示例可以如下来替换:
packageorg.mybatis.example;
publicinterface BlogMapper {
@Select("SELECT* FROM blog WHERE id = #{id}")
BlogselectBlog(int id);
}
对于简单语句来说,使用注解代码会更加清晰,然而 Java 注解对于复杂语句来说就会混乱, 应该限制使用。 因此, 如果你不得不做复杂的事情, 那么最好使用 XML 来映射语句。
当然这也取决于你和你的项目团队的决定, 看哪种更适合你来使用, 还有以长久方式来使用映射语句的重要性。也就是说,不要将自己局限在一种方式中。你可以轻松地将注解换成 XML映射语句,反之亦然。

1.6    范围和生命周期

理解我们目前已经讨论过的不同范围和生命周期类是很重要的。 不正确的使用它们会导 致严重的并发问题。

SqlSessionFactoryBuilder	方法范围 (也就是本地方法变量)
SqlSessionFactory	的最佳范围是应用范围。
SqlSession	范围是请求或方法范围。

SqlSessionFactoryBuilder
这个类可以被实例化,使用和丢弃。一旦你创建了SqlSessionFactory后,这个类就不需 要存在了。因此 SqlSessionFactoryBuilder 实例的最佳范围是方法范围 (也就是本地方法变量)。 你可以重用 SqlSessionFactoryBuilder 来创建多个 SqlSessionFactory 实例, 但是最好的方式是 不需要保持它一直存在来保证所有 XML 解析资源,因为还有更重要的事情要做。
SqlSessionFactory
一旦被创建,SqlSessionFactory 应该在你的应用执行期间都存在。没有理由来处理或重 新创建它。使用 SqlSessionFactory 的最佳实践是在应用运行期间不要重复创建多次。 这样的 操作将被视为是非常糟糕的。因此 SqlSessionFactory的最佳范围是应用范围。 有很多方法可 以做到, 最简单的就是使用单例模式或者静态单例模式。
SqlSession
每个线程都应该有它自己的 SqlSession 实例。SqlSession 的实例不能被共享,也是线程不安全的。因此最佳的范围是请求或方法范围。绝对不能将 SqlSession 实例的引用放在一个 类的静态字段甚至是实例字段中。 也绝不能将 SqlSession 实例的引用放在任何类型的管理范 围中, 比如 Serlvet架构中的 HttpSession。 如果你现在正用任意的 Web 框架, 要考虑 SqlSession 放在一个和 HTTP请求对象相似的范围内。换句话说,基于收到的
HTTP 请求,你可以打开 了一个 SqlSession,然后返回响应,就可以关闭它了。关闭Session很重要,你应该确保使 用 finally 块来关闭它。下面的示例就是一个确保SqlSession关闭的基本模式:
SqlSessionsession = sqlSessionFactory.openSession();
try {
// do work
} finally {
session.close();
}

1.7    Mapper实例

映射器是你创建绑定映射语句的接口。映射器接口的实例可以从SqlSession中获得。那 么从技术上来说,当被请求时,任意映射器实例的最宽范围和 SqlSession 是相同的。然而, 映射器实例的最佳范围是方法范围。也就是说,它们应该在使用它们的方法中被请求,然后 就抛弃掉。它们不需要明确地关闭,那么在请求对象中保留它们也就不是什么问题了,这和 SqlSession 相似。你也许会发现,在这个水平上管理太多的资源的话会失控。保持简单,将 映射器放在方法范围内。下面的示例就展示了这个实践:
SqlSessionsession = sqlSessionFactory.openSession();
try {
BlogMappermapper = session.getMapper(BlogMapper.class);
// do work
} finally {
session.close();
}