mybatis api 官方文档

　　mybatis api chm 中文版是款非常实用的Mybatis中文文档；它可以快速的帮助大家进行使用Mybatis，Mybatis是可以支持您的SQL查询和对存储的框架等，并且软件还对 JDBC 代码、手工设置等结果的检索，使您的可以方便，快速的进行　MyBatis 的使用，而且还是中文的界面，让您的使用更加的快速，简单，可以也更好的帮助到您，需要的朋友赶快将软件下载来使用试试吧！

软件功能

　　从 XML 文件中构建 SqlSessionFactory 的实例非常简单。这里建议你使用类路径下的资

　　源文件来配置，但是你可以使用任意的 Reader 实例，这个实例包括由文字形式的文件路径

　　或 URL 形式的文件路径 file://来创建。MyBatis 包含了一些工具类，称作为资源，这些工具

　　类包含一些方法，这些方法使得从类路径或其他位置加载资源文件更加简单。

　　String resource = "org/mybatis/example/Configuration.xml";

　　Reader reader = Resources.getResourceAsReader(resource);

　　sqlMapper = new SqlSessionFactoryBuilder().build(reader);

　　XML 配置文件包含对 MyBatis 系统的核心设置，包含获取数据库连接实例的数据源和

　　决定事务范围和控制的事务管理器。关于 XML 配置文件的详细内容可以在文档后面找到

软件特色

　　全自动的目录及文件导入（可以包括子目录）;

　　EasyCHM支持导入任意的文件类型;

　　EasyCHM操作速度快，性能稳定，EasyCHM因为上手容易深得广大用户好评;

　　EasyCHM自动生成CHM的目录列表并自动生成所有目录项;

　　为CHM的目录列表自动添加多级编号;

　　在编辑目录项、索引项时用到的移动、拖拽、替换等操作中Easy CHM完全支持多选及拖拽操作，避免了一项一项地操作，极大的减少用户手工 － 非常适合企业维护大型CHM帮助文档;

　　支持批量查找替换多级目录各项的标题文字内容;

　　允许用户指定从文本文件的第N行自动截取标题;

　　易用的目录/索引编辑器;

　　丰富实用的CHM制作选项帮助用户制作更加个性化的专业CHM电子书或CHM帮助文件;

　　EasyCHM自动生成输出Alias和Map头文件;

　　EasyCHM自动生成上下文相关的帮助文件（ContextID），适合于软件公司制作专业的支持Help Context ID的专业帮助文件;

　　EasyCHM可以保存工程文件，方便企业用户编辑维护文档。

　　批量更换CHM目录各项的图标;

　　内嵌CHM反编译工具

　　未注册限制

　　EasyCHM的未注册版本可以制作带任意层级目录的CHM，但是每个CHM的工具栏上都会自动添加一个ABOUT按钮，以提醒用户注册。

　　注册版本不会添加ABOUT按钮。

　　EasyCHM的未注册版本无法保存CHM的通用工程文件，如*.HHP、*.HHC、*.HHK等。

　　未注册版本的EasyCHM会自动删除*.HHP、*.HHC、*.HHK这几个文件。

　　未注册版本制作的CHM标题上会有Made by UNREGISTERED version of Easy CHM这样的提示您试用的是未注册版本的文字。

软件目录

　　什么是MyBatis？……5

　　入门……5

　　从XML中构建SqlSessionFactory……5

　　不使用XML构建SqlSessionFactory……6

　　从SqlSessionFactory中获取SqlSession……6

　　探究已映射的SQL语句……7

　　命名空间的一点注释……8

　　范围和生命周期……8

　　SqlSessionFactoryBuilder……8

　　SqlSessionFactory……9

　　SqlSession……9

　　Mapper实例……9

　　XML映射配置文件……10

　　properties……10

　　Settings……11

　　typeAliases……12

　　typeHandlers……13

　　objectFactory……14

　　plugins……15

　　environments……16

　　transactionManager……17

　　dataSsource……17

　　mappers……19

　　SQL映射的XML文件……19

　　select……20

　　insert，update，delete……21

　　sql……23

　　Parameters……24

　　resultMap……25

　　高级结果映射……27

　　id，result……29

　　支持的JDBC类型……30

　　构造方法……30

　　关联……31

　　集合……34

　　鉴别器……36

　　缓存……38

　　使用自定义缓存……38

　　参照缓存……39

　　动态SQL……39

　　if……40

　　choose,when,otherwise……40

　　trim,where,set……41

　　foreach……43

　　JavaAPI……43

　　应用目录结构……43

　　SqlSessions……44

　　SqlSessionFactoryBuilder……44

　　SqlSessionFactory……46

　　SqlSession……47

　　SelectBuilder……53

　　SqlBuilder……56

使用方法

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

　　要注意XML头部的声明，需要用来验证XML文档正确性。environment元素体中包含对事

　　务管理和连接池的环境配置。mappers元素是包含所有mapper（映射器）的列表，这些mapper

　　的XML文件包含SQL代码和映射定义信息。

　　不使用XML构建SqlSessionFactory

　　如果你喜欢从Java程序而不是XML文件中直接创建配置实例，或创建你自己的配置构

　　建器，MyBatis也提供完整的配置类，提供所有从XML文件中加载配置信息的选项。

　　DataSourcedataSource=BlogDataSourceFactory.getBlogDataSource（）；

　　TransactionFactorytransactionFactory=new

　　JdbcTransactionFactory（）；

　　Environmentenvironment=

　　newEnvironment（"development",transactionFactory,dataSource）；

　　Configurationconfiguration=newConfiguration（environment）；

　　configuration.addMapper（BlogMapper.class）；

　　SqlSessionFactorysqlSessionFactory=

　　newSqlSessionFactoryBuilder（）。build（configuration）；

　　注意这种情况下配置是添加映射类。映射类是Java类，这些类包含SQL映射语句的注

　　解从而避免了XML文件的依赖，XML映射仍然在大多数高级映射（比如：嵌套Join映射）

　　时需要。出于这样的原因，如果存在XML配置文件的话，MyBatis将会自动查找和加载一

　　个对等的XML文件（这种情况下，基于类路径下的BlogMapper.class类的类名，那么

　　BlogMapper.xml将会被加载）。后面我们会了解更多。

　　从SqlSessionFactory中获取SqlSession

　　现在，我们已经知道如何获取SqlSessionFactory对象了，基于同样的启示，我们就可以

　　获得SqlSession的实例了。SqlSession对象完全包含以数据库为背景的所有执行SQL操作的

　　方法。你可以用SqlSession实例来直接执行已映射的SQL语句。例如：

　　SqlSessionsession=sqlMapper.openSession（）；

　　try{

　　Blogblog=（Blog）session.selectOne（

　　"org.mybatis.example.BlogMapper.selectBlog",101）；

　　}finally{

　　session.close（）；

　　}

　　这种方法起到的作用，和我们使用之前的MyBatis版本是相似的，现在有一种更简洁的

　　方法。使用合理描述参数和SQL语句返回值的接口（比如BlogMapper.class），这样现在就

　　可以至此那个更简单，更安全的代码，没有容易发生的字符串文字和转换的错误。

　　例如：

　　SqlSessionsession=sqlSessionFactory.openSession（）；

　　try{

　　BlogMappermapper=session.getMapper（BlogMapper.class）；

　　Blogblog=mapper.selectBlog（101）；

　　}finally{

　　session.close（）；

　　}

　　现在我们来探究一下这里到底执行了什么。

　　探究已映射的SQL语句

　　这里你也许想知道通过SqlSession和Mapper对象到底执行了什么操作。已映射的SQL

　　语句是一个很大的主题，而且这个主题会贯穿本文档的大部分内容。为了给出一个宏观的概

　　念，这里有一些示例。

　　上面提到的任何一个示例，语句是通过XML或注解定义的。我们先来看看XML。使

　　用基于XML的映射语言，在过去的几年中使得MyBatis非常流行，他为MyBatis提供所有

　　的特性设置。如果你以前用过MyBatis，这个概念应该很熟悉了，但是XML映射文件也有

　　很多的改进，后面我们会详细来说。这里给出一个基于XML映射语句的示例，这些语句应

　　该可以满足上述示例中SqlSession对象的调用。

　　"http://mybatis.org/dtd/mybatis-3-mapper.dtd">

　　select*fromBlogwhereid=#{id}

　　这个简单的例子中看起来有很多额外的东西，但是也相当简洁了。你可以在一个单独的

　　XML映射文件中定义很多的映射语句，除XML头部和文档类型声明之外，你可以得到很

　　多方便之处。在文件的剩余部分是很好的自我解释。在命名空间

　　“com.mybatis.example.BlogMapper”中，它定义了一个名为“selectBlog”的映射语句，这

　　样它允许你使用完全限定名“org.mybatis.example.BlogMapper.selectBlog”来调用映射语句，

　　我们下面示例中所有的写法也是这样的。

　　Blogblog=（Blog）session.selectOne（

　　"org.mybatis.example.BlogMapper.selectBlog",101）；

　　要注意这个使用完全限定名调用Java对象的方法是相似的，这样做是有原因的。这个

　　命名可以直接给相同命名空间下的的映射类，使用一个名称，参数和返回值和已映射的查询

　　语句都一样的方法即可。这就允许你非常容易地调用映射器接口中的方法，这和你前面看到

　　的是一样的，下面这个示例中它又出现了。

　　BlogMappermapper=session.getMapper（BlogMapper.class）；

　　Blogblog=mapper.selectBlog（101）；

常见问题

　　什么是MyBatis？

　　MyBatis是支持普通SQL查询，存储过程和高级映射的优秀持久层框架。MyBatis消除

　　了几乎所有的JDBC代码和参数的手工设置以及结果集的检索。MyBatis使用简单的XML

　　或注解用于配置和原始映射，将接口和Java的POJOs（PlanOldJavaObjects，普通的Java

　　对象）映射成数据库中的记录。