※ 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的使用变得容易。
※ 2 Git
是一个免费开源的分布式版本控制系统,被用于高速有效地处理大大小小项目中所有文件,在软件开发中使用的其他版本控制软件类似与SVN、VSS、CVS等等。作为一个分布式的版本控制系统,在Git中并不存在主库这样的概念,每一份复制出的库都可以独立使用,任何两个库之间的不一致之处都可以进行合并。github以托管各种git库,并提供一个web界面,可以说是一款易于使用的git图形客户端。我们熟知的spring、struts、Hibernate等框架的源代码在github上面都可以找到其源代码。
※ 3 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/
※ 4 当前有很多Java实现的持久化框架,而MyBatis流行起来有以下原因:
4.1 它消除了大量的JDBC冗余代码
Java通过JDBC的API来操作关系型数据库,但是JDBC是一个非常底层的API,我们需要书写大量的代码来完成对数据库的操作。例如一个插入操作(参考之前学习JDBC时候的代码实例)
但是使用mybatis来完成相同的插入操作要简单方便灵活的多:
第一步:在SQLMapper映射配置文件中配置SQL语句,假定为StudentMapper.xml
INSERT INTO STUDENTS(ID,NAME,EMAIL)
VALUES(#{id},#{name},#{email})
第二步:创建一个StudentMapper接口
public interface StudentMapper{
void insertStudent(Student student);
}
第三步:编写java代码完成插入操作:
SqlSession session = getSqlSessionFactory().openSession();
StudentMapper mapper = session.getMapper(StudentMapper.class);
mapper.insertStudent(student);
特别之处的是:
MyBatis还提供了其他的一些特性来简化持久化逻辑的实现
它支持复杂的SQL结果集数据映射到嵌套的对象结构
它支持一对一和一对多的结果集和Java对象的映射
它支持根据输入的数据构建动态的SQL语句
4.2 它有低的学习曲线
MyBatis能够流行的首要原因之一在于它学习和使用起来非常简单,它取决于你Java和 SQL方面的知识。如果开发人员很熟悉Java和SQL,他们会发现MyBatis入门非常简单。
4.3 它可以接受SQL语句
成熟的ORM框架鼓励使用实体对象和在其底层自动产生SQL语句。由于这种的SQL生成方式,我们有可能不能够利用到数据库的一些特有的特性。Hibernate允许执行本地SQL,但是这样会打破持久层和数据库独立的原则。MyBatis框架接受SQL语句,而不是将其对开发人员隐藏起来。由于MyBatis不会产生任何的SQL语句,所以开发人员就要准备SQL语句,这样就可以充分利用数据库特有的特性并且可以准备自定义的查询。另外,MyBatis 对存储过程也提供了支持。
4.5 它提供了与Spring框架的集成支持
MyBatis提供了与流行的依赖注入框架Spring的开包即用的集成支持,这将进一步简化MyBatis的使用。
4.6 它提供了与第三方缓存类库的集成支持
MyBatis有内建的SqlSession级别的缓存机制,用于缓存Select语句查询出来的结果。除此之外,MyBatis提供了与多种第三方缓存类库的集成支持,如EHCache,OSCache,Hazelcast等。
4.7 它引入了更好的性能
性能问题是关乎软件应用成功与否的关键因素之一。为了达到更好的性能,需要考虑很多事情,而对很多应用而言,数据持久化层是整个系统性能的关键。MyBatis支持数据库连接池,消除了为每一个请求创建一个数据库连接的开销,MyBatis提供了内建的缓存机制,在SqlSession级别提供了对SQL查询结果的缓存。即:如果你调用了相同的select查询,MyBatis 会将放在缓存的结果返回,而不会去再查询数据库。MyBatis框架并没有大量地使用代理机制,因此对于其他的过度地使用代理的ORM框架而言,MyBatis可以获得更好的性能.
※ 5 mybatis的jar包
mybatis的核心包只有一个mybatis-3.x.0.jar,另外还有一些
【可选】的依赖包(日志、代理等所需要的),在下载的压缩包中可以找到。
※ 6 mybatis框架中一般需要俩种文件:
第一种:mybatis的配置文件: mybatis-config.xml,其中包括数据库连接信息,类型别名等等。
特点:
名字一般是固定的,位置是src下面。
示例:
第二种:mybatis的映射文件:XxxxxMapper.xml,这个xml文件中包括Xxxx类所对应的数据库表的各种增删改查sql语句
特点:
名字一般为XxxxMapper.xml,Xxxx是对应类的名字,位置不固定,一般放到一个专门的package里面。
实例:
INSERT INTO STUDENTS(ID,NAME,EMAIL)
VALUES(#{id },#{name},#{email})
※ 7 mybatis中的映射接口XxxxMapper.java(对XxxxMapper.xml中的sql语句进行映射)
mybatis中除了必须的jar包、各种xml配置文件之外,一般还需要有调用sql语句执行的接口XxxxMapper.java
示例:
public interface StudentMapper{
List findAllStudents();
Student findStudentById(Integer id);
void insertStudent(Student student);
}
注意:接口中的方法的名字和XML文件定义的SQL映射语句的名称要相同同时我们不需要去实现该接口,因为mybatis中提供了相应的方式在运行期间动态生成该接口的实现类对象(动态代理技术,spring框架中会想些讲解动态代理).
※ 8 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 sqlSession = sqlSessionFactory.openSession();
//第一种执行sql语句的方式 通过XxxxMapper接口的实现类对象来调用
//动态获得XxxxMapper接口的实现类
StudentMapper studentMapper = sqlSession.getMapper(StudentMapper.class);
studentMapper.insertStudent(new Student(1,"tom","[email protected]"));
//第二种执行sql语句的方式 执行调用XxxxMapper.xml中写好的sql语句
//也可以【不通过】Mapper接口执行映射的SQL
//然而,使用 Mapper接口是最佳实践
//sqlSession.selectOne("com.briup.pojo.StudentMapper.findStudentById",1);
※ 1 数据库建表 dob=Date of Birth
CREATE TABLE STUDENTS (
stud_id number PRIMARY KEY,
name varchar2(50) ,
email varchar2(50) ,
dob date
);
※ 2 新建一个项目,创建好相应的package及class
package com.briup.bean;
import java.util.Date;
public class Student {
private Integer studid;
private String name;
private String email;
private Date dob;
public void setStud_id(Integer id){
System.out.println("%%%:"+id);
}
@Override
public String toString() {
return "Student [studid=" + studid + ", name=" + name + ", email=" + email + ", dob=" + dob + "]";
}
public Student() {
super();
}
public Student(Integer studid, String name, String email, Date dob) {
this.studid = studid;
this.name = name;
this.email = email;
this.dob = dob;
}
public Integer getStudid() {
System.out.println("&&&&");
return studid;
}
public void setStudid(Integer studid) {
this.studid = studid;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public String getemail() {
return email;
}
public void setemail(String email) {
this.email = email;
}
public Date getDob() {
return dob;
}
public void setDob(Date dob) {
this.dob = dob;
}
}
※ 3 项目中引入mybatis的核心包以及可选的依赖包
必须的包 mybatis-3.3.0.jar ojdbc14.jar
可选的包 junit-4.7.jar log4j-1.2.17.jar
※ 4 mybatis中的配置文件和映射文件分别引入到项目中
src下面的mybatis-config.xml:
com.briup.dao包下面的StudentMapper.xml:
insert into students(stud_id,name,email,dob)
values(#{studid},#{name},#{email},#{dob})
delete from students
where stud_id=#{id}
update students
set name=#{name},
email=#{email},
dob=#{dob}
where stud_id=#{studid}
※ 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
※ 6 com.briup.dao包下面新建一个接口StudentMapper.java,用来对应xml文件中的sql语句(映射),从而方便我们调用
package com.briup.dao;
import java.util.List;
import com.briup.bean.Student;
//创建映射器Mapper接口StudentMapper
//方法名和StudentMapper.xml中定义的SQL映射定义名相同
//这个其实就是dao层接口(数据访问层,负责和数据库进行交互)
public interface StudentMapper {
void saveStudent(Student stu);
Student findStudentByid(Integer id);
List findStudents();
void deleteStudent(Integer id);
void updateStudent(Student stu);
}
※ 7 创建一个测试类StudentMapperTest.java
package com.briup.dao;
import java.io.IOException;
import java.io.InputStream;
import java.util.Date;
import java.util.List;
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.bean.Student;
import com.briup.util.MyBatisSqlSessionFactory;
public class StudentTest {
@Test
public void select_stu(){
SqlSession session=
MyBatisSqlSessionFactory.openSession();
StudentMapper sm=
session.getMapper(StudentMapper.class);
Student s=sm.findStudentByid(2);
System.out.println(s);
}
@Test
public void update_stu_test(){
try {
InputStream is=
Resources.getResourceAsStream("mybatis-config.xml");
SqlSessionFactory factory=
new SqlSessionFactoryBuilder().build(is);
SqlSession session=factory.openSession();
StudentMapper sm=
session.getMapper(StudentMapper.class);
Student stu=
new Student(2, "briup", "[email protected]", new Date());
sm.updateStudent(stu);
session.commit();
} catch (Exception e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
}
@Test
public void delete_stu_test(){
try {
InputStream is=
Resources.getResourceAsStream("mybatis-config.xml");
SqlSessionFactory factory=
new SqlSessionFactoryBuilder().build(is);
SqlSession session=factory.openSession();
StudentMapper sm=
session.getMapper(StudentMapper.class);
sm.deleteStudent(1);
session.commit();
} catch (Exception e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
}
@Test
public void select_stus_test(){
try {
InputStream is=
Resources.getResourceAsStream("mybatis-config.xml");
SqlSessionFactory factory=
new SqlSessionFactoryBuilder().build(is);
SqlSession session=factory.openSession();
StudentMapper sm=
session.getMapper(StudentMapper.class);
List list=sm.findStudents();
System.out.println(list);
} catch (Exception e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
}
@Test
public void select_stu_test(){
try {
InputStream is=
Resources.getResourceAsStream("mybatis-config.xml");
SqlSessionFactory factory=
new SqlSessionFactoryBuilder().build(is);
SqlSession session=factory.openSession();
StudentMapper sm=
session.getMapper(StudentMapper.class);
Student stu=sm.findStudentByid(1);
System.out.println(stu);
} catch (Exception e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
}
@Test
public void insert_stu_test(){
try {
//读取核心配置文件
InputStream is=
Resources.getResourceAsStream("mybatis-config.xml");
//构建sqlSessionFactory对象
SqlSessionFactory factory=
new SqlSessionFactoryBuilder().build(is);
//构建SqlSession对象
SqlSession session=factory.openSession();
//构建接口的实现类(代理jdk)
StudentMapper sm=
session.getMapper(StudentMapper.class);
Student stu=
new Student(4, "tom", "[email protected]", new Date());
sm.saveStudent(stu);
session.commit();
} catch (Exception e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
}
}
※ 8 运行成功后会在控制台中看到log4j日志输出的这个程序运行的相关信息
※ 9 对mybatis的一些基本封装
每次读取配置文件,产生一个工厂对象SqlSessionFactory,然后再生成出SqlSession对象,这个过程虽然并不复杂,但是也都是一些重复的代码流程,所以我们可以对其进行一个简单的封装:
package com.briup.util;
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 factory=null;
private static SqlSessionFactory getFactory(){
if(factory==null){
synchronized (MyBatisSqlSessionFactory.class) {
if(factory==null){
try {
InputStream is=
Resources.getResourceAsStream("mybatis-config.xml");
//指令重排序
factory=
new SqlSessionFactoryBuilder().build(is);
} catch (IOException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
}
}
}
return factory;
}
public static SqlSession
openSession(boolean autoCommit){
//openSession没有传入参数的时候,默认
//false 手动提交
return getFactory().openSession(autoCommit);
}
public static SqlSession openSession(){
return openSession(false);
}
}
之后每次使用的时候只需要调用该类中的静态方法openSession即可,上面的代码可简写为: //注意事务是自动提交还是手动提交。
MyBatisSqlSessionFactory.openSession().getMapper(StudentMapper.class).insertStudent(s);