Mybatis 3学习笔记（一）

主要内容：

What is MyBatis?
Why MyBatis?
Installing and configuring MyBatis
Sample domain model

What is MyBaits?

MyBatis是一个开源持久化框架，用于简化持久层的实现。Mybatis可以减少很多JDBC相关的模板样式代码，还提供了方便使用的数据库API。

MyBatis发展自iBATIS，但是MyBatis 3对iBATIS进行了彻底的重构，从而可以使用注解（annotations）和映射器（Mappers）。

简洁的设计和易用性使得MaBatis在J2EE开发中很快流行起来。在Java应用中，持久层的工作包括：将SQL语句从数据库中查询出的数据填充进Java对象中、使用SQL语句将Java对象中的数据保存进数据库。

MyBatis提供了下列特性来简化SQL查询：（1）抽象底层的JDBC代码；（2）自动将SQL查询的结果集保存进对应的Java对象；（3）从Java对象中提取数据并存入数据库中对应的表。

ORM模型就是数据库的表和简单Java对象（Plain Ordinary Java Object，简称POJO）的映射关系模型，它主要解决数据库数据和POJO对象的映射。

Why MyBatis?

企业级应用开发领域有很多持久化开发框架，MyBatis能够脱颖而出的原因在于：

减少了很多JDBC的模板样式代码；
学习曲线低；
可以很好地适配遗留数据库；
开发者需要自己写SQL语句；
可以和Spring、Guice等框架整合使用；
支持第三方缓存库；
具备良好的性能。

减少JDBC的模板样式代码

关于JDBC代码的冗长，可以参考Spring实战6-利用Spring和JDBC访问数据库一文中用过的例子。

直接使用JDBC的API，会有很多重复代码：创建连接、创建statement、设置输入参数，最后还需要关闭资源。MyBatis将这些通用功能抽象出来单独完成，以便开发者可以专注于真正重要的事情，包括书写SQL语句、构建Java对象等。

除了这些，MyBatis可以自动完成两个工作：把Java对象中的属性设置进SQL字符串的查询参数、利用SQL查询结果集的数据构造Java对象。实现方法如下：

在SQL Mapper配置文件中（StudentMapper.xml）配置查询语句

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

创建StudentMapper接口

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

在Java代码中的用法如下

SqlSession session = getSqlSessionFactory().openSession();
StudentMapper mapper = session.getMapper(StudentMapper.class);
// select Student by Id
Student student = mapper.selectStudentById(1);
// To insert a Student record
mapper.insertStudent(student);

可以看出，如果使用MyBatis框架，开发者不需要自己管理资源和处理异常，因为MyBatis会替你完成这些工作。除此之外，MyBatis还提供了其他特性，也可以简化持久层的实现：

支持复杂SQL结果集到复杂对象的映射；
支持1-1和1-n映射，将结果集中的数据映射到Java对象中；
支持基于输入数据构建动态SQL查询。

学习曲线低

MyBatis的学习曲线很低，如果开发者之前熟悉Java和SQL开发，则只需要稍作学习就可以在项目中使用MyBatis。

可以很好地适配遗留数据库

有时候，我们需要使用不规范的遗留数据库。在维护老服务时经常遇到这种情况，使用类似Hibernate的ORM框架会非常麻烦，因为这类框架试图将Java对象映射到数据库中的表格里。

MyBatis可以自动将查询结果映射到Java对象中，这个特性使得MyBatis非常适合使用遗留数据库。

拥抱SQL语句

完全的ORM框架，例如Hibernate鼓励开发者直接使用实体对象，而由框架自动产生SQL语句。正因如此，导致开发者不能使用特定数据库的优化特性。Hibernate也允许开发者写SQL语句，但这又违背了“持久层应该与数据库独立”的承诺。

MyBatis让开发者自己写SQL语句，因此可以利用特定数据库的优化特性，例如支持使用数据库存储过程。

支持使用第三方缓存库

MyBatis本身支持在SqlSession层面缓存SELECT查询结果。除此之外，MyBatis也支持使用其他第三方缓存，例如EHCache、OSCache和Hazelcast。

更好的性能

大型企业级应用必须具备良好的性能。在性能分析时，一般使用调用链路分析法：业务操作、缓存操作和持久层。持久层的性能经常会成为应用的性能瓶颈。

MyBatis支持使用数据库连接池，从而避免为每个查询请求创建数据库连接；
MyBatis拥有内置的缓存机制，可以在SqlSession层面缓存SQL查询的结果——如果你在执行一个select查询之后不久又再次遇到同样的请求，则直接返回缓存区中的数据，从而节省一次数据库查询。
MyBatis并没有大量使用代理，因此比其他大量使用代理的ORM框架有更好的性能。

注意：在软件开发中没有万能的工具。每个应用场景都有不同的需求，我们应该根据具体的应用场景选择要使用的语言和框架。上文中讲了很多MyBatis的优势，不过，也有一些情况下并不适合使用MyBatis。如果应用是基于对象模型驱动并想动态生成SQL语句；另外，如果开发者希望在应用中使用透明的事务处理机制（持久化父对象的同时也持久化与之关联的子对象），这两种情况下都比较适合使用Hibernate。

安装和配置MyBatis

在数据库中创建students表，并插入例子数据；

create table students
(
stud_id int(11) not null auto_increment,
name varchar(50) not null,
email varchar(50) not null,
dob date default null,
primary key (stud_id)
) engine=InnoDB auto_increment=1 default charset=latin1;
insert into students(stud_id, name, email, dob)
values(1, 'Student1', 'student1@gmail.com', '1983-06-25');
insert into students(stud_id, name, email, dob)
values(2, 'Student2', 'student2@gmail.com', '1983-06-25');

创建一个maven项目，配置jar依赖项，pom文件的内容如下：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.javadu</groupId>
    <artifactId>leanMybatis</artifactId>
    <version>1.0-SNAPSHOT</version>

    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>io.spring.platform</groupId>
                <artifactId>platform-bom</artifactId>
                <version>2.0.1.RELEASE</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
            <dependency>
                <groupId>org.springframework</groupId>
                <artifactId>spring-framework-bom</artifactId>
                <version>4.2.4.RELEASE</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>

    <dependencies>
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.3.0</version>
        </dependency>
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>5.1.38</version>
            <scope>runtime</scope>
        </dependency>
        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-api</artifactId>
            <version>1.7.13</version>
        </dependency>
        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-log4j12</artifactId>
            <version>1.7.13</version>
        </dependency>
        <dependency>
            <groupId>log4j</groupId>
            <artifactId>log4j</artifactId>
            <version>1.2.17</version>
        </dependency>
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.12</version>
            <scope>test</scope>
        </dependency>
    </dependencies>
</project>

然后，在resources目录下创建log4j.properties文件，填入如下内容：

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

创建mybatis-config.xml和StudentMapper.xml配置文件，mybatis-config.xml作为MyBatis的主配置文件，用于定义数据库连接、类型别名等等；StudentMapper.xml配置文件包含操作students表的SQL语句。

首先，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.javadu.domain.Student" alias="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/mybatis" />
                <property name="username" value="root" />
                <property name="password" value="root" />
            </dataSource>
        </environment>
    </environments>

    <mappers>
        <mapper resource="mybatis/mappers/StudentMapper.xml" />
    </mappers>
</configuration>

然后，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="mybatis.mappers.StudentMapper">
    <resultMap id="studentResult" type="Student">
        <id property="studId" column="sutd_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>

最后编辑于：2017.11.27 06:19:19

人面猴
序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
沈念sama阅读 159,015评论 4赞 362
死咒
序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
沈念sama阅读 67,262评论 1赞 292
救了他两次的神仙让他今天三更去死
文/潘晓璐我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
开封第一讲书人阅读 108,727评论 0赞 243
道士缉凶录：失踪的卖姜人
文/不坏的土叔我叫张陵，是天一观的道长。经常有香客问我，道长，这世上最难降的妖魔是什么？我笑而不...
开封第一讲书人阅读 43,986评论 0赞 205
港岛之恋（遗憾婚礼）
正文为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
茶点故事阅读 52,363评论 3赞 287
恶毒庶女顶嫁案：这布局不是一般人想出来的
文/花漫我一把揭开白布。她就那样静静地躺着，像睡着了一般。火红的嫁衣衬着肌肤如雪。梳的纹丝不乱的头发上，一...
开封第一讲书人阅读 40,610评论 1赞 219
城市分裂传说
那天，我揣着相机与录音，去河边找鬼。笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。我是一名探鬼主播，决...
沈念sama阅读 31,871评论 2赞 312
双鸳鸯连环套：你想象不到人心有多黑
文/苍兰香墨我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
开封第一讲书人阅读 30,582评论 0赞 198
万荣杀人案实录
序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
沈念sama阅读 34,297评论 1赞 242
护林员之死
正文独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋以下内容为张勋视角年9月15日...
茶点故事阅读 30,551评论 2赞 246
白月光启示录
正文我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
茶点故事阅读 32,053评论 1赞 260
活死人
序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
沈念sama阅读 28,385评论 2赞 253
日本核电站爆炸内幕
正文年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
茶点故事阅读 33,035评论 3赞 236
男人毒药：我在死后第九天来索命
文/蒙蒙一、第九天我趴在偏房一处隐蔽的房顶上张望。院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
开封第一讲书人阅读 26,079评论 0赞 8
一桩弑父案，背后竟有这般阴谋
文/苍兰香墨我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。一阵脚步声响...
开封第一讲书人阅读 26,841评论 0赞 195
情欲美人皮
我被黑心中介骗来泰国打工，没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。一个月前我还...
沈念sama阅读 35,648评论 2赞 274
代替公主和亲
正文我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
茶点故事阅读 35,550评论 2赞 270