mybatis-3.4.5官方参考文档(中文版)资源-CSDN文库

需积分: 49 184 浏览量 2017-11-24 14:30:41 上传评论 4 收藏 4.25MB PDF 举报

MyBatis是一款流行的Java持久层框架，它专注于SQL层的定制化操作。相较于传统的JDBC操作，MyBatis能够显著减少代码量，简化数据库操作过程，并且通过XML或注解的方式可以灵活配置SQL语句，映射原生信息到Java对象。MyBatis支持定制化SQL、存储过程以及高级映射，并且能够自动处理Java对象的数据库记录映射。 MyBatis的版本3.4.5是一个较为成熟的版本，具有较好的用户群体和广泛的社区支持。该版本的官方文档详细介绍了如何安装和配置MyBatis，以及如何使用它的核心功能。用户可以通过官方网站获得官方参考文档，并且可以下载作者根据官方文档制作的带有书签和重点标注的PDF书籍，以辅助学习和应用。 MyBatis的安装非常简单，只需将jar包置于项目classpath中即可。如果使用Maven作为构建工具，则可以在pom.xml中添加依赖来引入MyBatis。MyBatis的配置一般从一个XML文件开始，其中配置了数据库连接信息、事务管理器等核心设置。MyBatis使用SqlSessionFactory作为SQL会话的工厂，可以从中获取SqlSession实例，而SqlSessionFactory则可以通过SqlSessionFactoryBuilder来构建，它可以从XML配置文件或一个预先定制的Configuration实例构建SqlSessionFactory实例。 MyBatis的XML配置文件是整个框架的核心，它配置了数据源和事务管理器等关键组件。除了XML配置，MyBatis还提供了一个强大的动态SQL功能，允许在XML映射文件中根据不同的条件生成不同的SQL语句。MyBatis也提供了Java API供开发者使用，可以通过Java代码直接操作SQL语句和结果集映射。此外，MyBatis的SQL语句构建器为构建SQL提供了便捷的方式，让开发人员能以编程方式动态生成SQL语句。MyBatis还具备日志功能，可以帮助开发者追踪和诊断问题。文档还提供了项目文档、信息以及报表，帮助用户更好地理解和使用MyBatis。 MyBatis的国际化做的非常到位，它提供了多个语言版本的文档，方便不同语言的用户进行学习。如上所述，文档中还鼓励用户如果发现文档有不足之处，可以通过fork官方的Git代码库，对文档进行更新，并提交pullrequest，为MyBatis社区贡献自己的力量。需要注意的是，文档的有些内容是通过OCR扫描文档获得的，可能有字识别错误或漏识别的情况，因此在阅读时可能需要结合上下文信息进行理解，确保内容的准确性。

资源推荐

资源详情

资源评论

mybatis – MyBatis 3 | 简介

http://www.mybatis.org/mybatis-3/zh/index.html[2017-09-20 11:50:51]

mybatis

最近更新: 20 八月 2017|

版本: 3.4.6-SNAPSHOT

参考文档

简介

入门

XML配置

XML映射文件

动态SQL

Java API

SQL语句构建器

日志

项目文档

项目信息

项目报表

简介

什么是 MyBatis ？

MyBatis 是一款优秀的持久层框架，它支持定制化 SQL、存储过程以及高级映射。MyBatis 避免了几乎所有

的 JDBC 代码和手动设置参数以及获取结果集。MyBatis 可以使用简单的 XML 或注解来配置和映射原生信

息，将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java对象)映射成数据库中的记录。

帮助改进文档...

不管你以何种方式发现了文档的不足，或是丢失对某一特性的描述，那么你能做的最好的事情莫过于去研究

它并把文档写出来。

该文档 xdoc 格式的源码文件可通过项目的 Git 代码库来获取。Fork 该源码库，做出更新，然后提交一个

pull request 吧。

你将成为本文档的最佳作者，MyBatis 的用户定会过来查阅的。

当前的国际化版本

MyBatis 的其他语言版本：

English

Español

日本語

mybatis – MyBatis 3 | 入门

http://www.mybatis.org/mybatis-3/zh/getting-started.html[2017-09-20 11:51:24]

XML

配置文件（

configuration XML

）中包含了对

MyBatis

系统的核心设置，包含获取数据库连接实例的数据

源（DataSource）和决定事务作用域和控制方式的事务管理器（TransactionManager）。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">

</dataSource>

</environment>

</environments>

</mappers>

</configuration>

当然，还有很多可以在XML 文件中进行配置，上面的示例指出的则是最关键的部分。要注意 XML 头部的声

明，用来验证 XML 文档正确性。environment 元素体中包含了事务管理和连接池的配置。mappers 元素则

是包含一组 mapper 映射器（这些 mapper 的 XML 文件包含了 SQL 代码和映射定义信息）。

不使用 XML 构建 SqlSessionFactory

如果你更愿意直接从 Java 程序而不是 XML 文件中创建 configuration，或者创建你自己的 configuration 构

建器，MyBatis 也提供了完整的配置类，提供所有和 XML 文件相同功能的配置项。

DataSource dataSource = BlogDataSourceFactory.getBlogDataSource();

TransactionFactory transactionFactory = new JdbcTransactionFactory();

Environment environment = new Environment("development", transactionFactory, dataSource);

Configuration configuration = new Configuration(environment);

configuration.addMapper(BlogMapper.class);

SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(configuration);

注意该例中，configuration 添加了一个映射器类（mapper class）。映射器类是 Java 类，它们包含 SQL 映

射语句的注解从而避免了 XML 文件的依赖。不过，由于 Java 注解的一些限制加之某些 MyBatis 映射的复杂

性，XML 映射对于大多数高级映射（比如：嵌套 Join 映射）来说仍然是必须的。有鉴于此，如果存在一个

对等的 XML 配置文件的话，MyBatis 会自动查找并加载它（这种情况下， BlogMapper.xml 将会基于类路径

和 BlogMapper.class 的类名被加载进来）。具体细节稍后讨论。

从 SqlSessionFactory 中获取 SqlSession

既然有了 SqlSessionFactory ，顾名思义，我们就可以从中获得 SqlSession 的实例了。SqlSession 完全包含

了面向数据库执行 SQL 命令所需的所有方法。你可以通过 SqlSession 实例来直接执行已映射的 SQL 语句。

例如：

SqlSession session = sqlSessionFactory.openSession();

try {

Blog blog = (Blog) session.selectOne("org.mybatis.example.BlogMapper.selectBlog", 101);

} finally {

session.close();

}

诚然这种方式能够正常工作，并且对于使用旧版本 MyBatis 的用户来说也比较熟悉，不过现在有了一种更直

白的方式。使用对于给定语句能够合理描述参数和返回值的接口（比如说BlogMapper.class），你现在不但

可以执行更清晰和类型安全的代码，而且还不用担心易错的字符串字面值以及强制类型转换。

xml定义方式

mybatis – MyBatis 3 | 入门

http://www.mybatis.org/mybatis-3/zh/getting-started.html[2017-09-20 11:51:24]

例如：

SqlSession session = sqlSessionFactory.openSession();

try {

BlogMapper mapper = session.getMapper(BlogMapper.class);

Blog blog = mapper.selectBlog(101);

} finally {

session.close();

}

现在我们来探究一下这里到底是怎么执行的。

探究已映射的 SQL 语句

现在，或许你很想知道 SqlSession 和 Mapper 到底执行了什么操作，而 SQL 语句映射是个相当大的话题，

可能会占去文档的大部分篇幅。不过为了让你能够了解个大概，这里会给出几个例子。

在上面提到的两个例子中，一个语句应该是通过 XML 定义，而另外一个则是通过注解定义。先看 XML 定义

这个，事实上 MyBatis 提供的全部特性可以利用基于 XML 的映射语言来实现，这使得 MyBatis 在过去的数

年间得以流行。如果你以前用过 MyBatis，这个概念应该会比较熟悉。不过 XML 映射文件已经有了很多的改

进，随着文档的进行会愈发清晰。这里给出一个基于 XML 映射语句的示例，它应该可以满足上述示例中

SqlSession 的调用。

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

select * from Blog where id = #{id}

</select>

</mapper>

对于这个简单的例子来说似乎有点小题大做了，但实际上它是非常轻量级的。在一个 XML 映射文件中，你

想定义多少个映射语句都是可以的，这样下来，XML 头部和文档类型声明占去的部分就显得微不足道了。文

件的剩余部分具有很好的自解释性。在命名空间“org.mybatis.example.BlogMapper”中定义了一个名

为“selectBlog”的映射语句，这样它就允许你使用指定的完全限定

名“org.mybatis.example.BlogMapper.selectBlog”来调用映射语句，就像上面的例子中做的那样：

Blog blog = (Blog) session.selectOne("org.mybatis.example.BlogMapper.selectBlog", 101);

你可能注意到这和使用完全限定名调用 Java 对象的方法是相似的，之所以这样做是有原因的。这个命名可

以直接映射到在命名空间中同名的 Mapper 类，并在已映射的 select 语句中的名字、参数和返回类型匹配成

方法。这样你就可以向上面那样很容易地调用这个对应 Mapper 接口的方法。不过让我们再看一遍下面的例

子：

BlogMapper mapper = session.getMapper(BlogMapper.class);

Blog blog = mapper.selectBlog(101);

第二种方法有很多优势，首先它不是基于字符串常量的，就会更安全；其次，如果你的 IDE 有代码补全功

能，那么你可以在有了已映射 SQL 语句的基础之上利用这个功能。

提示命名空间的一点注释

命名空间（Namespaces）在之前版本的 MyBatis 中是可选的，容易引起混淆因此是没有益处的。现在的命

名空间则是必须的，目的是希望能比只是简单的使用更长的完全限定名来更进一步区分语句。

命名空间使得你所见到的接口绑定成为可能，尽管你觉得这些东西未必用得上，你还是应该遵循这里的规定

java注解定义方式

剩余64页未读，继续阅读

评论收藏

内容反馈

jianglcj

粉丝: 1
资源: 9

mybatis-3.4.5官方参考文档(中文版)

mybatis官方文档，中文版

myBatis官方文档

myBatis中文文档

MyBatis中文文档

MyBatis中文版文档资源

mybatis_3.5.9官方中文文档pdf

mybatis-3.4.3官方文档

mybatis-3.4.1中文文档

mybatis-3.4.5-API文档-中文版.zip

Mybatis3.4.4中文参考文档.CHM

mybatis-3.4.5.jar中文-英文对照文档.zip

mybatis-3.4.5.jar

mybatis-3.4.5[jar+source]官网资源

mybatis-3.4.5(jar+sources+javadoc)

mybatis的中文api文档

spring4.3.16+springmvc+mybatis3.4.5+mysql（ssm）

Mybatis官方文档

Mybatis官方文档最新

Mybatis 相关

zookeeper-3.4.9-API文档-中文版.zip

MyBatis官方参考文档.zip

mybatis框架jar包

MyBatis-3.4.5官网下载

MyBatis最新版本3.4.5官方包

Python官方教程中文版3.4.1-带标签

Mybatis开发手册

Python_3.4_入门指南-官方中文版

OpenCV 3.4.0 官方离线文档

最新资源