mybatis基础总结01

背景介绍：
1.ORM 对象关系映射模式
面向对象编程和关系型数据库，都是目前最流行的技术，但是它们的模型是不一样的。
面向对象编程把所有实体看成对象（object），关系型数据库则是采用实体之间的关系（relation）连接数据。很早就有人提出，关系也可以用对象表达，这样的话，就能使用面向对象编程，来操作关系型数据库
简单说，ORM 就是通过实例对象的语法，完成关系型数据库的操作的技术，是"对象-关系映射"（Object/Relational Mapping） 的缩写。
查看图片：ORM示例图.jpg
ORM把数据库映射成对象。
2.三层架构：
表示层(web) 业务逻辑层(service) 持久化层(dao)
springMVC spring mybatis

一 、mybatis入门
1.1 mybatis是什么
MyBatis是一个简化和实现了 Java 数据持久化层(persistence layer)的开源框架，它抽象了大量的JDBC冗余代码，并提供了一个简单易用的API和数据库交互方式。
MyBatis的前身是iBATIS，iBATIS于2002年由ClintonBegin创建。MyBatis3是iBATIS的全新设计，支持注解和Mapper(映射器)。
MyBatis流行的主要原因在于它的简单性和易使用性。在Java应用程序中，数据持久化层涉及到的工作有：将从数据库查询到的数据生成所需要的Java对象；将Java对象中的数据通SQL持久化到数据库中。
MyBatis通过抽象底层的JDBC代码，自动化SQL结果集产生Java对象、Java对象的数据持久化数据库中的过程使得对SQL的使用变得容易。

1.2 Git 是一个免费开源的分布式版本控制系统，被用于高速有效地处理大大小小项目中所有文件,在软件开发中使用的其他版本控制软件类似与SVN、VSS、CVS等等.

1.3 作为一个分布式的版本控制系统，在Git中并不存在主库这样的概念，每一份复制出的库都可以独立使用，任何两个库之间的不一致之处都可以进行合并。github以托管各种git库，并提供一个web界面，可以说是一款易于使用的git图形客户端。我们熟知的spring、struts、Hibernate等框架的源代码在github上面都可以找到其源代码

1.4 iBATIS一词来源于internet和abatis的组合，是一个在2002年发起的开放源代码项目。于2010年6月16号被谷歌托管，改名为MyBatis。
ibatis的官网 http://ibatis.apache.org/ 进去官网会看到下面提示:

apache ibatis is retired at the apache software foundation
(2010/06/16) the original project team has moved to mybatis hosted
at google code. see http://www.mybatis.org/ for more.

然而http://www.mybatis.org/这个地址一直处于打不开状态…
但是我们最终是可以在github中找到mybatis的相关下载的:
mybatis在github中的地址

https://github.com/mybatis/mybatis-3

最新版本的mybatis的下载地址

https://github.com/mybatis/mybatis-3/releases

doc文档

http://www.mybatis.org/mybatis-3/

1.5 当前有很多Java实现的持久化框架，而MyBatis流行起来有以下原因：

1.5.1 它消除了大量的JDBC冗余代码
			Java通过JDBC的API来操作关系型数据库，但是JDBC是一个非常底层的API,我们需要书写大量的代码来完成对数据库的操作。例如一个插入操作(参考之前学习JDBC时候的代码实例)
			但是使用mybatis来完成相同的插入操作要简单方便灵活的多:
			第一步:在SQLMapper映射配置文件中配置SQL语句，假定为StudentMapper.xml

			<insert id="insertStudent" parameterType="Student">
				INSERT INTO STUDENTS(ID,NAME,EMAIL)
				VALUES(#{id},#{name},#{email})
			</insert>

			第二步:创建一个StudentMapper接口：

			public interface StudentMapper{
				void insertStudent(Student student);
			}

			第三步:编写java代码完成插入操作:
            //SqlSession是重要的接口。接口的实现类对象可以动态获取映射接口的对象
			SqlSession session = getSqlSessionFactory().openSession();
			//扩展：代理模式/反射技术是框架的基础。
            //接口类型StudentMapper的引用mapper指向实现类的对象
			StudentMapper mapper = session.getMapper(StudentMapper.class);
            //实现类对象调用方法
			mapper.insertStudent(student);


			特别之处的是，MyBatis还提供了其他的一些特性来简化持久化逻辑的实现
			它支持复杂的SQL结果集数据映射到嵌套的对象结构
			它支持一对一和一对多的结果集和Java对象的映射
			它支持根据输入的数据构建动态的SQL语句
			
1.5.2 它有低的学习曲线
			MyBatis能够流行的首要原因之一在于它学习和使用起来非常简单，它取决于你Java和 SQL方面的知识。如果开发人员很熟悉Java和SQL，他们会发现MyBatis入门非常简单。
			
1.5.3 它能很好地与传统数据库协同工作
			有时我们可能需要用不正规形式与传统数据库协同工作，使用成熟的ORM框架(例如大家熟知的Hibernate)有可能、但是很难跟传统数据库很好地协同工作，因为他们尝试将Java对象静态地映射到数据库的表上.而MyBatis是将查询的结果与Java对象映射起来，这使得MyBatis可以很好地与传统数据库协同工作。
			你可以根据面向对象的模型创建Java域对象，执行传统数据库的查询，然后将结果映射到对应的Java对象上。
			
1.5.4 它可以接受SQL语句
			成熟的ORM框架鼓励使用实体对象和在其底层自动产生SQL语句。由于这种的SQL生成方式，我们有可能不能够利用到数据库的一些特有的特性。Hibernate允许执行本地SQL，但是这样会打破持久层和数据库独立的原则。MyBatis框架接受SQL语句，而不是将其对开发人员隐藏起来。
			由于MyBatis不会产生任何的SQL语句，所以开发人员就要准备SQL语句，这样就可以充分利用数据库特有的特性并且可以准备自定义的查询。另外，MyBatis 对存储过程也提供了支持。
			
1.5.5 它提供了与Spring框架的集成支持
			MyBatis提供了与流行的依赖注入框架Spring的开包即用的集成支持，这将进一步简化MyBatis的使用
1.5.6 它提供了与第三方缓存类库的集成支持
			MyBatis有内建的SqlSession级别的缓存机制，用于缓存Select语句查询出来的结果。除此之外，MyBatis提供了与多种第三方缓存类库的集成支持，如EHCache，OSCache，Hazelcast等。
			
1.5.7 它引入了更好的性能
			性能问题是关乎软件应用成功与否的关键因素之一。为了达到更好的性能，需要考虑很多事情，而对很多应用而言，数据持久化层是整个系统性能的关键。MyBatis支持数据库连接池，消除了为每一个请求创建一个数据库连接的开销,MyBatis提供了内建的缓存机制，在SqlSession级别提供了对SQL查询结果的缓存。
			即:如果你调用了相同的select查询，MyBatis 会将放在缓存的结果返回，而不会去再查询数据库。MyBatis框架并没有大量地使用代理机制，因此对于其他的过度地使用代理的ORM框架而言，MyBatis可以获得更好的性能.

1.6 mybatis的jar包
mybatis的核心包只有一个mybatis-3.x.0.jar,另外还有一些【可选】的依赖包(日志、代理等所需要的),在下载的压缩包中可以找到.

1.7 mybatis框架中一般需要俩种文件:

第一种:mybatis的配置文件: mybatis-config.xml,其中包括数据库连接信息，类型别名,映射文件路径等等
特点:
名字一般是固定的
位置是src下面
示例:

<?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>
			  <typeAliases>
				<typeAlias alias="Student" type="com.briup.pojo.Student" />
			  </typeAliases>
			  <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/test" />
					-->
					<property name="driver" value="oracle.jdbc.driver.OracleDriver" />
					<property name="url" value="jdbc:oracle:thin:@127.0.0.1:1521:XE" />
					<property name="username" value="test" />
					<property name="password" value="test" />
				  </dataSource>
				</environment>
			  </environments>
			  <mappers>
				<mapper resource="com/briup/pojo/StudentMapper.xml" />
			  </mappers>
			</configuration>

第二种:mybatis的映射文件:XxxxMapper.xml,这个xml文件中包括Xxxx类所对应的数据库表的各种增删改查sql语句
例如:StudentMapper.xml文件中是Student类对应的表的各种select insert update delete
特点:
名字一般为XxxxMapper.xml,Xxxx是对应类的名字
位置不固定,一般放到一个专门的package里面
实例:

<?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="com.briup.pojo.StudentMapper">
			  <resultMap type="Student" id="StudentResult">
				<id property="StudId" column="stud_id" />
				<result property="name" column="name" />
				<result property="email" column="email" />
			  </resultMap>
			  <select id="findAllStudents" resultMap="StudentResult">
					SELECT * FROM STUDENTS
			  </select>
			  <select id="findStudentById" parameterType="int" resultType="Student">
				 SELECT ID AS STUDID, NAME, EMAIL
					 FROM STUDENTS WHERE ID=#{Id}
			  </select>
			  <insert id="insertStudent" parameterType="Student">
				 INSERT INTO STUDENTS(ID,NAME,EMAIL)
					 VALUES(#{id },#{name},#{email})
			  </insert>
			</mapper>

1.8 mybatis中的映射接口XxxxMapper.java(对XxxxMapper.xml中的sql语句进行映射)
mybatis中除了必须的jar包、各种xml配置文件之外,一般还需要有调用sql语句执行的接口XxxxMapper.java
示例:

public interface StudentMapper{
		List<Student> findAllStudents();
		Student findStudentById(Integer id);
		void insertStudent(Student student);
	}

注意:接口中的方法的名字和XML文件定义的SQL映射语句的名称要相同
同时我们不需要去实现该接口,因为mybatis中提供了相应的方式在运行期间动态生成该接口的实现类对象(动态代理技术,spring框架中会详细讲解动态代理).

1.9 mybatis中的SqlSession接口和sqlSessionFactory接口
SqlSession接口的实现类对象是mybatis中最重要的一个对象,我们可以使用该对象动态获得XxxxMapper.java接口的实现类对象,然后就可以调用到XxxxMapper.java接口中方法所映射的sql语句(在xml文件中配置的sql语句)。
sqlSessionFactory接口的实现类对象是一个工厂对象,专门负责来产生SqlSession对象的
例如:

	InputStream inputStream = Resources.getResourceAsStream("mybatis-config.xml");
	SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

	SqlSession session = sqlSessionFactory.openSession();

	//第一种执行sql语句的方式  通过XxxxMapper接口的实现类对象来调用
	//动态获得XxxxMapper接口的实现类
	StudentMapper mapper = session.getMapper(StudentMapper.class);

	mapper.insertStudent(new Student(1,"tom","123@.qq.com"));

	//第二种执行sql语句的方式  执行调用XxxxMapper.xml中写好的sql语句
	//也可以【不通过】Mapper接口执行映射的SQL
	//然而，使用 Mapper接口是最佳实践
	//session.selectOne("com.briup.pojo.StudentMapper.findStudentById",1);

1.10 编写一个简单的mybatis进行插入数据的实例

1.10.1 数据库建表 dob = Date of Birth

drop table students;
			create table students (
				stud_id number PRIMARY KEY,
				name varchar2(50) ,
				email varchar2(50) ,
				dob date
			);

1.10.2 新建一个项目,创建好相应的package及class

package com.briup.pojo;
			import java.util.Date;
			public class Student {
				private Integer studId;
				private String name;
				private String email;
				private Date dob;
				get/set
			}

1.10.3 项目中引入mybatis的核心包以及可选的依赖包
必须的包 mybatis-3.3.0.jar ojdbc14.jar
可选的包 junit-4.7.jar log4j-1.2.17.jar

1.10.4 mybatis中的配置文件和映射文件分别引入到项目中
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>
				<typeAliases>
					<typeAlias type="com.briup.pojo.Student" alias="Student" />
				</typeAliases>

				<environments default="development">
					<environment id="development">
						<transactionManager type="JDBC"></transactionManager>
						<dataSource type="POOLED">
							<property name="driver" value="oracle.jdbc.driver.OracleDriver" />
							<property name="url" value="jdbc:oracle:thin:@127.0.0.1:1521:XE" />
							<property name="username" value="test" />
							<property name="password" value="test" />
						</dataSource>
					</environment>
				</environments>

				<mappers>
					<mapper resource="com/briup/mappers/StudentMapper.xml"/>
				</mappers>

			</configuration>

com.briup.mappers包下面的StudentMapper.xml:

<?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">
			<!-- com.briup.mappers.StudentMapper是我们定义接口的全限定名字 这样就可以使用接口调用映射的SQL语句了 这个名字一定要和接口对应上-->
			<mapper namespace="com.briup.mappers.StudentMapper">

				<resultMap type="Student" id="StudentResult">
					<id property="studId" column="stud_id" />
					<result property="name" column="name" />
					<result property="email" column="email" />
					<result property="dob" column="dob" />
				</resultMap>

				<select id="findAllStudents" resultMap="StudentResult">
					SELECT * FROM STUDENTS
				</select>

				<!-- 列名和属性名字不一致可以给查询的列起一个别名 -->
				<select id="findStudentById" parameterType="int" resultType="Student">
					SELECT STUD_ID AS STUDID,NAME,EMAIL,DOB
					FROM STUDENTS
					WHERE
					STUD_ID=#{id}
				</select>
				<insert id="insertStudent" parameterType="Student">
					INSERT INTO
					STUDENTS(STUD_ID,NAME,EMAIL,DOB)
					VALUES(#{studId},#{name},#{email},#{dob})
				</insert>
			</mapper>

1.10.5 配置log4j.properties文件中的日志输出:
位置src下面
内容:

log4j.rootLogger=DEBUG, stdout
			log4j.appender.stdout=org.apache.log4j.ConsoleAppender
			log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
			log4j.appender.stdout.layout.ConversionPattern=%d [%-5p] %c - %m%n
			#show sql
			log4j.logger.java.sql.ResultSet=INFO
			log4j.logger.org.apache=INFO
			log4j.logger.java.sql.Connection=DEBUG
			log4j.logger.java.sql.Statement=DEBUG
			log4j.logger.java.sql.PreparedStatement=DEBUG

1.10.6 com.briup.mappers包下面新建一个接口StudentMapper.java,用来对应xml文件中的sql语句(映射),从而方便我们调用

package com.briup.mappers;
			import java.util.List;
			import com.briup.pojo.Student;

			//创建映射器Mapper接口StudentMapper
			//方法名和StudentMapper.xml中定义的SQL映射定义名相同
			//这个其实就是dao层接口(数据访问层,负责和数据库进行交互)
 		    public interface StudentMapper {
				List<Student> findAllStudents();
				Student findStudentById(Integer id);
				void insertStudent(Student student);
				//void updateStudent(Student student);
				//void deleteStudentById(Integer id);
				//void insertStudentWithPhone(Student student);
				//Student findStudentWithPhoneById(Integer id);
		    }

1.10.7 创建一个测试类StudentMapperTest.java

package test;
			import java.io.InputStream;
			import java.util.Date;

			import org.apache.ibatis.io.Resources;
			import org.apache.ibatis.session.SqlSession;
			import org.apache.ibatis.session.SqlSessionFactory;
			import org.apache.ibatis.session.SqlSessionFactoryBuilder;
			import org.junit.Test;

			import com.briup.mappers.StudentMapper;
			import com.briup.pojo.Student;

			public class StudentMapperTest {

				@Test
				public void test_insert(){

					try {
						InputStream inputStream = Resources.getResourceAsStream("mybatis-config.xml");
						SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
						SqlSession sqlSession = sqlSessionFactory.openSession();

						StudentMapper studentMapper = sqlSession.getMapper(StudentMapper.class);
						Student s = new Student(1,"tom","123@briup.com",new Date());
						studentMapper.insertStudent(s);
						sqlSession.commit();
					} catch (Exception e) {
						e.printStackTrace();
					}

				}
			}

1.10.8 运行成功后会在控制台中看到log4j日志输出的这个程序运行的相关信息
1.10.9 对mybatis的一些基本封装
每次读取配置文件,产生一个工厂对象SqlSessionFactory,然后再生成出SqlSession对象,这个过程虽然并不复杂,但是也都是一些重复的代码流程,所以我们可以对其进行一个简单的封装:

	package com.briup.utils;

			import java.io.IOException;
			import java.io.InputStream;

			import org.apache.ibatis.io.Resources;
			import org.apache.ibatis.session.SqlSession;
			import org.apache.ibatis.session.SqlSessionFactory;
			import org.apache.ibatis.session.SqlSessionFactoryBuilder;

			public class MyBatisSqlSessionFactory {
				private static SqlSessionFactory sqlSessionFactory;

				public static SqlSessionFactory getSqlSessionFactory(){
					if(sqlSessionFactory == null){
						InputStream inputStream = null;
						try {
							inputStream = Resources.getResourceAsStream("mybatis-config.xml");
							sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
						} catch (IOException e) {
							e.printStackTrace();
							throw new RuntimeException(e.getCause());
						}
					}
					return sqlSessionFactory;
				}

				public static SqlSession openSession() {
					return openSession(false);
				}
				public static SqlSession openSession(boolean autoCommit) {
					return getSqlSessionFactory().openSession(autoCommit);
				}

			}

之后每次使用的时候只需要调用该类中的静态方法openSession即可
上面的代码可简写为: //注意事务是自动提交还是手动提交
MyBatisSqlSessionFactory.openSession().getMapper(StudentMapper.class).insertStudent(s);

     	*******************************************************
		注意:xml文件中写的sql语句,最后面不要写分号,否则会报错误,ORA-00911: 无效字符
		*******************************************************