mybatis第一篇

1.mybatis介绍

1.介绍

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

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

MyBatis 是一款优秀的持久层框架，它支持定制化 SQL、存储过程以及高级映射。MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集。MyBatis 可以使用简单的 XML 或注解来配置和映射原生信息，将接口和 Java 的 POJOs(Plain Ordinary Java Object,普通的 Java对象)映射成数据库中的记录

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

每个MyBatis应用程序主要都是使用SqlSessionFactory实例的，一个SqlSessionFactory实例可以通过SqlSessionFactoryBuilder获得。SqlSessionFactoryBuilder可以从一个xml配置文件或者一个预定义的配置类的实例获得。

用xml文件构建SqlSessionFactory实例是非常简单的事情。推荐在这个配置中使用类路径资源（classpath resource)，但你可以使用任何Reader实例，包括用文件路径或file://开头的url创建的实例。MyBatis有一个实用类----Resources，它有很多方法，可以方便地从类路径及其它位置加载资源。

2.特点

简单易学：本身就很小且简单。没有任何第三方依赖，最简单安装只要两个jar文件+配置几个sql映射文件易于学习，易于使用，通过文档和源代码，可以比较完全的掌握它的设计思路和实现。
灵活：mybatis不会对应用程序或者数据库的现有设计强加任何影响。 sql写在xml里，便于统一管理和优化。通过sql语句可以满足操作数据库的所有需求。
解除sql与程序代码的耦合：通过提供DAO层，将业务逻辑和数据访问逻辑分离，使系统的设计更清晰，更易维护，更易单元测试。sql和代码的分离，提高了可维护性。
提供映射标签，支持对象与数据库的orm字段关系映射
提供对象关系映射标签，支持对象关系组建维护
提供xml标签，支持编写动态sql。

3.执行流程

框架架构讲解：

(1)加载配置：配置来源于两个地方，一处是配置文件，一处是Java代码的注解，将SQL的配置信息加载成为一个

mybatis结构

个MappedStatement对象（包括了传入参数映射配置、执行的SQL语句、结果映射配置），存储在内存中。

(2)SQL解析：当API接口层接收到调用请求时，会接收到传入SQL的ID和传入对象（可以是Map、JavaBean或者基本数据类型），Mybatis会根据SQL的ID找到对应的MappedStatement，然后根据传入参数对象对MappedStatement进行解析，解析后可以得到最终要执行的SQL语句和参数。

(3)SQL执行：将最终得到的SQL和参数拿到数据库进行执行，得到操作数据库的结果。

(4)结果映射：将操作数据库的结果按照映射的配置进行转换，可以转换成HashMap、JavaBean或者基本数据类型，并将最终结果返回。

4.功能架构

MyBatis架构

我们把Mybatis的功能架构分为三层：

(1)API接口层：提供给外部使用的接口API，开发人员通过这些本地API来操纵数据库。接口层一接收到调用请求就会调用数据处理层来完成具体的数据处理。

(2)数据处理层：负责具体的SQL查找、SQL解析、SQL执行和执行结果映射处理等。它主要的目的是根据调用的请求完成一次数据库操作。

(3)基础支撑层：负责最基础的功能支撑，包括连接管理、事务管理、配置加载和缓存处理，这些都是共用的东西，将他们抽取出来作为最基础的组件。为上层的数据处理层提供最基础的支撑

2.项目搭建

1.开发环境上配置DTD文件

建工工程之前，先准备mybatis的dtd文件，方便后期配置xml时帮助我们提示标签名，

解压mybatis-3.5.3.jar文件，

进入目录\mybatis-3.5.3\org\apache\ibatis\builder\xml下copy两个文件

mybatis-3-config.dtd 它主要用来做主配置的，配置数据源，缓存，加载mapper映射文件的提示
mybatis-3-mapper.dtd

添加dtd文件

ecplise工具：点击window-->preference--->xml目录，点击XML Catalog--->点击add进入

注意，导入dtd文件，workbspacse是从项目工程上导入，fileSytem是从本地电脑系统上导入，我们这里需要从导入file system，

创建xml文件

添加mybatisd的td约束头

记不住我们可以去dtd文件中找，复制到自己的xml开头

效果就出来！，另外mapper的也是一样，这里就不写了，自己操作

2.搭建web工程

添加jar包： mybatis-3.5.3.jar ,ojdbc6.jar或者mysql-connector.jar

或采用maven的方式集成mybatis

<!-- https://mvnrepository.com/artifact/org.mybatis/mybatis -->

<dependency>

    <groupId>org.mybatis</groupId>

    <artifactId>mybatis</artifactId>

    <version>3.5.3</version>

</dependency>

把下载的mybatis-3.5.3.jar,数据库驱动包复制到WEB-INF\lib下

就行了

3.使用mybatis

1.先创建实体类和包如：com.entity.MoveBooking

2.在src下新建一个mybatis-config.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">

			<!--type="MANAGED"不支持数据库自动提交和回滚			<property name="closeConnection" value="false"/> -->

			</transactionManager>

			<!-- type="[UNPOOLED|POOLED|JNDI]" -->

			<dataSource type="POOLED">

			  <property name="driver" value="oracle.jdbc.driver.OracleDriver"/>

			  <property name="url" value="jdbc:oracle:thin:@localhost:1521:orcl"/>

			  <property name="username" value="movebook"/>

			  <property name="password" value="123456"/>

			</dataSource>

		</environment>

	</environments>

	<!-- Using classpath relative resources -->

	<mappers>

	 <mapper resource="com/entity/mapper.xml" />

	 <mapper resource="com/dao/mapper.xml" />

	</mappers>

</configuration>

在sql语句中多添加了****；就会出现异常

Cause: java.sql.SQLSyntaxErrorException: ORA-00904: "CARTYPED": 标识符无效列名写错了

3.创建实体类的映射文件mapper.xml文件

与前面mappers下的mapper名一致，并且与类在同一包下

<?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">

<!-- 实体类映射01 -->

<mapper namespace="com.entity.MoveBooking">

    <!-- id 唯一标识 -->

	<select id="findAll" resultType="com.entity.MoveBooking">

		select id, area, cartype, movedate,contact, phone, status from move_booking

	</select>

</mapper>

4.编写测试类TEST.java

import java.io.InputStream;

import java.sql.Connection;

import java.sql.PreparedStatement;

import java.sql.ResultSet;

import java.sql.ResultSetMetaData;

import java.sql.SQLException;

import java.util.List;

import org.apache.ibatis.session.SqlSession;

import org.apache.ibatis.session.SqlSessionFactory;

import org.apache.ibatis.session.SqlSessionFactoryBuilder;

import com.dao.MoveBookingDao;

public class Test {

	public static void main(String[] args) {

		//指定mybatis.xml文件的名字

		String name="/mybatis.xml";

		//加载mybatis配置文件，用于读取mybatis.xml

		InputStream ins=Test.class.getResourceAsStream(name);

		//创建构造模式，拿到构造器

		SqlSessionFactoryBuilder build=new SqlSessionFactoryBuilder();

		//读取，并解析MYBATIS的配置，创建Configration对象，配置数据源，事务管理，映射文件，

		//获得sql工厂

		SqlSessionFactory factory=build.build(ins);

		//通过工厂与数据库建立连接，获取连接对象session

		SqlSession session = factory.openSession();

		//调用增删改查,注意一定写上mapper的如namespacse.id,com.entity.MoveBooking.findAll

		List<MoveBooking> list = session.selectList("com.entity.MoveBooking.findAll");

		list.forEach(System.out::println);

		System.out.println("-----------------");

		//事物提交

		session.commit();

		//关闭连接

		session.close();

	}

}

5.另外一种方式

建一个dao接口，定义相应的增删改成
在同包下新建一个mapper映射文件，namespacse与dao接口名一致
在mybatis配置文件mappers中添加一个mapper子元素标签，配置，
编写测试类

package com.entity;

import java.io.InputStream;

import java.sql.Connection;

import java.sql.PreparedStatement;

import java.sql.ResultSet;

import java.sql.ResultSetMetaData;

import java.sql.SQLException;

import java.util.List;

import org.apache.ibatis.session.SqlSession;

import org.apache.ibatis.session.SqlSessionFactory;

import org.apache.ibatis.session.SqlSessionFactoryBuilder;

import com.dao.MoveBookingDao;

public class Test {

	public static void main(String[] args) {

		//指定mybatis.xml文件的名字

		String name="/mybatis.xml";

		//加载mybatis配置文件，用于读取mybatis.xml

		InputStream ins=Test.class.getResourceAsStream(name);

		//创建构造模式，拿到构造器

		SqlSessionFactoryBuilder build=new SqlSessionFactoryBuilder();

		//读取，并解析MYBATIS的配置，创建Configration对象，配置数据源，事务管理，映射文件，

		//获得sql工厂

		SqlSessionFactory factory=build.build(ins);

		//通过工厂与数据库建立连接，获取连接对象session

		SqlSession session = factory.openSession();

		//调用增删改查

		//获得mapper映射处理类dao，调用相应的方法，即可

		MoveBookingDao dao = session.getMapper(MoveBookingDao.class);

		dao.findAll().forEach(System.out::println);

		System.out.println(dao.findById(4442));

		//事物提交

		session.commit();

		//关闭连接

		session.close();

	}

}

3.静态SQL语句

1.select 语句

 <select

  id="selectPerson"

  parameterType="int"

  parameterMap="deprecated"

  resultType="hashmap"

  resultMap="personResultMap"

  flushCache="false"

  useCache="true"

  timeout="10000"

  fetchSize="256"

  statementType="PREPARED"

  resultSetType="FORWARD_ONLY">

属性	描述
id	在命名空间中唯一的标识符，可以被用来引用这条语句。
parameterType	将会传入这条语句的参数类的完全限定名或别名。这个属性是可选的，因为 MyBatis 可以通过 TypeHandler 推断出具体传入语句的参数，默认值为 unset。
resultType	从这条语句中返回的期望类型的类的完全限定名或别名。注意如果是集合情形，那应该是集合可以包含的类型，而不能是集合本身。使用 resultType 或 resultMap，但不能同时使用。
resultMap	外部 resultMap 的命名引用。结果集的映射是 MyBatis 最强大的特性，对其有一个很好的理解的话，许多复杂映射的情形都能迎刃而解。使用 resultMap 或 resultType，但不能同时使用。
flushCache	将其设置为 true，任何时候只要语句被调用，都会导致本地缓存和二级缓存都会被清空，默认值：false。
useCache	将其设置为 true，将会导致本条语句的结果被二级缓存，默认值：对 select 元素为 true。
timeout	这个设置是在抛出异常之前，驱动程序等待数据库返回请求结果的秒数。默认值为 unset（依赖驱动）。
fetchSize	这是尝试影响驱动程序每次批量返回的结果行数和这个设置值相等。默认值为 unset（依赖驱动）。
statementType	STATEMENT，PREPARED 或 CALLABLE 的一个。这会让 MyBatis 分别使用 Statement，PreparedStatement 或 CallableStatement，默认值：PREPARED。
resultSetType	FORWARD_ONLY，SCROLL_SENSITIVE 或 SCROLL_INSENSITIVE 中的一个，默认值为 unset （依赖驱动）。
databaseId	如果配置了 databaseIdProvider，MyBatis 会加载所有的不带 databaseId 或匹配当前 databaseId 的语句；如果带或者不带的语句都有，则不带的会被忽略。
resultOrdered	这个设置仅针对嵌套结果 select 语句适用：如果为 true，就是假设包含了嵌套结果集或是分组了，这样的话当返回一个主结果行的时候，就不会发生有对前面结果集的引用的情况。这就使得在获取嵌套的结果集的时候不至于导致内存不够用。默认值：false。
resultSets	这个设置仅对多结果集的情况适用，它将列出语句执行后返回的结果集并每个结果集给一个名称，名称是逗号分隔的。

2.insert,update,delete 语句

<insert

  id="insertAuthor"

  parameterType="domain.blog.Author"

  flushCache="true"

  statementType="PREPARED"

  keyProperty=""

  keyColumn=""

  useGeneratedKeys=""

  timeout="20">

<update

  id="updateAuthor"

  parameterType="domain.blog.Author"

  flushCache="true"

  statementType="PREPARED"

  timeout="20">

<delete

  id="deleteAuthor"

  parameterType="domain.blog.Author"

  flushCache="true"

  statementType="PREPARED"

  timeout="20">

Insert, Update 和 Delete 的属性

属性	描述
id	命名空间中的唯一标识符，可被用来代表这条语句。
parameterType	将要传入语句的参数的完全限定类名或别名。这个属性是可选的，因为 MyBatis 可以通过 TypeHandler 推断出具体传入语句的参数，默认值为 unset。
flushCache	将其设置为 true，任何时候只要语句被调用，都会导致本地缓存和二级缓存都会被清空，默认值：true（对应插入、更新和删除语句）。
timeout	这个设置是在抛出异常之前，驱动程序等待数据库返回请求结果的秒数。默认值为 unset（依赖驱动）。
statementType	STATEMENT，PREPARED 或 CALLABLE 的一个。这会让 MyBatis 分别使用 Statement，PreparedStatement 或 CallableStatement，默认值：PREPARED。
useGeneratedKeys	（仅对 insert 和 update 有用）这会令 MyBatis 使用 JDBC 的 getGeneratedKeys 方法来取出由数据库内部生成的主键（比如：像 MySQL 和 SQL Server 这样的关系数据库管理系统的自动递增字段），默认值：false。
keyProperty	（仅对 insert 和 update 有用）唯一标记一个属性，MyBatis 会通过 getGeneratedKeys 的返回值或者通过 insert 语句的 selectKey 子元素设置它的键值，默认：unset。如果希望得到多个生成的列，也可以是逗号分隔的属性名称列表。
keyColumn	（仅对 insert 和 update 有用）通过生成的键值设置表中的列名，这个设置仅在某些数据库（像 postgresql）是必须的，当主键列不是表中的第一列的时候需要设置。如果希望得到多个生成的列，也可以是逗号分隔的属性名称列表。
databaseId	如果配置了 databaseIdProvider，MyBatis 会加载所有的不带 databaseId 或匹配当前 databaseId 的语句；如果带或者不带的语句都有，则不带的会被忽略。

列如：

<insert id="insertAuthor" useGeneratedKeys="true"

    keyProperty="id">

  insert into Author (username,password,email,bio)

  values (#{username},#{password},#{email},#{bio})

</insert>

4.返回类型

返回全表字段的，并且字段名与实体名一致时，可采用实体类作为返回类型
返回全表字段的，并且字段名与实体名不一致时，有三种结局方式

a. 返回map类型，

b. 在sql语句中给列名一个别名与实体类对应，就可以把实体类作为返回类型

c. 自己定义一个ResultMap，指定id，在sql语句中引用id

3.直接使用map作为返回类型

5.动态sql

MyBatis 的强大特性之一便是它的动态 SQL。如果你有使用 JDBC 或其他类似框架的经验，你就能体会到根据不同条件拼接 SQL 语句有多么痛苦。拼接的时候要确保不能忘了必要的空格，还要注意省掉列名列表最后的逗号。利用动态 SQL 这一特性可以彻底摆脱这种痛苦。

动态标签的使用
- if
- choose (when, otherwise)
- trim (where, set)
- foreach

<!--判断->

<if test="title != null">AND title like #{title}</if>

<!--选择-->

<choose>

    <when test="title != null">

      AND title like #{title}

    </when>

    <when test="author != null and author.name != null">

      AND author_name like #{author.name}

    </when>

    <otherwise>

      AND featured = 1

    </otherwise>

 </choose>

<!--where的使用->

SELECT * FROM BLOG

  <where>

    <if test="state != null">

         state = #{state}

    </if>

    <if test="title != null">

        AND title like #{title}

    </if>

    <if test="author != null and author.name != null">

        AND author_name like #{author.name}

    </if>

  </where>

<trim prefix="WHERE" prefixOverrides="AND |OR ">

</trim>

<!--更新->

update Author

    <set>

      <if test="username != null">username=#{username},</if>

      <if test="password != null">password=#{password},</if>

      <if test="email != null">email=#{email},</if>

      <if test="bio != null">bio=#{bio}</if>

    </set>

<!--集合遍历-->

WHERE ID in

  <foreach item="item" index="index" collection="list"

      open="(" separator="," close=")">

        #{item}

  </foreach>

6.日志处理

1.在src下新建一个 log4j.properties 文件

 # Global logging configuration

    log4j.rootLogger=ERROR, stdout

    # MyBatis logging configuration...

    log4j.logger.org.mybatis.example.BlogMapper=TRACE

    # Console output...

    log4j.appender.stdout=org.apache.log4j.ConsoleAppender

    log4j.appender.stdout.layout=org.apache.log4j.PatternLayout

    log4j.appender.stdout.layout.ConversionPattern=%5p [%t] - %m%n

添加以上配置后，Log4J就会把 org.mybatis.example.BlogMapper 的详细执行日志记录下来，对于应用中的其它类则仅仅记录错误信息。

也可以将日志从整个mapper接口级别调整到到语句级别，从而实现更细粒度的控制。如下配置只记录 selectBlog 语句的日志：

log4j.logger.org.mybatis.example.BlogMapper.selectBlog=TRACE

与此相对，可以对一组mapper接口记录日志，只要对mapper接口所在的包开启日志功能即可：

    log4j.logger.org.mybatis.example=TRACE

某些查询可能会返回大量的数据，只想记录其执行的sql语句该怎么办？为此，Mybatis中SQL语句的日志级别被设为DEBUG（JDK Logging中为FINE），结果日志的级别为TRACE（JDK Logging中为FINER)。所以，只要将日志级别调整为DEBUG即可达到目的：

    log4j.logger.org.mybatis.example=DEBUG

2.在mybatis配置文件中添加设置日志的配置

<settings>

	<setting name="logImpl" value="LOG4J"/>

</settings>