Mybatis_day1

mybatis框架的引入:
JDBC里面对功能实现的进一步封装，可以按照以下方式操作
Student s = new Student(id,name);
util.save(s);

ORM: object relation mapping 【对象】【关系】映射
将对象映射到数据库中
类名数据库表名
对象一整行
数据成员列
也映射关系：
1 对 1
1 对 n
n 对 n

JDBC -- ORM -- 封装 -- ORM框架
典型框架: Hibernate mybatis
SSH SSM
在使用框架的过程中，我们可以尽可能简单，不用书写sql语句，只需要给出需要操作的对象，修改xml配置文件，就可以实现功能。sql语句由框架自动帮我们实现。

ORM框架核心理解：
ORM框架可以帮我们映射对象和表，比如Student s; save(s); 想要执行成功关键在于要能把s对象【对应到student表】，要能把s对象中的成员和student表中的【列对应】起来。

如何实现呢？配置文件是一个好帮手。

ORM框架有什么用？
让程序员工作尽量简化，少些代码，大大提升开发效率！

Hibernate重量级框架
功能强大，笨重，程序员的工作尽可能被简化了，提高了我们的开发效率。
框架【自动生成sql代码】简单易用
mybatis 轻量级框架
【自己编写sql代码】效率高，更灵活

课程章节介绍：
1.mybatis的入门、概述
2.mybatis的配置文件
3.mybatis的映射文件/映射接口
4.单表的映射配置和使用
5.多表的映射配置和使用
1对1 1对多多对多
6.动态sql语句的配置
select * from student
where 【条件1】 and 【条件2】 ...;
7.mybatis中的特殊功能
枚举类型 BLOD类型多个参数提取指定列...
8.mybatis中的注解配置
抛开xml配置文件实现配置

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

流行原因:
随着互联网的发展，有很多创业型公司，他们在开始时要求框架简单易用，让程序员快速上手，尽可能快的开发出来产品。另外在后期的维护中，能【快速的迭代升级】，具有一定的灵活性。

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

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

1.4 mybatis相关jar包的下载
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的下载地址【3.5.6版】：
https://github.com/mybatis/mybatis-3/releases

doc文档下载：
http://www.mybatis.org/mybatis-3/

1.5 MyBatis的特点_优势
当前有很多Java实现的持久化框架，而MyBatis流行起来有以下原因：
1.5.1 它【消除】了大量的JDBC【冗余代码】
Java通过JDBC的API来操作关系型数据库，但是JDBC是一个非常底层的API,我们需要书写大量的代码来完成对数据库的操作。但是使用mybatis来完成相同的插入操作要简单方便灵活的多，它操作数据库一般需要三个步骤，具体如下：

我们以一个插入操作为例(参考之前学习JDBC时候的代码实例)：
第一步:在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 session = getSqlSessionFactory().openSession();
StudentMapper mapper = session.getMapper(StudentMapper.class);
mapper.insertStudent(student);
session.commit();

特别之处的是，MyBatis还提供了其他的一些特性来简化持久化逻辑的实现
它支持复杂的SQL结果集数据映射到嵌套的对象结构；
它支持一对一和一对多的结果集和Java对象的映射；
它支持根据输入的数据构建动态的SQL语句。

1.5.2 它有低的学习曲线
MyBatis能够流行的首要原因之一在于它【学习和使用】起来非常简单，它取决于你Java和 SQL方面的知识。如果开发人员很熟悉Java和SQL，他们会发现MyBatis入门非常简单。

1.5.3 它能很好地与传统数据库协同工作
有时我们可能需要用不正规形式与传统数据库协同工作，使用成熟的ORM框架(例如大家熟知的Hibernate)有可能、但是很难跟传统数据库很好地协同工作，因为他们尝试将Java对象静态地映射到数据库的表上.而MyBatis是将查询的结果与Java对象映射起来，这使得MyBatis可以很好地与传统数据库协同工作。你可以根据面相对象的模型创建Java域对象，执行传统数据库的查询，然后将结果映射到对应的Java对象上。

Hibernate中对象与表的映射是固定死的，无法灵活改变，但mybatis不存在这样问题。

1.5.4 它可以接受SQL语句
也就是说【程序员可以自己去写Sql语句】，保证灵活和高效率。
成熟的ORM框架鼓励使用实体对象和在其底层自动产生SQL语句。由于这种的SQL生成方式，我们有可能不能够利用到数据库的一些特有的特性。Hibernate允许执行本地SQL，但是这样会打破持久层和数据库独立的原则。MyBatis框架接受SQL语句，而不是将其对开发人员隐藏起来。由于MyBatis不会产生任何的SQL语句，所以开发人员就要准备SQL语句，这样就可以充分利用数据库特有的特性并且可以准备自定义的查询。另外，MyBatis 对存储过程也提供了支持。

1.5.5 它提供了与Spring框架的集成支持
将MyBatis继承到Spring里面，用Spring管理MyBatis.
MyBatis提供了与流行的依赖注入框架Spring的开包即用的集成支持，这将进一步简化MyBatis的使用。
【Spring可以算是开发必备】

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(相对其他框架，【轻便】很多),另外还有一些【可选】的依赖包(日志、代理等所需要的),在下载的压缩包中可以找到.

ssh要导入百十个jar包。ssm就省事多了。

**********************************************************
以下这几个东西，配置文件，映射文件，映射接口，具体实现相关的类，没有操作，讲不清楚，
所以，先去把架子搭起来，然后再讲解。

1.7 mybatis框架中一般需要两种文件
第一种:【mybatis的配置文件】，一般都起名为 mybatis-config.xml,其中包括数据库连接信息,类型别名,映射文件路径等等
特点:
名字一般是固定的,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">

第二种:mybatis的映射文件
其名字一般为 XxxxMapper.xml,这个xml文件中包括了与Xxxx类相关的数据库操作的sql语句。例如:StudentMapper.xml文件中是Student类对应的表的各种select insert update delete等sql语句。

特点:
名字一般为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="id" column="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);
//"com....StudentMapper是【命名空间】，后面是【id值】",就可以访问到sql语句，1是传递的参数【不推荐】

******************
总结：使用mybatis
1.需要jar包(提供mybatis框架的核心功能)
2.配置文件(数据库连接信息等内容)
3.映射文件(列出要执行的sql语句，并且每个sql语句对应的id值)
4.映射接口(接口中的方法名和Sql语句的id值对应，将来用接口中的方法就相应执行对应的sql语句)
5.session对象(获得映射接口的实现类对象，通过动态代理实现)

******************

一起动手操作配置好，步骤很关键，不用细致的理解，先用起来再说

1.10 mybatis实际应用
使用mybatis框架将java对象里面的信息插入到数据库表中。

1.10.1 数据库建表
drop table students;
create table students (
stud_id number PRIMARY KEY,
name varchar2(50) ,
email varchar2(50) ,
dob date
);

其中 dob = Date of Birthday

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中的配置文件和映射文件分别引入到项目中
a.在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>

b.在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">

<mapper namespace="com.briup.mappers.StudentMapper">

<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 准备映射接口StudentMapper.java
在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);
}

思考：为什么我们的xml文件能够和接口对应起来？
xml文件中标签的命名空间名是和接口的全包名是一致的。

1.10.6 创建一个测试类StudentMapperTest.java(test包下面)
junit单元测试: 允许程序，不需要写main方法，而直接去运行测试函数。
在测试函数上添加 @Test 注解，
导入junit-4.7.jar包，然后右键运行程序即可。

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.7 配置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

mybatis内部包含日志相关的处理，所以必须使用日志配置文件。

1.10.8 运行成功后会在控制台中看到log4j日志输出的这个程序运行的相关信息
可以发现底层是通过ps语句实现的功能。

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: 无效字符
*******************************************************

1.10.11 实现修改功能
第一步，在StudentMapper.xml文件中添加sql语句
//标签就使用update
//注意id要和接口方法名对应 parameterType和方法形参对应,没有返回值
<update id="updateStudent" parameterType="Student">
update students
set
//注意，具体值一定要和Student类里面属性名相对应
name=#{name},email=#{email},dob=#{dob}
where stud_id=#{studId}
</update>

第二步，到StudentMapper接口中添加updateStudent(Student s)方法；
参数类型、返回值类型要和xml文件一致

第三步，在测试文件中，获取到映射接口对象mapper，然后直接用mapper调用updateStudent(s)方法即可。

1.10.12 实现删除功能

*******************************