MyBatis（一）

MyBatis

一.mybatis的介绍

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

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

• mybatis是一个优秀的持久层的框架，它对jdbc的操作数据库过程进行封装，使开发者只需要关注SQL本身，而不需要花费精力去处理如加载启动，创建Connection，创建statement,结果集封装等操作。

1.使用jdbc编程存在的问题

• 比如是我们要是使用jdbc编程，那么需要完成如下步骤

1. 加载数据库驱动

2. 获取数据库连接

3. 创建jdbc statement对象

4. 编写sql语句

5. 设置sql语句中的参数(preparedStatment)

6. 通过statement执行sql获取结果

7. 对sql执行结果进行解析处理

8. 释放资源

1.Jdbc 问题总结

1. 数据库连接创建，释放频繁会造成系统资源浪费从而影响系统性能，如果使用数据库连接池可以解决这个问题

2. Sql语句在代码中硬编码，造成代码不易维护，实际应用sql变化可能较大，sql变动需要修改java代码

3. 使用prepareStatment向占位符号传参数存在硬编码，因为sql语句的where条件不一定，可能多也可能少，修改sql还要修改代码，系统维护困难

4. 对结果集解析存在硬编码，sql变化导致解析代码变化，系统维护困难，如果能将数据库记录封装成javaBean对象解析比较方便。

二. mybatis 架构

1. mybatis配置:

• 两大配置文件 ：核心配置文件 SqlMapConfig.xml 映射配置文件： mapper.xml
  • SqlMapConfig.xml，此文件作为mybatis的全局配置文件，配置了mybatis的运行环境等信息。
  • mapper.xml文件即sql映射文件，文件中配置了操作数据库的sql语句。此文件需要在SqlMapConfig.xml中加载。

2. 通过mybatis环境等配置信息构造SqlSessionFactory即会话工厂
3. 由会话工厂创建sqlSession即会话，操作数据库需要通过sqlSession进行。
4. mybatis底层自定义了Executor执行器接口操作数据库，Executor接口有两个实现，一个是基本执行器、一个是缓存执行器。
5. Mapped Statement也是mybatis一个底层封装对象，它包装了mybatis配置信息及sql映射信息等。mapper.xml文件中一个sql对应一个Mapped Statement对象，sql的id即是Mapped statement的id。
6. Mapped Statement对sql执行输入参数进行定义，包括HashMap、基本类型、pojo，Executor通过Mapped Statement在执行sql前将输入的java对象映射至sql中，输入参数映射就是jdbc编程中对preparedStatement设置参数。
7. Mapped Statement对sql执行输出结果进行定义，包括HashMap、基本类型、pojo，Executor通过Mapped Statement在执行sql后将输出结果映射至java对象中，输出结果映射过程相当于jdbc编程中对结果的解析处理过程。

三.Mybatis入门程序准备工作

1. mybatis下载

• mybatis的代码由github.com管理 ，下载地址: https://github.com/mybatis/mybatis-3/releases

• 现在使用maven导入更方便

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

2.工程的搭建

1.sqlMapConfig.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>          
<!--引入外部文件的标签  -->         
	<properties resource="properties/db.properties"></properties>          
	<settings>   
   		 <!--    可以在控制台输出日志信息：sql语句和参数 -->        
		<setting name="logImpl"   value="STDOUT_LOGGING"/>   
	</settings>          
    <!-- 表示类型别名   库-->        
    <typeAliases>                 
        <!-- 每一个类型的别名  type属性表示别名对应的类型地址 alias表示起的别名-->                   		<typeAlias   type="java.util.List" alias="list"/>              
        <!-- package表示包，利用包的形式进行扫描包之下的所有的类，别名就是当前类名 -->                     <package   name="com.kgc.pojo"/>          
    </typeAliases>         
           
    <!-- 分页插件 -->        
    <!-- <plugins>            
         <plugin interceptor="com.github.pagehelper.PageInterceptor">                           	3.3.0版本可用 - 分页参数合理化，默认false禁用         
           pageNum表示当前页  pages表示尾页         
          true启用合理化时，如果pageNum<1会查询第一页，如果pageNum>pages会查询最后一页                     false禁用合理化时，如果pageNum<1或pageNum>pages会返回空数据            
         <property name="reasonable"   value="true"/>    
       </plugin>        
     </plugins> --> 
    <!-- 环境配置  作为连接数据库的环境 -->      
    <environments   default="development">           
        <environment id="development">          
            <transactionManager type="JDBC"/>         
            <dataSource   type="POOLED">               
                <property   name="driver" value="${jdbc.driver}"/>                       				 <property name="url"   value="${jdbc.url}" />          
                <property   name="username" value="${jdbc.username}"/>                        			 <property   name="password" value="${jdbc.password}"/>                   			 </dataSource>        
        </environment>        
    </environments>       
    <!-- mappers表示代理模式扫描 ，目的主要是在当前配置文件中扫描到sql映射文件-->        
    <mappers>            
        <mapper   resource="mapper/BookMapper.xml"/>         
    </mappers>    
</configuration>   

2.sql映射文件

 <?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属性表示当前代理的命名空间，
    属性值一般情况下等于dao的接口类地址  相当于dao接口实现类   -->  
<mapper namespace="com.kgc.mapper.BookMapper">
    <!--这里会有增删改查的标签-->
</mapper>   

3. mybatis解决jdbc编程的问题

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定义输出结果的类型。

4. mybatis和hibernate的区别

• Mybatis和hibernate不同，它不完全是一个ORM框架，因为MyBatis需要程序员自己编写Sql语句，不过mybatis可以通过XML或注解方式灵活配置要运行的sql语句，并将java对象和sql语句映射生成最终执行的sql，最后将sql执行的结果再映射生成java对象。

• Mybatis学习门槛低，简单易学，程序员直接编写原生态sql，可严格控制sql执行性能，灵活度高，非常适合对关系数据模型要求不高的软件开发，例如互联网软件、企业运营类软件等，因为这类软件需求变化频繁，一但需求变化要求成果输出迅速。但是灵活的前提是mybatis无法做到数据库无关性，如果需要实现支持多种数据库的软件则需要自定义多套sql映射文件，工作量大。

• Hibernate对象/关系映射能力强，数据库无关性好，对于关系模型要求高的软件（例如需求固定的定制化软件）如果用hibernate开发可以节省很多代码，提高效率。但是Hibernate的学习门槛高，要精通门槛更高，而且怎么设计O/R映射，在性能和对象模型之间如何权衡，以及怎样用好Hibernate需要具有很强的经验和能力才行。

• 总之，按照用户的需求在有限的资源环境下只要能做出维护性、扩展性良好的软件架构都是好架构，所以框架只有适合才是最好。

四. mybatis的Dao开发

• 使用Mapper代理接口开发方式(主流)

• 面向接口 没有实现类（看不到接口的实现类）

1. SqlSession的使用范围

• SqlSession中封装了对数据库的操作，如：查询、插入、更新、删除等。

• 通过SqlSessionFactory创建SqlSession，而SqlSessionFactory是通过SqlSessionFactoryBuilder进行创建。

2. SqlSessionFactoryBuilder

• SqlSessionFactoryBuilder用于创建SqlSessionFacoty，SqlSessionFacoty一旦创建完成就不需要-SqlSessionFactoryBuilder了，因为SqlSession是通过SqlSessionFactory生产，所以可以将SqlSessionFactoryBuilder当成一个工具类使用，最佳使用范围是方法范围即方法体内局部变量。

3.SqlSessionFactory

• SqlSessionFactory是一个接口，接口中定义了openSession的不同重载方法，SqlSessionFactory的最佳使用范围是整个应用运行期间，一旦创建后可以重复使用，通常以单例模式管理SqlSessionFactory。

4. SqlSessoin

• SqlSession是一个面向用户的接口， sqlSession中定义了数据库操作方法。

• 每个线程都应该有它自己的SqlSession实例。SqlSession的实例不能共享使用，它也是线程不安全的。因此最佳的范围是请求或方法范围。绝对不能将SqlSession实例的引用放在一个类的静态字段或实例字段中。

• 打开一个 SqlSession；使用完毕就要关闭它。通常把这个关闭操作放到 finally 块中以确保每次都能执行关闭。如下：

SqlSession session = sqlSessionFactory.openSession();
        try {
           // do work
         } finally {
              session.close();
        }

5.开发规范

• Mapper接口开发方式需要程序员编写Mapper接口(相当于Dao接口)，由mybatis框架根据接口定义创建接口的动态代理对象，就是接口的实现类

• Mapper 接口开发需要遵循以下规范

  1. Mapper.xml文件中的namespace与mapper接口的路径相同
  2. Mapper接口方法名和Mapper.xml中定义的每个statement的id相同
  3. Mapper 接口方法的输入参数类型和mapper.xml中定义的每个sql的parameterType的类型相同.
  4. Mapper接口方法的输出参数类型和mapper.xml中定义的每个sql的resultType的类型相同。

• 开始写代码 查所有 新增 修改 删除

五.SqlMapConfig.xml配置文件

• SqlMapConfig.xml中配置的内容顺序如下：

1.配置内容

• properties（属性）

• settings（全局配置参数）

• typeAliases（类型别名）

• typeHandlers（类型处理器）

• objectFactory（对象工厂）

• plugins（插件）

• environments（环境集合属性对象）

• environment（环境子属性对象）

• transactionManager（事务管理）

• dataSource（数据源）

• mappers（映射器）

2. properties(属性)

• 注意： Mybatis按照下面的顺序来加载属性：
  • 在properties 元素体内定义的属性首先被读取。
  • 然后会读取propertis元素中resource或者url加载的属性，它会覆盖已读取的同名属性。

3. typeAliases(类型别名)

别名	映射的类型
_byte	byte
_long	long
_short	short
_int	int
_integer	int
_double	double
_float	float
_boolean	boolean
string	String
byte	Byte
long	Long
short	Short
int	Integer
integer	Integer
double	Double
float	Float
boolean	Boolean
date	Date
decimal	BigDecimal
bigdecimal	BigDecimal
map	Map

4. 自定义别名

   <!-- 配置别名 -->
   <typeAliases>
   	<!-- 配置别名 -->
   	<!-- <typeAlias type="com.whhp.mybatis.pojo.User" alias="user" /> -->
   	<!-- 基于包扫描的方式配置别名 -->
   	<package name="com.whhp.mybatis.pojo" />
   </typeAliases>

5.mappers(映射器)

• 使用相对类路径的资源

<!-- resource 基于calsspath查找 -->
		<mapper resource="sqlMap/User.xml" />

• 注册指定包下面的所有mapper接口

<!-- 使用扫描包的形式加载mapper文件 -->
		<package name="com.whhp.mybatis.mapper"/>
//注意：此种方法要求mapper接口名称和mapper映射文件名称相同，且放在同一个目录中。