《MyBatis 3.5.2参考文档》学习笔记

偶然看到，算是温习吧，生活加油。

 

构建 SqlSessionFactory

每个基于 MyBatis  的应用都是以一个  SqlSessionFactory 的实例为核心的。SqlSessionFactory  的实例可以通过 SqlSessionFactoryBuilder  获得。而 SqlSessionFactoryBuilder    则可以从 XML 配置文件或一个预先定制的 Configuration       的实例构建出  SqlSessionFactory 的实例。

从    XML    文件中构建 

从    XML    文件中构建    SqlSessionFactory    的实例非常简单，建议使用类路径下的资源文件进行配置。    但是也可 以使用任意的输入流（InputStream）实例，包括字符串形式的文件路径或者    file://    的    URL    形式的文件路径 来配置。MyBatis    包含一个名叫    Resources    的工具类，它包含一些实用方法，可使从    classpath    或其他位置 加载资源文件更加容易。

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

XML    配置文件中包含了对    MyBatis    系统的核心设置，包含获取数据库连接实例的数据源（DataSource）和决定事 务作用域和控制方式的事务管理器（TransactionManager）。

不使用    XML    构建    SqlSessionFactory

基于Java类的配置

如果存在一个同名    XML    配 置文件，MyBatis    会自动查找并加载它（在这个例子中，基于类路径和    BlogMapper.class    的类名，会加载 BlogMapper.xml）。

从    SqlSessionFactory    中获取    SqlSession

SqlSession    完全包 含了面向数据库执行    SQL    命令所需的所有方法。你可以通过    SqlSession    实例来直接执行已映射的    SQL    语句。

探究已映射的    SQL    语句

一个语句既可以通过    XML    定义，也可以通过注解定义。

XML方式映射

方法一： 

 

方法二： 

 

 命名空间的作用有两个，一个是利用更长的完全限定名来将不同的语句隔离开来，同时也实现了接口绑 定。

必须使用命名空间，解决不同包同类的问题。

注解方式映射

使用注解来映射简单语句会使代码显得更加简洁，然而对于稍微复杂一点的语句，Java    注解就力不从心了，并且会 显得更加混乱。    因此，如果你需要完成很复杂的事情，那么最好使用    XML    来映射语句

依赖注入框架可以创建线程安全的、基于事务的    SqlSession    和映射器，并将它们直接注入到你的    bean    中，因此 可以直接忽略它们的生命周期。

SqlSessionFactoryBuilder：

这个类可以被实例化、使用和丢弃，一旦创建了    SqlSessionFactory，就不再需要它了。    因此 SqlSessionFactoryBuilder    实例的最佳作用域是方法作用域（也就是局部方法变量）。    你可以重用 SqlSessionFactoryBuilder    来创建多个    SqlSessionFactory    实例，但是最好还是不要让其一直存在，以保 证所有的    XML    解析资源可以被释放给更重要的事情

 

SqlSessionFactory

SqlSessionFactory    一旦被创建就应该在应用的运行期间一直存在，没有任何理由丢弃它或重新创建另一个实例。 使用    SqlSessionFactory    的最佳实践是在应用运行期间不要重复创建多次，多次重建    SqlSessionFactory    被 视为一种代码“坏味道（bad    smell）”。因此    SqlSessionFactory    的最佳作用域是应用作用域。    有很多方法可 以做到，最简单的就是使用单例模式或者静态单例模式。
 

SqlSession

每个线程都应该有它自己的    SqlSession    实例。SqlSession    的实例不是线程安全的，因此是不能被共享的，所以 它的最佳的作用域是请求或方法作用域。    绝对不能将    SqlSession    实例的引用放在一个类的静态域，甚至一个类的 实例变量也不行。    也绝不能将    SqlSession    实例的引用放在任何类型的托管作用域中，比如    Servlet    框架中的 HttpSession。    如果你现在正在使用一种    Web    框架，要考虑    SqlSession    放在一个和    HTTP    请求对象相似的 作用域中。    换句话说，每次收到的    HTTP    请求，就可以打开一个    SqlSession，返回一个响应，就关闭它。    这个 关闭操作是很重要的，你应该把这个关闭操作放到    finally    块中以确保每次都能执行关闭。    下面的示例就是一个 确保    SqlSession    关闭的标准模式：

 映射器实例

映射器是一些由你创建的、绑定你映射的语句的接口。映射器接口的实例是从    SqlSession    中获得的。任何映射器实例的最大作用域是和请求它们的    SqlSession    相同的。尽管如此，映射器实例的最佳作用域 是方法作用域。  

 配置：

设置：

缓存

MyBatis    内置了一个强大的事务性查询缓存机制，它可以非常方便地配置和定制。
默认情况下，只启用了本地的会话缓存，它仅仅对一个会话中的数据进行缓存。    

要启用全局的二级缓存，只需要在你 的    SQL    映射文件中添加一行：
  

 <cache/>

基本上就是这样。这个简单语句的效果如下:

• 映射语句文件中的所有    select    语句的结果将会被缓存。
• 映射语句文件中的所有    insert、update    和    delete    语句会刷新缓存。
• 缓存会使用最近最少使用算法（LRU,    Least    Recently    Used）算法来清除不需要的缓存。
• 缓存不会定时进行刷新（也就是说，没有刷新间隔）。
• 缓存会保存列表或对象（无论查询方法返回哪种）的    1024    个引用。
• 缓存会被视为读/写缓存，这意味着获取到的对象并不是共享的，可以安全地被调用者修改，而不干扰其他调用 者或线程所做的潜在修改。

这个更高级的配置创建了一个    FIFO    缓存，每隔    60    秒刷新，最多可以存储结果对象或列表的    512    个引用，而且 返回的对象被认为是只读的，因此对它们进行修改可能会在不同线程中的调用者产生冲突。
 

使用自定义缓存
 

<cache    type="com.domain.something.MyCustomCache"/>

• type    属性指定的类必须实现    org.mybatis.cache.Cache    接 口，
• 且提供一个接受    String    参数作为    id    的构造器。    
• 这个接口是    MyBatis    框架中许多复杂的接口之一，但是 行为却非常简单。

SqlSession

执行语句方法

总之，每个映射器方法签名应该匹配相关联的    SqlSession    方法，而字符串参数    ID    无需匹配。相反，方法名必须 匹配映射语句的    ID。

你可以传递多个参数给一个映射器方法。如果你这样做了，默认情况下它们将会以    "param"    字符串紧跟着它们在参 数列表中的位置来命名，

比如：#{param1}、#{param2}等。

如果你想改变参数的名称（只在多参数情况下），那么 你可以在参数上使用    @Param("paramName")    注解。

SQL类

日志配置