MyBatis 3 | 정책 빌더

ResultMap Attributes
Attribute	Description	속성	설명
`id`	A unique identifier in this namespace that can be used to reference this result map.	결과매핑을 참조하기 위해 사용할 수 있는 값으로 네임스페이스에서 유일한 식별자
`type`	A fully qualified Java class name, or a type alias (see the table above for the list of built-in type aliases). +	패키지를 포함한 자바 클래스명이나 타입별칭(내장된 타입별칭이 목록은 위 표를 보자.).
`autoMapping`	If present, MyBatis will enable or disable the automapping for this ResultMap. - This attribute overrides the global autoMappingBehavior. Default: unset. +	이 설정을 사용하면 마이바티스는 결과매핑을 자동매핑으로 처리할지 말지를 처리한다. + 이 속성은 autoMappingBehavior 라는 전역설정을 덮는다. 디폴트는 unset이다.
`fetchType`	- Optional. Valid values are `lazy` and `eager`. If present, it supersedes - the global configuration parameter `lazyLoadingEnabled` for this mapping. + 선택가능한 속성으로 사용가능한 값은 `lazy` 와 `eager`이다. + 이 속성을 사용하면 전역 설정파라미터인 `lazyLoadingEnabled` 를 대체한다.
`columnPrefix`	- When joining multiple tables, you would have to use column alias to avoid duplicated - column names in the ResultSet. Specifying columnPrefix allows you to map such columns - to an external resultMap. Please see the example explained later in this section. + 여러개의 테이블을 조인할때 ResultSet에서 칼럼명의 중복을 피하기 위해 칼럼별칭을 사용할 수 있다. + 칼럼을 외부 결과매핑에 매핑하기 위해 columnPrefix를 명시하자. 이 절의 뒤에 나오는 에제를 보자.
`notNullColumn`	- By default a child object is created only if at least one of the columns mapped to the child's properties - is non null. With this attribute you can change this behaviour by specifiying which columns must have a value - so MyBatis will create a child object only if any of those columns is not null. Multiple column names can be - specified using a comma as a separator. Default value: unset. + 기본적으로 자식객체는 칼럼중 적어도 하나를 null이 아닌 자식객체의 프로퍼티에 매핑할때 만들어진다. + 이 속성을 사용해서 칼럼이 값을 가져야만 하는 것을 명시해서 행위를 변경할 수 있다. + 그래서 마이바티스는 이러한 칼럼이 null이 아닐때만 자식 객체를 만들것이다. + 여러개의 칼럼명은 구분자로 콤마를 사용해서 명시한다. + 디폴트값은 unset이다.
`autoMapping`	If present, MyBatis will enable or disable automapping when mapping the result to this property. - This attribute overrides the global autoMappingBehavior. - Note that it has no effect on an external resultMap, so it is pointless to use it with `select` or `resultMap` attribute. Default value: unset. +	이 속성을 사용하면 마이바티스는 결과를 프로퍼티에 매핑할때 자동매핑을 사용할지 말지를 정한다. + 이 속성은 전역설정인 autoMappingBehavior를 무시하게 한다. + 외부 결과매핑에는 영향을 주지 않는다. + 그래서 `select` 나 `resultMap` 속성을 함께 사용하는 것은 의미가 없다. + 디폴트값은 unset이다.
- true + false

- -

- To use the MyBatis you just need to include the - - mybatis-x.x.x.jar - - file in the classpath. -

- If you are using Maven just add the following dependency to your pom.xml: -

+ +

想要使用 MyBatis 只需将 mybatis-x.x.x.jar 文件置于 classpath 中。

如果使用 Maven 构建项目，则需将下面的 dependency 置于 pom.xml 中：

org.mybatis @@ -49,27 +42,13 @@ -

- 每一个 MyBatis 的应用程序都以一个 SqlSessionFactory 对象的实例为核心。 -SqlSessionFactory 对象的实例可以通过 SqlSessionFactoryBuilder 对象来获得。 -SqlSessionFactoryBuilder 对象可以从 XML 配置文件,或从 Configuration 类的习惯准备的实 -例中构建 SqlSessionFactory 对象。 -

-从 XML 文件中构建 SqlSessionFactory 的实例非常简单。这里建议你使用类路径下的资 -源文件来配置,但是你可以使用任意的 Reader 实例,这个实例包括由文字形式的文件路径 -或 URL 形式的文件路径 file://来创建。MyBatis 包含了一些工具类,称作为资源,这些工具 -类包含一些方法,这些方法使得从类路径或其他位置加载资源文件更加简单。 -

每个基于 MyBatis 的应用都是以一个 SqlSessionFactory 的实例为中心的。SqlSessionFactory 的实例可以通过 SqlSessionFactoryBuilder 获得。SqlSessionFactoryBuilder 可以从 XML 配置文件或一个预先定制的 Configuration 的实例构建出 SqlSessionFactory 的实例。

从 XML 文件中构建 SqlSessionFactory 的实例非常简单，建议使用类路径下的资源文件进行配置。但是也可以使用任意的 InputStream 实例，包括字符串形式或 URL 形式的文件路径来配置。MyBatis 包含一个叫 Resources 的工具类，它包含一些静态方法，可使从 classpath 或其他位置加载资源文件更容易。

-XML 配置文件包含对 MyBatis 系统的核心设置,包含获取数据库连接实例的数据源和 -决定事务范围和控制的事务管理器。关于 XML 配置文件的详细内容可以在文档后面找到, -这里给出一个简单的示例: -

XML 配置文件（configuration XML）中包含了对 MyBatis 系统的核心设置，包含获取数据库连接实例的数据源（DataSource）和决定事务范围和控制方式的事务管理器（TransactionManager）。XML 配置文件的详细内容后面再探讨，这里先给出一个简单的示例：

]]> -

-当然, XML 配置文件中还有很多可以配置的, -在 -上面的示例指出的则是最关键的部分。 -要注意 XML 头部的声明,需要用来验证 XML 文档正确性。environment 元素体中包含对事 -务管理和连接池的环境配置。 -mappers 元素是包含所有 mapper 映射器) -( -的列表, -这些 mapper -的 XML 文件包含 SQL 代码和映射定义信息。 -

当然，XML 配置文件中还有很多可以配置的，上面的示例指出的则是最关键的部分。要注意 XML 头部的声明，需要用来验证 XML 文档正确性。environment 元素体中包含了事务管理和连接池的环境配置。mappers 元素是包含一组 mapper 映射器（这些 mapper的 XML 文件包含了 SQL 代码和映射定义信息）。

- 如果你喜欢从 Java 程序而不是 XML 文件中直接创建配置实例, -或创建你自己的配置构 -建器,MyBatis 也提供完整的配置类,提供所有从 XML 文件中加载配置信息的选项。 - -

如果你更愿意直接从 Java 程序而不是 XML 文件中创建配置，或创建你自己的配置构建器，MyBatis 也提供了完整的配置类，具有所有和 XML 文件相同功能的配置项。

-注意这种情况下配置是添加映射类。映射类是 Java 类,这些类包含 SQL 映射语句的注 -解从而避免了 XML 文件的依赖, -XML 映射仍然在大多数高级映射 -(比如: -嵌套 Join 映射) -时需要。出于这样的原因,如果存在 XML 配置文件的话,MyBatis 将会自动查找和加载一 -个对等的 XML 文件(这种情况下,基于类路径下的 BlogMapper.class 类的类名,那么 -BlogMapper.xml 将会被加载)。后面我们会了解更多。 -

注意该例中配置添加了一个映射类（mapper class）。映射类是 Java 类，它们包含 SQL 映射语句的注解从而避免了 XML 文件的依赖，不过，由于 Java 注解的一些限制加之某些 MyBatis 映射的复杂性，XML 映射对于大多数高级映射（比如：嵌套 Join 映射）来说仍然是必须的。鉴于此，如果存在一个对等的 XML 配置文件的话，MyBatis 会自动查找并加载它（这种情况下， BlogMapper.xml 将会基于类路径和 BlogMapper.class 的类名被加载进来）。具体细节稍后继续。

-现在,我们已经知道如何获取 SqlSessionFactory 对象了,基于同样的启示,我们就可以 -获得 SqlSession 的实例了。 -SqlSession 对象完全包含以数据库为背景的所有执行 SQL 操作的 -方法。你可以用 SqlSession 实例来直接执行已映射的 SQL 语句。例如: -

既然有了 SqlSessionFactory ，顾名思义，我们就可以从中获得 SqlSession 的实例了。SqlSession 完全包含了面向数据库执行 SQL 命令所需的所有方法。你可以通过 SqlSession 实例来直接执行已映射的 SQL 语句。例如：

-这种方法起到的作用, -和我们使用之前的 MyBatis 版本是相似的, -现在有一种更简洁的 -方法。使用合理描述参数和 SQL 语句返回值的接口(比如 BlogMapper.class) -,这样现在就 -可以至此那个更简单,更安全的代码,没有容易发生的字符串文字和转换的错误。 -

-例如: -

诚然这种方式能够正常工作，并且对于之前版本 MyBatis 的用户来说也比较熟悉，不过现在有了一种更直白的方式。通过使用对于给定语句能够合理描述参数和返回值的接口（比如说BlogMapper.class），你现在不但可以执行更清晰和类型安全的代码，而且还不用担心易错的字符串字面值以及强制类型转换。

例如：

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

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

-这里你也许想知道通过 SqlSession 和 Mapper 对象到底执行了什么操作。已映射的 SQL -语句是一个很大的主题, -而且这个主题会贯穿本文档的大部分内容。 -为了给出一个宏观的概 -念,这里有一些示例。 -上面提到的任何一个示例,语句是通过 XML 或注解定义的。我们先来看看 XML。使 -用基于 XML 的映射语言,在过去的几年中使得 MyBatis 非常流行,他为 MyBatis 提供所有 -的特性设置。如果你以前用过 MyBatis,这个概念应该很熟悉了,但是 XML 映射文件也有 -很多的改进,后面我们会详细来说。这里给出一个基于 XML 映射语句的示例,这些语句应 -该可以满足上述示例中 SqlSession 对象的调用。 -

到这里你或许很想知道 SqlSession 和 Mapper 到底执行了什么操作，而 SQL 映射是个相当大的话题，可能会占去文档的大部分篇幅。不过为了让你能够了解个大概，这里会给出几个如何运行的例子。

在上面提到的两个例子中，语句应该是一个通过 XML 定义，一个通过注解定义。先看 XML 定义这个，事实上 MyBatis 提供的全部特性可以利用基于 XML 的映射语言来实现，这使得 MyBatis 在过去的数年间得以流行。如果你以前用过 MyBatis，这个概念应该会比较熟悉。不过 XML 映射文件已经有了很多的改进，随着文档的进行会愈发清晰。这里给出一个基于 XML 映射语句的示例，它应该可以满足上述示例中 SqlSession 的调用。

]]> -

-这个简单的例子中看起来有很多额外的东西, -但是也相当简洁了。 -你可以在一个单独的 -XML 映射文件中定义很多的映射语句,除 XML 头部和文档类型声明之外,你可以得到很 -多方便之处。在文件的剩余部分是很好的自我解释。在命名空间 -“com.mybatis.example.BlogMapper”中,它定义了一个名为“selectBlog”的映射语句,这 -样它允许你使用完全限定名 -“org.mybatis.example.BlogMapper.selectBlog” -来调用映射语句, -我们下面示例中所有的写法也是这样的。 -

对于这个简单的例子来说似乎有点小题大做了，但实际上它是非常轻量的。在一个 XML 映射文件中，你想定义多少个映射语句都是可以的，这样下来，XML 头部和文件类型声明占去的部分就显得微不足道了。文件的剩余部分具有很好的自解释性。在命名空间“com.mybatis.example.BlogMapper”中定义了一个名为“selectBlog”的映射语句，这样它就允许你使用指定的完全限定名“org.mybatis.example.BlogMapper.selectBlog”来调用映射语句，就像上面的例子中做的那样：

-要注意这个使用完全限定名调用 Java 对象的方法是相似的,这样做是有原因的。这个 -命名可以直接给相同命名空间下的的映射类, -使用一个名称, -参数和返回值和已映射的查询 -语句都一样的方法即可。 -这就允许你非常容易地调用映射器接口中的方法, -这和你前面看到 -的是一样的,下面这个示例中它又出现了。 -

你可能注意到这和使用完全限定名调用 Java 对象的方法是相似的，之所以这样做是有原因的。这个命名可以直接映射到在命名空间中同名的 Mapper 类，并在已映射的 select 语句中的名字、参数和返回类型匹配成方法。这样你就可以向上面那样很容易地调用这个对应 Mapper 接口的方法。不过让我们再看一遍下面的例子：

-第二种方式有很多有点,首先它不是基于文字的,那就更安全了。第二,如果你的 IDE -有代码补全功能,那么你可以利用它来操纵已映射的 SQL 语句。第三,不需要强制类型转 -换,同时 BlogMapper 接口可以保持简洁,返回值类型很安全(参数类型也很安全) -。

第二种方法有很多优势，首先它不是基于字符串常量的，就会更安全；其次，如果你的 IDE 有代码补全功能，那么你可以在有了已映射的 SQL 语句之后利用这个功能。

提示命名空间的一点注释

命名空间（Namespaces）在之前版本的 MyBatis 中是可选的，容易引起混淆因此是没有益处的。现在的命名空间则是必须的，目的是希望能比只是简单的使用更长的完全限定名来区分语句更进一步。

命名空间使得你所见到的接口绑定成为可能，尽管你觉得这些东西未必用得上，你还是应该遵循这里的规定以防哪天你改变了主义。长远考虑，一旦用上了命名空间，并将它置于合适的 Java 包命名空间之下，你将拥有一份更易维护的代码并提高了 MyBatis 的可用性。

- 重要 - 命名空间的一点注释 -

- 命名空间 -在之前版本的 MyBatis 中是可选项,非常混乱也没有帮助。现在,命名空间 -是必须的,而且有一个目的,它使用更长的完全限定名来隔离语句。 -

-命名空间使得接口绑定成为可能,就像你看到的那样,如果之前不了解,那么现在你 -就会使用它们了,你应该按照下面给出示例的来练习,以免改变自己的想法。使用命名空 -间,并将它放在合适的 Java 包空间之下,将会使你的代码变得简洁,在很长的时间内提高 -MyBatis 的作用。 -

- 命名解析: 为了减少输入量,MyBatis 对所有的命名配置元素使用如下的命名解析规 -则,包括语句,结果映射,缓存等。 + 命名解析：为了减少输入量，MyBatis 对所有的命名配置元素（包括语句，结果映射，缓存等）使用了如下的命名解析规则。

直接查找完全限定名(比如“com.mypackage.MyMapper.selectAllThings”,如果 -) 发现就使用。 +
完全限定名（比如“com.mypackage.MyMapper.selectAllThings”）将被直接查找并且找到即用。
短名称(比如“selectAllThings” -)可以用来引用任意含糊的对象。而如果有两个 -或两个以上的(比如“com.foo.selectAllThings ”和“com.bar.selectAllThings” -), 那么就会得到错误报告,说短名称是含糊的,因此就必须使用完全限定名。 +
短名称（比如“selectAllThings”）如果全局唯一也可以作为一个单独的引用。如果不唯一，有两个或两个以上的相同名称（比如“com.foo.selectAllThings ”和“com.bar.selectAllThings”），那么使用时就会收到错误报告说短名称是不唯一的，这种情况下就必须使用完全限定名。

-如 BlogMapper 这样的映射器类来说,还有一个妙招。它们中间映射的语句可以不需要 -在 XML 中来写,而可以使用 Java 注解来替换。比如,上面的 XML 示例可以如下来替换: -

对于像 BlogMapper 这样的映射器类（Mapper class）来说，还有另一招来处理映射。它们的映射的语句可以不需要用 XML 来做，取而代之的可以是 Java 注解。比如，上面的 XML 示例可被替换如下：

-对于简单语句来说,使用注解代码会更加清晰,然而 Java 注解对于复杂语句来说就会 -混乱, -应该限制使用。 -因此, -如果你不得不做复杂的事情, -那么最好使用 XML 来映射语句。 -

-当然这也取决于你和你的项目团队的决定, -看哪种更适合你来使用, -还有以长久方式来 -使用映射语句的重要性。也就是说,不要将自己局限在一种方式中。你可以轻松地将注解换 -成 XML 映射语句,反之亦然。 -

对于简单语句来说，注解使代码显得更加简洁，然而 Java 注解对于稍微复杂的语句就会力不从心并且会显得更加混乱。因此，如果你需要做很复杂的事情，那么最好使用 XML 来映射语句。

选择何种方式以及映射语句的定义的一致性对你来说有多重要这些完全取决于你和你的团队。换句话说，永远不要拘泥于一种方式，你可以很轻松的在基于注解和 XML 的语句映射方式间自由移植和切换。

- -

-理解我们目前已经讨论过的不同范围和生命周期类是很重要的。 -不正确的使用它们会导 -致严重的并发问题。 -

+ +

理解我们目前已经讨论过的不同范围和生命周期类是至关重要的，因为错误的使用会导致非常严重的并发问题。

重要 - Object lifecycle and Dependency Injection Frameworks -

- Dependency Injection frameworks can create thread safe, transactional SqlSessions and mappers - and inject them directly into your beans so you can just forget about their lifecycle. - You may want to have a look at MyBatis-Spring or - MyBatis-Guice sub-projects to know more about using MyBatis with DI frameworks. +

提示 + 对象的生命周期和依赖注入框架

依赖注入框架可以创建线程安全的、基于事务的 SqlSession 和映射器（mapper）并将它们直接注入到你的 bean 中，因此可以直接忽略它们的生命周期。如果对如何通过依赖注入框架来使用 MyBatis 感兴趣可以研究一下 MyBatis-Spring 或 MyBatis-Guice 两个子项目。

SqlSessionFactoryBuilder

-这个类可以被实例化,使用和丢弃。一旦你创建了 SqlSessionFactory 后,这个类就不需 -要存在了。 -因此 SqlSessionFactoryBuilder 实例的最佳范围是方法范围 -(也就是本地方法变量)。 -你可以重用 SqlSessionFactoryBuilder 来创建多个 SqlSessionFactory 实例, -但是最好的方式是 -不需要保持它一直存在来保证所有 XML 解析资源,因为还有更重要的事情要做。 -

这个类可以被实例化、使用和丢弃，一旦创建了 SqlSessionFactory，就不再需要它了。因此 SqlSessionFactoryBuilder 实例的最佳范围是方法范围（也就是本地方法变量）。你可以重用 SqlSessionFactoryBuilder 来创建多个 SqlSessionFactory 实例，但是最好还是不要让其一直存在以保证所有的 XML 解析资源开放给更重要的事情。

SqlSessionFactory

-一旦被创建,SqlSessionFactory 应该在你的应用执行期间都存在。没有理由来处理或重 -新创建它。 -使用 SqlSessionFactory 的最佳实践是在应用运行期间不要重复创建多次。 -这样的 -操作将被视为是非常糟糕的。 -因此 SqlSessionFactory 的最佳范围是应用范围。 -有很多方法可 -以做到, -最简单的就是使用单例模式或者静态单例模式。 -

SqlSessionFactory 一旦被创建就应该在应用的运行期间一直存在，没有任何理由对它进行清除或重建。使用 SqlSessionFactory 的最佳实践是在应用运行期间不要重复创建多次，多次重建 SqlSessionFactory 被视为一种代码“坏味道（bad smell）”。因此 SqlSessionFactory 的最佳范围是应用范围。有很多方法可以做到，最简单的就是使用单例模式或者静态单例模式。

SqlSession

-每个线程都应该有它自己的 SqlSession 实例。SqlSession 的实例不能被共享,也是线程 -不安全的。因此最佳的范围是请求或方法范围。绝对不能将 SqlSession 实例的引用放在一个 -类的静态字段甚至是实例字段中。 -也绝不能将 SqlSession 实例的引用放在任何类型的管理范 -围中, -比如 Serlvet 架构中的 HttpSession。 -如果你现在正用任意的 Web 框架, -要考虑 SqlSession -放在一个和 HTTP 请求对象相似的范围内。换句话说,基于收到的 HTTP 请求,你可以打开 -了一个 SqlSession,然后返回响应,就可以关闭它了。关闭 Session 很重要,你应该确保使 -用 finally 块来关闭它。下面的示例就是一个确保 SqlSession 关闭的基本模式: -

每个线程都应该有它自己的 SqlSession 实例。SqlSession 的实例不是线程安全的，因此是不能被共享的，所以它的最佳的范围是请求或方法范围。绝对不能将 SqlSession 实例的引用放在一个类的静态域，甚至一个类的实例域也不行。也绝不能将 SqlSession 实例的引用放在任何类型的管理范围中，比如 Serlvet 架构中的 HttpSession。如果你现在正在使用一种 Web 框架，要考虑 SqlSession 放在一个和 HTTP 请求对象相似的范围中。换句话说，每次收到的 HTTP 请求，就可以打开一个 SqlSession；返回一个响应，就关闭它。这个关闭操作是很重要的，你应该把这个关闭操作放到 finally 块中以确保每次都能执行关闭。下面的示例就是一个确保 SqlSession 关闭的标准模式：

-在你的代码中一贯地使用这种模式, -将会保证所有数据库资源都正确地关闭 -(假设你没 -有通过你自己的连接关闭,这会给 MyBatis 造成一种迹象表明你要自己管理连接资源) -。

Mapper 实例

-映射器是你创建绑定映射语句的接口。映射器接口的实例可以从 SqlSession 中获得。那 -么从技术上来说,当被请求时,任意映射器实例的最宽范围和 SqlSession 是相同的。然而, -映射器实例的最佳范围是方法范围。也就是说,它们应该在使用它们的方法中被请求,然后 -就抛弃掉。它们不需要明确地关闭,那么在请求对象中保留它们也就不是什么问题了,这和 -SqlSession 相似。你也许会发现,在这个水平上管理太多的资源的话会失控。保持简单,将 -映射器放在方法范围内。下面的示例就展示了这个实践: -

你应该在你的所有的代码中一致性地使用这种模式来保证所有数据库资源都能被正确地关闭。

映射器实例（Mapper Instances）

映射器是创建用来绑定映射语句的接口。映射器接口的实例是从 SqlSession 中获得的。因此从技术层面讲，映射器实例的最大范围是和 SqlSession 相同的，因为它们都是从 SqlSession 里被请求的。尽管如此，映射器实例的最佳范围是方法范围。也就是说，映射器实例应该在调用它们的方法中被请求，用过之后即可废弃。并不需要显示的关闭映射器实例，尽管在整个请求范围（request scope）保持映射器实例也不会有什么问题，但是很快你会发现，像 SqlSession 一样，在这个范围上管理太多的资源的话会难于控制。所以要保持简单，最好把映射器映射器放在方法范围（method scope）内。下面的示例就展示了这个实践：

MyBatis 3 | 简介 Clinton Begin Nan Lei + Dongxu Wang

- -

- MyBatis 是支持普通 SQL 查询,存储过程和高级映射的优秀持久层框架。MyBatis 消除 -了几乎所有的 JDBC 代码和参数的手工设置以及结果集的检索。MyBatis 使用简单的 XML -或注解用于配置和原始映射,将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java -对象)映射成数据库中的记录。 -

+ +

MyBatis 是支持定制化 SQL、存储过程以及高级映射的优秀的持久层框架。MyBatis 避免了几乎所有的 JDBC 代码和手工设置参数以及抽取结果集。MyBatis 使用简单的 XML 或注解来配置和映射基本体，将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java对象)映射成数据库中的记录。

- -

- 如果你发现了本文档的遗漏之处, -或者丢失 MyBatis 特性的说明时, -那么最好的方法就 -是了解一下这个遗漏之处然后把它记录下来。 -

- Sources of this manual are available in xdoc format at - project's Git - Fork the repository, update them and send a pull request. -

-你也是本文档的最佳作者,其他用户也会来阅读它的。 + +

不管你以何种方式发现了文档的不足，或是某些特性尚且没有文档，则你可以做的最好的事情莫过于去研究它并把文档写出来。

该文档 xdoc 格式的源码文件可通过项目的 Git 获取。Fork 这个源码库，更新后发送一个 pull request 吧。

你将成为这个文档的最佳作者，像你一样的用户定会过来查阅的。

+ + +

其他语言版本（Users can read about MyBatis in following translations）：

Do you want to read about MyBatis in your own native language? Fill an issue providing patches with your + mother tongue documentation!

diff --git a/src/site/zh/xdoc/java-api.xml b/src/site/zh/xdoc/java-api.xml index a039d615e..a5b83212d 100644 --- a/src/site/zh/xdoc/java-api.xml +++ b/src/site/zh/xdoc/java-api.xml @@ -121,7 +121,7 @@ Environment ... ]]> -

如果你调用了一个使用 environment 参数的 build 方法, 那么 MyBatis 将会使用 +

如果你调用了一个使用 environment 参数方式的 build 方法, 那么 MyBatis 将会使用 configuration 对象来配置这个 environment。当然, 如果你指定了一个不合法的 environment, @@ -258,7 +258,7 @@ Connection 和 autoCommit 两者的方法,因为 MyBatis 会使用当前 connect 置。 MyBatis 为事务隔离级别调用使用一个 Java 枚举包装器, 称为 TransactionIsolationLevel, -否则它们按预期的方式来工作 , 并有 JDBC 支持的 5 级 +否则它们按预期的方式来工作,并有 JDBC 支持的 5 级 ( NONE,READ_UNCOMMITTED,READ_COMMITTED,REPEA TABLE_READ,SERIALIZA BLE) @@ -803,13 +803,13 @@ type,method。type 属性是类的完全限 -

Mapper Annotation Examples

This example shows using the @SelectKey annotation to retrieve a value from a sequence before an insert:

映射申明样例

这个例子展示了如何使用 @SelectKey 注解来在插入前读取数据库序列的值：

@Insert("insert into table3 (id, name) values(#{nameId}, #{name})") @SelectKey(statement="call next value for TestSequence", keyProperty="nameId", before=true, resultType=int.class) int insertTable3(Name name); -

This example shows using the @SelectKey annotation to retrieve an identity value after an insert:

这个例子展示了如何使用 @SelectKey 注解来在插入后读取数据库识别列的值：

@Insert("insert into table2 (name) values(#{name})") @SelectKey(statement="call identity()", keyProperty="nameId", before=false, resultType=int.class) int insertTable2(Name name); diff --git a/src/site/zh/xdoc/logging.xml b/src/site/zh/xdoc/logging.xml index 86816a10f..be4c907a3 100644 --- a/src/site/zh/xdoc/logging.xml +++ b/src/site/zh/xdoc/logging.xml @@ -166,7 +166,7 @@ log4j.appender.stdout.layout.ConversionPattern=%5p [%t] - %m%n]]> log4j.logger.org.mybatis.example.BlogMapper.selectBlog=TRACE -

看到了把，两种配置没差别！ +

看到了吧，两种配置没差别！

配置文件log4j.properties的余下内容是针对日志格式的，这一内容已经超出本 @@ -176,4 +176,4 @@ log4j.appender.stdout.layout.ConversionPattern=%5p [%t] - %m%n]]>

-MyBatis 真正的力量是在映射语句中。这里是奇迹发生的地方。对于所有的力量,SQL -映射的 XML 文件是相当的简单。当然如果你将它们和对等功能的 JDBC 代码来比较,你会 -发现映射文件节省了大约 95%的代码量。MyBatis 的构建就是聚焦于 SQL 的,使其远离于 -普通的方式。 -

-SQL 映射文件有很少的几个顶级元素(按照它们应该被定义的顺序): -

MyBatis 的真正强大在于它的映射语句，也是它的魔力所在。由于它的异常强大，映射器的 XML 文件就显得相对简单。如果拿它跟具有相同功能的 JDBC 代码进行对比，你会立即发现省掉了将近 95% 的代码。MyBatis 就是针对 SQL 构建的，并且比普通的方法做的更好。

SQL 映射文件有很少的几个顶级元素（按照它们应该被定义的顺序）：

cache - – 配置给定命名空间的缓存。 + – 给定命名空间的缓存配置。
cache-ref - – 从其他命名空间引用缓存配置。 + – 其他命名空间缓存配置的引用。
resultMap - – 最复杂,也是最有力量的元素,用来描述如何从数据库结果集中来加 -载你的对象。 + – 是最复杂也是最强大的元素，用来描述如何从数据库结果集中来加载对象。
parameterMap - – 已经被废弃了!老式风格的参数映射。内联参数是首选,这个元 -素可能在将来被移除。这里不会记录。 + – 已废弃！老式风格的参数映射。内联参数是首选,这个元素可能在将来被移除，这里不会记录。
sql - – 可以重用的 SQL 块,也可以被其他语句引用。 + – 可被其他语句引用的可重用语句块。
insert @@ -79,44 +71,24 @@ SQL 映射文件有很少的几个顶级元素(按照它们应该被定义的顺 – 映射查询语句

下一部分将从语句本身开始来描述每个元素的细节。 -

下一部分将从语句本身开始来描述每个元素的细节。

-查询语句是使用 MyBatis 时最常用的元素之一。 -直到你从数据库取出数据时才会发现将 -数据存在数据库中是多么的有价值, -所以许多应用程序查询要比更改数据多的多。 -对于每次 -插入,更新或删除,那也会有很多的查询。这是 MyBatis 的一个基本原则,也是将重心和努 -力放到查询和结果映射的原因。对简单类别的查询元素是非常简单的。比如: +

查询语句是 MyBatis 中最常用的元素之一，光能把数据存到数据库中价值并不大，如果还能重新取出来才有用，多数应用也都是查询比修改要频繁。对每个插入、更新或删除操作，通常对应多个查询操作。这是 MyBatis 的基本原则之一，也是将焦点和努力放到查询和结果映射的原因。简单查询的 select 元素是非常简单的。比如：

SELECT * FROM PERSON WHERE ID = #{id} ]]> -

-这个语句被称作 selectPerson, -使用一个 int -(或 Integer) -类型的参数, -并返回一个 HashMap -类型的对象,其中的键是列名,值是列对应的值。 +

这个语句被称作 selectPerson，接受一个 int（或 Integer）类型的参数，并返回一个 HashMap 类型的对象，其中的键是列名，值便是结果行中的对应值。

-注意参数注释: -

注意参数符号：

-这就告诉 MyBatis 创建一个预处理语句参数。 -使用 JDBC, -这样的一个参数在 SQL 中会 -由一个“?”来标识,并被传递到一个新的预处理语句中,就像这样: +

这就告诉 MyBatis 创建一个预处理语句参数，通过 JDBC，这样的一个参数在 SQL 中会由一个“?”来标识，并被传递到一个新的预处理语句中，就像这样：

-当然, -这需要很多单独的 JDBC 的代码来提取结果并将它们映射到对象实例中, -这就是 -MyBatis 节省你时间的地方。我们需要深入了解参数和结果映射。那些细节部分我们下面来 -了解。 +

当然，这需要很多单独的 JDBC 的代码来提取结果并将它们映射到对象实例中，这就是 MyBatis 节省你时间的地方。我们需要深入了解参数和结果映射，细节部分我们下面来了解。

-select 元素有很多属性允许你配置,来决定每条语句的作用细节。 +

select 元素有很多属性允许你配置，来决定每条语句的作用细节。

id - 在命名空间中唯一的标识符,可以被用来引用这条语句。 + 在命名空间中唯一的标识符，可以被用来引用这条语句。 parameterType - 将会传入这条语句的参数类的完全限定名或别名。 + 将会传入这条语句的参数类的完全限定名或别名。这个属性是可选的，因为 MyBatis 可以通过 TypeHandler 推断出具体传入语句的参数，默认值为 unset。 @@ -175,100 +141,72 @@ select 元素有很多属性允许你配置,来决定每条语句的作用细节 ~~parameterMap~~ - -这是引用外部 parameterMap 的已经被废弃的方法。使用内联参数 -映射和 parameterType 属性。 + ~~这是引用外部 parameterMap 的已经被废弃的方法。使用内联参数映射和 parameterType 属性。~~ resultType - -从这条语句中返回的期望类型的类的完全限定名或别名。注意集 -合情形,那应该是集合可以包含的类型,而不能是集合本身。使 -用 resultType 或 resultMap,但不能同时使用。 + 从这条语句中返回的期望类型的类的完全限定名或别名。注意如果是集合情形，那应该是集合可以包含的类型，而不能是集合本身。使用 resultType 或 resultMap，但不能同时使用。 resultMap - -命名引用外部的 resultMap。 -返回 map 是 MyBatis 最具力量的特性, -对其有一个很好的理解的话, -许多复杂映射的情形就能被解决了。 -使用 resultMap 或 resultType,但不能同时使用。 + 外部 resultMap 的命名引用。结果集的映射是 MyBatis 最强大的特性，对其有一个很好的理解的话，许多复杂映射的情形都能迎刃而解。使用 resultMap 或 resultType，但不能同时使用。 flushCache - -将其设置为 true,不论语句什么时候被带哦用,都会导致缓存被 -清空。默认值:false。 + 将其设置为 true，任何时候只要语句被调用，都会导致本地缓存和二级缓存都会被清空，默认值：false。 useCache - -将其设置为 true, -将会导致本条语句的结果被缓存。 -默认值: -true。 + 将其设置为 true，将会导致本条语句的结果被二级缓存，默认值：对 select 元素为 true。 timeout - -这个设置驱动程序等待数据库返回请求结果,并抛出异常时间的 -最大等待值。默认不设置(驱动自行处理) + 这个设置是在抛出异常之前，驱动程序等待数据库返回请求结果的秒数。默认值为 unset（依赖驱动）。 fetchSize - -这是暗示驱动程序每次批量返回的结果行数。默认不设置(驱动 -自行处理)。 + 这是尝试影响驱动程序每次批量返回的结果行数和这个设置值相等。默认值为 unset（依赖驱动）。 statementType - -STA -TEMENT,PREPARED 或 CALLABLE 的一种。 -这会让 MyBatis -使用选择使用 Statement,PreparedStatement 或 CallableStatement。 -默认值:PREPARED。 + STATEMENT，PREPARED 或 CALLABLE 的一个。这会让 MyBatis 分别使用 Statement，PreparedStatement 或 CallableStatement，默认值：PREPARED。 resultSetType - -FORWARD_ONLY|SCROLL_SENSITIVE|SCROLL_INSENSITIVE -中的一种。默认是不设置(驱动自行处理)。 + FORWARD_ONLY，SCROLL_SENSITIVE 或 SCROLL_INSENSITIVE 中的一个，默认值为 unset （依赖驱动）。 databaseId - In case there is a configured databaseIdProvider, MyBatis will load all statements with no databaseId - attribute or with a databaseId that matches the current one. If case the same statement - if found with and without the databaseId the latter will be discarded. + 如果配置了 databaseIdProvider，MyBatis 会加载所有的不带 databaseId 或匹配当前 databaseId 的语句；如果带或者不带的语句都有，则不带的会被忽略。 resultOrdered - This is only applicable for nested result select statements: If this is true, it - is assumed that nested results are contained or grouped together such that when a - new main result row is returned, no references to a previous result row will occur - anymore. This allows nested results to be filled much more memory friendly. Default: - false. + 这个设置仅针对嵌套结果 select 语句适用：如果为 true，就是假设包含了嵌套结果集或是分组了，这样的话当返回一个主结果行的时候，就不会发生有对前面结果集的引用的情况。这就使得在获取嵌套的结果集的时候不至于导致内存不够用。默认值：false。 + + + + resultSets + 这个设置仅对多结果集的情况适用，它将列出语句执行后返回的结果集并每个结果集给一个名称，名称是逗号分隔的。 - +
- 数据变更语句 insert,update 和 delete 在它们的实现中非常相似: + 数据变更语句 insert，update 和 delete 的实现非常接近：
]]> - + @@ -306,12 +244,11 @@ FORWARD_ONLY|SCROLL_SENSITIVE|SCROLL_INSENSITIVE - + - @@ -319,78 +256,49 @@ FORWARD_ONLY|SCROLL_SENSITIVE|SCROLL_INSENSITIVE ~~parameterMap~~ - - - - - - -
Insert, Update and Delete AttributesInsert, Update 和 Delete 的属性

属性

id 在命名空间中唯一的标识符,可以被用来引用这条语句。命名空间中的唯一标识符，可被用来代表这条语句。

parameterType -将会传入这条语句的参数类的完全限定名或别名。 + 将要传入语句的参数的完全限定类名或别名。这个属性是可选的，因为 MyBatis 可以通过 TypeHandler 推断出具体传入语句的参数，默认值为 unset。

- -这是引用外部 parameterMap 的已经被废弃的方法。使用内联参数 -映射和 parameterType 属性。 + ~~这是引用外部 parameterMap 的已经被废弃的方法。使用内联参数映射和 parameterType 属性。~~

flushCache -将其设置为 true,不论语句什么时候被带哦用,都会导致缓存被清 -空。默认值:false。 + 将其设置为 true，任何时候只要语句被调用，都会导致本地缓存和二级缓存都会被清空，默认值：true（对应插入、更新和删除语句）。

timeout -这个设置驱动程序等待数据库返回请求结果, -并抛出异常时间的最 -大等待值。默认不设置(驱动自行处理)。 + 这个设置是在抛出异常之前，驱动程序等待数据库返回请求结果的秒数。默认值为 unset（依赖驱动）。

statementType -STA -TEMENT,PREPARED 或 CALLABLE 的一种。这会让 MyBatis -使用选择使用 Statement,PreparedStatement 或 CallableStatement。 -默认值:PREPARED。 + STATEMENT，PREPARED 或 CALLABLE 的一个。这会让 MyBatis 分别使用 Statement，PreparedStatement 或 CallableStatement，默认值：PREPARED。

useGeneratedKeys -( 仅对 insert, update 有用 ) 这会告诉 MyBatis 使用 JDBC 的 -getGeneratedKeys 方法来取出由数据(比如:像 MySQL 和 SQL -Server 这样的数据库管理系统的自动递增字段)内部生成的主键。 -默认值:false。 + （仅对 insert 和 update 有用）这会令 MyBatis 使用 JDBC 的 getGeneratedKeys 方法来取出由数据库内部生成的主键（比如：像 MySQL 和 SQL Server 这样的关系数据库管理系统的自动递增字段），默认值：false。

keyProperty -(仅对 insert, update 有用) -标记一个属性, -MyBatis 会通过 getGeneratedKeys -或者通过 insert 语句的 selectKey 子元素设置它的值。 -默认: -不设置。 Can be a comma separated list of property names if multiple generated columns are expected. + （仅对 insert 和 update 有用）唯一标记一个属性，MyBatis 会通过 getGeneratedKeys 的返回值或者通过 insert 语句的 selectKey 子元素设置它的键值，默认：unset。如果希望得到多个生成的列，也可以是逗号分隔的属性名称列表。

keyColumn -(仅对 insert, update 有用) -标记一个属性, -MyBatis 会通过 getGeneratedKeys -或者通过 insert 语句的 selectKey 子元素设置它的值。 -默认: -不设置。 Can be a comma separated list of columns names if multiple generated columns are expected. + （仅对 insert 和 update 有用）通过生成的键值设置表中的列名，这个设置仅在某些数据库（像 PostgreSQL）是必须的，当主键列不是表中的第一列的时候需要设置。如果希望得到多个生成的列，也可以是逗号分隔的属性名称列表。

databaseId In case there is a configured databaseIdProvider, MyBatis will load all statements with no databaseId - attribute or with a databaseId that matches the current one. If case the same statement - if found with and without the databaseId the latter will be discarded. + 如果配置了 databaseIdProvider，MyBatis 会加载所有的不带 databaseId 或匹配当前 databaseId 的语句；如果带或者不带的语句都有，则不带的会被忽略。

-
下面就是 insert,update 和 delete 语句的示例:
+
下面就是 insert，update 和 delete 语句的示例：
insert into Author (id,username,password,email,bio) @@ -410,16 +318,9 @@ MyBatis 会通过 getGeneratedKeys delete from Author where id = #{id} ]]> -
-如前所述,插入语句有一点多,它有一些属性和子元素用来处理主键的生成。 -
+
如前所述，插入语句的配置规则更加丰富，在插入语句里面有一些额外的属性和子元素用来处理主键的生成，而且有多种生成方式。
-
-首先,如果你的数据库支持自动生成主键的字段(比如 MySQL 和 SQL Server) -,那么 -你可以设置 useGeneratedKeys=”true”,而且设置 keyProperty 到你已经做好的目标属性上。 -例如,如果上面的 Author 表已经对 id 使用了自动生成的列类型,那么语句可以修改为: -
+
首先，如果你的数据库支持自动生成主键的字段（比如 MySQL 和 SQL Server），那么你可以设置 useGeneratedKeys=”true”，然后再把 keyProperty 设置到目标属性上就OK了。例如，如果上面的 Author 表已经对 id 使用了自动生成的列类型，那么语句可以修改为:
@@ -427,14 +328,10 @@ MyBatis 会通过 getGeneratedKeys values (#{username},#{password},#{email},#{bio}) ]]> -
-MyBatis 有另外一种方法来处理数据库不支持自动生成类型,或者可能 JDBC 驱动不支 -持自动生成主键时的主键生成问题。 +
对于不支持自动生成类型的数据库或可能不支持自动生成主键 JDBC 驱动来说，MyBatis 有另外一种方法来生成主键。
-
-这里有一个简单(甚至很傻)的示例,它可以生成一个随机 ID(可能你不会这么做, -但是这展示了 MyBatis 处理问题的灵活性,因为它并不真的关心 ID 的生成): +
这里有一个简单（甚至很傻）的示例，它可以生成一个随机 ID（你最好不要这么做，但这里展示了 MyBatis 处理问题的灵活性及其所关心的广度）：
@@ -446,15 +343,9 @@ MyBatis 有另外一种方法来处理数据库不支持自动生成类型,或 values (#{id}, #{username}, #{password}, #{email}, #{bio}, #{favouriteSection,jdbcType=VARCHAR}) ]]> -
-在上面的示例中,selectKey 元素将会首先运行,Author 的 id 会被设置,然后插入语句 -会被调用。 -这给你了一个简单的行为在你的数据库中来处理自动生成的主键, -而不需要使你 -的 Java 代码变得复杂。 +
在上面的示例中，selectKey 元素将会首先运行，Author 的 id 会被设置，然后插入语句会被调用。这给你了一个和数据库中来处理自动生成的主键类似的行为，避免了使 Java 代码变得复杂。
-
-selectKey 元素描述如下: +
selectKey 元素描述如下：
]]> - + @@ -473,42 +364,27 @@ selectKey 元素描述如下: - - - - - @@ -516,14 +392,12 @@ CallableStatement 类型。 -
-这个元素可以被用来定义可重用的 SQL 代码段,可以包含在其他语句中。比如: +
这个元素可以被用来定义可重用的 SQL 代码段，可以包含在其他语句中。比如：
id,username,password ]]> -
-这个 SQL 片段可以被包含在其他语句中,例如: +
这个 SQL 片段可以被包含在其他语句中，例如：
@@ -533,12 +407,8 @@ CallableStatement 类型。 ]]> - -
-在之前的语句中, -你已经看到了一些简单参数的示例。 MyBatis 中参数是非常强大的 -在 -元素。对于简单的做法,大概 90%的情况,是不用太多的,比如: + +
前面的所有语句中你所见到的都是简单参数的例子，实际上参数是 MyBatis 非常强大的元素，对于简单的做法，大概 90% 的情况参数都很少，比如：
@@ -547,14 +417,7 @@ CallableStatement 类型。 where id = #{id} ]]> -
-上面的这个示例说明了一个非常简单的命名参数映射。参数类型被设置为“int” -,因此 -这个参数可以被设置成任何内容。 -原生的类型或简单数据类型, -比如整型和没有相关属性的 -字符串,因此它会完全用参数来替代。然而,如果你传递了一个复杂的对象,那么 MyBatis -的处理方式就会有一点不同。比如: +
上面的这个示例说明了一个非常简单的命名参数映射。参数类型被设置为 int，这样这个参数就可以被设置成任何内容。原生的类型或简单数据类型（比如整型和字符串）因为没有相关属性，它会完全用参数值来替代。然而，如果传入一个复杂的对象，行为就会有一点不同了。比如：
@@ -562,70 +425,47 @@ CallableStatement 类型。 values (#{id}, #{username}, #{password}) ]]> -
-如果 User 类型的参数对象传递到了语句中, username 和 password 属性将会被查找, -id、 -然后它们的值就被传递到预处理语句的参数中。 +
如果 User 类型的参数对象传递到了语句中，id、username 和 password 属性将会被查找，然后将它们的值传入预处理语句的参数中。
-
-这点对于传递参数到语句中非常好。但是对于参数映射也有一些其他的特性。 +
这点对于向语句中传参是比较好的而且又简单，不过参数映射的功能远不止于此。
-
-首先,像 MyBatis 的其他部分,参数可以指定一个确定的数据类型。 +
首先，像 MyBatis 的其他部分一样，参数也可以指定一个特殊的数据类型。
-
-像 MyBatis 的剩余部分,javaType 通常可以从参数对象中来去顶,除非对象是一个 -HashMap。那么 javaType 应该被确定来保证使用正确类型处理器。 +
像 MyBatis 的剩余部分一样，javaType 通常可以从参数对象中来去确定，前提是只要对象不是一个 HashMap。那么 javaType 应该被确定来保证使用正确类型处理器。
-
- 注意如果 null 被当作值来传递,对于所有可能为空的列,JDBC Type 是需要的。以可 -以自己通过阅读预处理语句的 setNull()方法的 JavaDocs 文档来研究这个。 +
NOTE 如果 null 被当作值来传递，对于所有可能为空的列，JDBC Type 是需要的。你可以自己通过阅读预处理语句的 setNull() 方法的 JavaDocs 文档来研究这种情况。
-
-为了自定义类型处理器,你可以指定一个确定的类型处理器类(或别名), 比如: +
为了以后定制类型处理方式，你也可以指定一个特殊的类型处理器类（或别名），比如：
-
-尽管它看起来繁琐,但是实际上是你很少设置它们其中之一。 +
尽管看起来配置变得越来越繁琐，但实际上是很少去设置它们。
-
-对于数值类型,对于决定有多少数字是相关的,有一个数值范围。 +
对于数值类型，还有一个小数保留位数的设置，来确定小数点后保留的位数。
-
-最后,mode 属性允许你指定 IN,OUT 或 INOUT 参数。如果参数为 OUT 或 INOUT, -参数对象属性的真实值将会被改变,就像你期望你需要你个输出参数。如果 mode 为 OUT -(或 INOUT) -,而且 jdbcType 为 CURSOR(也就是 Oracle 的 REFCURSOR) -,你必须指定 -一个 resultMap 来映射结果集到参数类型。要注意这里的 javaType 属性是可选的,如果左边 -的空白是 jdbcType 的 CURSOR 类型,它会自动地被设置为结果集。 +
最后，mode 属性允许你指定 IN，OUT 或 INOUT 参数。如果参数为 OUT 或 INOUT，参数对象属性的真实值将会被改变，就像你在获取输出参数时所期望的那样。如果 mode 为 OUT（或 INOUT），而且 jdbcType 为 CURSOR(也就是 Oracle 的 REFCURSOR)，你必须指定一个 resultMap 来映射结果集到参数类型。要注意这里的 javaType 属性是可选的，如果左边的空白是 jdbcType 的 CURSOR 类型，它会自动地被设置为结果集。
-
-MyBatis 也支持很多高级的数据类型,比如结构体,但是当注册 out 参数时你必须告诉 -语句类型名称。比如(再次提示,在实际中不要像这样换行): +
MyBatis 也支持很多高级的数据类型，比如结构体，但是当注册 out 参数时你必须告诉它语句类型名称。比如（再次提示，在实际中要像这样不能换行）：
-
-尽管所有这些强大的选项很多时候你只简单指定属性名,MyBatis 会自己计算剩余的。 -最多的情况是你为 jdbcType 指定可能为空的列名。 +
尽管所有这些强大的选项很多时候你只简单指定属性名，其他的事情 MyBatis 会自己去推断，最多你需要为可能为空的列名指定 jdbcType。
-
-默认情况下,使用#{}格式的语法会导致 MyBatis 创建预处理语句属性并以它为背景设 -置安全的值(比如?) -。这样做很安全,很迅速也是首选做法,有时你只是想直接在 SQL 语 -句中插入一个不改变的字符串。比如,像 ORDER BY,你可以这样来使用: +
默认情况下,使用#{}格式的语法会导致 MyBatis 创建预处理语句属性并安全地设置值（比如?）。这样做更安全，更迅速，通常也是首选做法，不过有时你只是想直接在 SQL 语句中插入一个不改变的字符串。比如，像 ORDER BY，你可以这样来使用：
-
-这里 MyBatis 不会修改或转义字符串。 +
这里 MyBatis 不会修改或转义字符串。

- 重要接受从用户输出的内容并提供给语句中不变的字符串,这样做是不安全的。这会 -导致潜在的 SQL 注入攻击,因此你不应该允许用户输入这些字段,或者通常自行转义并检 -查。 + NOTE 以这种方式接受从用户输出的内容并提供给语句中不变的字符串是不安全的，会导致潜在的 SQL 注入攻击，因此要么不允许用户输入这些字段，要么自行转义并检验。
@@ -1804,30 +1637,30 @@ MyBatis 会从结果集中得到每条记录, - +
- As you have already seen in the previous sections, in simple cases MyBatis can auto-map the results for you - and in others you will need to build a result map. - But as you will see in this section you can also mix both strategies. - Let's have a deeper look at how auto-mapping works. + 正如你在前面一节看到的，在简单的场景下，MyBatis可以替你自动映射查询结果。 + 如果遇到复杂的场景，你需要构建一个result map。 + 但是在本节你将看到，你也可以混合使用这两种策略。 + 让我们到深一点的层面上看看自动映射是怎样工作的。

- When auto-mapping results MyBatis will get the column name and look for a property with the same name ignoring case. That means that if - a column named ID and property named id are found, MyBatis will set the id property with the ID column value. + 当自动映射查询结果时，MyBatis会获取sql返回的列名并在java类中查找相同名字的属性（忽略大小写）。 + 这意味着如果Mybatis发现了ID列和id属性，Mybatis会将ID的值赋给id。

- Usually database columns are named using uppercase letters and underscores between words and java properties often follow the camelcase - naming covention. To enable the auto-mapping between them set the setting mapUnderscoreToCamelCase to true. + 通常数据库列使用大写单词命名，单词间用下划线分隔；而java属性一般遵循驼峰命名法。 + 为了在这两种命名方式之间启用自动映射，需要将 mapUnderscoreToCamelCase设置为true。

- Auto-mapping works even when there is an specific result map. When this happens, for each result map, all columns that are present in the - ResultSet that have not a manual mapping will be auto-mapped, then manual mappings will be processed. - In the following sample id and userName columns will be auto-mapped and hashed_password column will be mapped.
- + 自动映射甚至在特定的result map下也能工作。在这种情况下，对于每一个result map,所有的ResultSet提供的列， + 如果没有被手工映射，则将被自动映射。自动映射处理完毕后手工映射才会被处理。 + 在接下来的例子中， id 和 userName列将被自动映射， hashed_password 列将根据配置映射。 +
select user_id as "id", diff --git a/src/site/zh/xdoc/statement-builders.xml b/src/site/zh/xdoc/statement-builders.xml index b82dfc8ed..50b0abb39 100644 --- a/src/site/zh/xdoc/statement-builders.xml +++ b/src/site/zh/xdoc/statement-builders.xml @@ -28,6 +28,11 @@
+ + +
This section is outdated in the Chinese version. Please refer to the English manual. Any help with the Chinese translation will be really welcome.
+ +
一个 Java 程序员面对的最痛苦的事情之一就是在 Java 代码中嵌入 SQL 语句。通常这么 diff --git a/src/test/java/org/apache/ibatis/binding/BoundAuthorMapper.java b/src/test/java/org/apache/ibatis/binding/BoundAuthorMapper.java index d6cea9851..8e7ef21af 100644 --- a/src/test/java/org/apache/ibatis/binding/BoundAuthorMapper.java +++ b/src/test/java/org/apache/ibatis/binding/BoundAuthorMapper.java @@ -19,6 +19,10 @@ import domain.blog.Post; import domain.blog.Section; import org.apache.ibatis.annotations.*; +import domain.blog.Author; +import domain.blog.Post; +import domain.blog.Section; +import org.apache.ibatis.executor.BatchResult; import org.apache.ibatis.session.RowBounds; import java.util.List; @@ -88,4 +92,8 @@ List findThreeSpecificPosts(@Param("one") int one, RowBounds rowBounds, @Param("two") int two, int three); + + @Flush + List flush(); + } diff --git a/src/test/java/org/apache/ibatis/binding/FlushTest.java b/src/test/java/org/apache/ibatis/binding/FlushTest.java new file mode 100644 index 000000000..dd4c04db7 --- /dev/null +++ b/src/test/java/org/apache/ibatis/binding/FlushTest.java @@ -0,0 +1,93 @@ +/** + * Copyright 2009-2015 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.ibatis.binding; + +import org.apache.ibatis.BaseDataTest; +import domain.blog.Author; +import domain.blog.Post; +import domain.blog.Section; +import org.apache.ibatis.executor.BatchResult; +import org.apache.ibatis.mapping.Environment; +import org.apache.ibatis.session.*; +import org.apache.ibatis.transaction.TransactionFactory; +import org.apache.ibatis.transaction.jdbc.JdbcTransactionFactory; +import org.junit.BeforeClass; +import org.junit.Test; + +import javax.sql.DataSource; +import java.util.ArrayList; +import java.util.List; + +import static org.hamcrest.core.Is.is; +import static org.junit.Assert.assertNotNull; +import static org.junit.Assert.assertThat; + +public class FlushTest { + private static SqlSessionFactory sqlSessionFactory; + + @BeforeClass + public static void setup() throws Exception { + DataSource dataSource = BaseDataTest.createBlogDataSource(); + TransactionFactory transactionFactory = new JdbcTransactionFactory(); + Environment environment = new Environment("Production", transactionFactory, dataSource); + Configuration configuration = new Configuration(environment); + configuration.setDefaultExecutorType(ExecutorType.BATCH); + configuration.getTypeAliasRegistry().registerAlias(Post.class); + configuration.getTypeAliasRegistry().registerAlias(Author.class); + configuration.addMapper(BoundAuthorMapper.class); + sqlSessionFactory = new SqlSessionFactoryBuilder().build(configuration); + } + + @Test + public void invokeFlushStatementsViaMapper() { + + SqlSession session = sqlSessionFactory.openSession(); + + try { + + BoundAuthorMapper mapper = session.getMapper(BoundAuthorMapper.class); + Author author = new Author(-1, "cbegin", "******", "cbegin@nowhere.com", "N/A", Section.NEWS); + List ids = new ArrayList(); + mapper.insertAuthor(author); + ids.add(author.getId()); + mapper.insertAuthor(author); + ids.add(author.getId()); + mapper.insertAuthor(author); + ids.add(author.getId()); + mapper.insertAuthor(author); + ids.add(author.getId()); + mapper.insertAuthor(author); + ids.add(author.getId()); + + // test + List results = mapper.flush(); + + assertThat(results.size(), is(1)); + assertThat(results.get(0).getUpdateCounts().length, is(ids.size())); + + for (int id : ids) { + Author selectedAuthor = mapper.selectAuthor(id); + assertNotNull(id + " is not found.", selectedAuthor); + } + + session.rollback(); + } finally { + session.close(); + } + + } + +} diff --git a/src/test/java/org/apache/ibatis/builder/CustomizedSettingsMapperConfig.xml b/src/test/java/org/apache/ibatis/builder/CustomizedSettingsMapperConfig.xml new file mode 100644 index 000000000..400c70096 --- /dev/null +++ b/src/test/java/org/apache/ibatis/builder/CustomizedSettingsMapperConfig.xml @@ -0,0 +1,51 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/test/java/org/apache/ibatis/builder/XmlConfigBuilderTest.java b/src/test/java/org/apache/ibatis/builder/XmlConfigBuilderTest.java index f188c1c4c..9e07f9ce8 100644 --- a/src/test/java/org/apache/ibatis/builder/XmlConfigBuilderTest.java +++ b/src/test/java/org/apache/ibatis/builder/XmlConfigBuilderTest.java @@ -15,26 +15,37 @@ */ package org.apache.ibatis.builder; -import static org.junit.Assert.assertArrayEquals; -import static org.junit.Assert.assertNotNull; -import static org.junit.Assert.assertTrue; - import java.io.InputStream; import java.io.StringReader; import java.sql.CallableStatement; import java.sql.PreparedStatement; import java.sql.ResultSet; import java.sql.SQLException; +import java.util.Arrays; +import java.util.HashSet; +import java.util.Set; import org.apache.ibatis.builder.xml.XMLConfigBuilder; +import org.apache.ibatis.executor.loader.cglib.CglibProxyFactory; +import org.apache.ibatis.executor.loader.javassist.JavassistProxyFactory; import org.apache.ibatis.io.Resources; +import org.apache.ibatis.logging.slf4j.Slf4jImpl; +import org.apache.ibatis.scripting.defaults.RawLanguageDriver; +import org.apache.ibatis.scripting.xmltags.XMLLanguageDriver; +import org.apache.ibatis.session.AutoMappingBehavior; import org.apache.ibatis.session.Configuration; +import org.apache.ibatis.session.ExecutorType; +import org.apache.ibatis.session.LocalCacheScope; import org.apache.ibatis.type.BaseTypeHandler; import org.apache.ibatis.type.JdbcType; import org.apache.ibatis.type.TypeHandler; import org.apache.ibatis.type.TypeHandlerRegistry; import org.junit.Test; +import static org.hamcrest.core.Is.*; +import static org.hamcrest.core.IsInstanceOf.*; +import static org.junit.Assert.*; + public class XmlConfigBuilderTest { @Test @@ -44,6 +55,28 @@ public void shouldSuccessfullyLoadMinimalXMLConfigFile() throws Exception { XMLConfigBuilder builder = new XMLConfigBuilder(inputStream); Configuration config = builder.parse(); assertNotNull(config); + assertThat(config.getAutoMappingBehavior(), is(AutoMappingBehavior.PARTIAL)); + assertThat(config.isCacheEnabled(), is(true)); + assertThat(config.getProxyFactory(), is(instanceOf(CglibProxyFactory.class))); + assertThat(config.isLazyLoadingEnabled(), is(false)); + assertThat(config.isAggressiveLazyLoading(), is(true)); + assertThat(config.isMultipleResultSetsEnabled(), is(true)); + assertThat(config.isUseColumnLabel(), is(true)); + assertThat(config.isUseGeneratedKeys(), is(false)); + assertThat(config.getDefaultExecutorType(), is(ExecutorType.SIMPLE)); + assertNull(config.getDefaultStatementTimeout()); + assertNull(config.getDefaultFetchSize()); + assertThat(config.isMapUnderscoreToCamelCase(), is(false)); + assertThat(config.isSafeRowBoundsEnabled(), is(false)); + assertThat(config.getLocalCacheScope(), is(LocalCacheScope.SESSION)); + assertThat(config.getJdbcTypeForNull(), is(JdbcType.OTHER)); + assertThat(config.getLazyLoadTriggerMethods(), is((Set) new HashSet(Arrays.asList("equals", "clone", "hashCode", "toString")))); + assertThat(config.isSafeResultHandlerEnabled(), is(true)); + assertThat(config.getDefaultScriptingLanuageInstance(), is(instanceOf(XMLLanguageDriver.class))); + assertThat(config.isCallSettersOnNulls(), is(false)); + assertNull(config.getLogPrefix()); + assertNull(config.getLogImpl()); + assertNull(config.getConfigurationFactory()); } enum MyEnum { @@ -102,4 +135,37 @@ public void registerJavaTypeInitializingTypeHandler() { assertTrue(typeHandler instanceof EnumOrderTypeHandler); assertArrayEquals(MyEnum.values(), ((EnumOrderTypeHandler) typeHandler).constants); } + + @Test + public void shouldSuccessfullyLoadXMLConfigFile() throws Exception { + String resource = "org/apache/ibatis/builder/CustomizedSettingsMapperConfig.xml"; + InputStream inputStream = Resources.getResourceAsStream(resource); + XMLConfigBuilder builder = new XMLConfigBuilder(inputStream); + Configuration config = builder.parse(); + + assertThat(config.getAutoMappingBehavior(), is(AutoMappingBehavior.NONE)); + assertThat(config.isCacheEnabled(), is(false)); + assertThat(config.getProxyFactory(), is(instanceOf(JavassistProxyFactory.class))); + assertThat(config.isLazyLoadingEnabled(), is(true)); + assertThat(config.isAggressiveLazyLoading(), is(false)); + assertThat(config.isMultipleResultSetsEnabled(), is(false)); + assertThat(config.isUseColumnLabel(), is(false)); + assertThat(config.isUseGeneratedKeys(), is(true)); + assertThat(config.getDefaultExecutorType(), is(ExecutorType.BATCH)); + assertThat(config.getDefaultStatementTimeout(), is(10)); + assertThat(config.getDefaultFetchSize(), is(100)); + assertThat(config.isMapUnderscoreToCamelCase(), is(true)); + assertThat(config.isSafeRowBoundsEnabled(), is(true)); + assertThat(config.getLocalCacheScope(), is(LocalCacheScope.STATEMENT)); + assertThat(config.getJdbcTypeForNull(), is(JdbcType.NULL)); + assertThat(config.getLazyLoadTriggerMethods(), is((Set) new HashSet(Arrays.asList("equals", "clone", "hashCode", "toString", "xxx")))); + assertThat(config.isSafeResultHandlerEnabled(), is(false)); + assertThat(config.getDefaultScriptingLanuageInstance(), is(instanceOf(RawLanguageDriver.class))); + assertThat(config.isCallSettersOnNulls(), is(true)); + assertThat(config.getLogPrefix(), is("mybatis_")); + assertThat(config.getLogImpl().getName(), is(Slf4jImpl.class.getName())); + assertThat(config.getConfigurationFactory().getName(), is(String.class.getName())); + + } + } diff --git a/src/test/java/org/apache/ibatis/builder/xml/dynamic/DynamicSqlSourceTest.java b/src/test/java/org/apache/ibatis/builder/xml/dynamic/DynamicSqlSourceTest.java index e675764e5..48456aefb 100644 --- a/src/test/java/org/apache/ibatis/builder/xml/dynamic/DynamicSqlSourceTest.java +++ b/src/test/java/org/apache/ibatis/builder/xml/dynamic/DynamicSqlSourceTest.java @@ -317,6 +317,20 @@ public void shouldIterateOnceForEachItemInCollection() throws Exception { assertEquals("__frch_item_2", boundSql.getParameterMappings().get(2).getProperty()); } + @Test + public void shouldSkipForEachWhenCollectionIsEmpty() throws Exception { + final HashMap parameterObject = new HashMap() {{ + put("array", new Integer[] {}); + }}; + final String expected = "SELECT * FROM BLOG"; + DynamicSqlSource source = createDynamicSqlSource(new TextSqlNode("SELECT * FROM BLOG"), + new ForEachSqlNode(new Configuration(), mixedContents( + new TextSqlNode("#{item}")), "array", null, "item", "WHERE id in (", ")", ",")); + BoundSql boundSql = source.getBoundSql(parameterObject); + assertEquals(expected, boundSql.getSql()); + assertEquals(0, boundSql.getParameterMappings().size()); + } + @Test public void shouldPerformStrictMatchOnForEachVariableSubstitution() throws Exception { final Map param = new HashMap(); diff --git a/src/test/java/org/apache/ibatis/executor/BaseExecutorTest.java b/src/test/java/org/apache/ibatis/executor/BaseExecutorTest.java index 33e82971b..9c491e08f 100644 --- a/src/test/java/org/apache/ibatis/executor/BaseExecutorTest.java +++ b/src/test/java/org/apache/ibatis/executor/BaseExecutorTest.java @@ -58,6 +58,7 @@ public BaseExecutorTest() { config.setMultipleResultSetsEnabled(true); config.setUseColumnLabel(true); config.setDefaultStatementTimeout(5000); + config.setDefaultFetchSize(100); } @Test diff --git a/src/test/java/org/apache/ibatis/executor/ExecutorTestHelper.java b/src/test/java/org/apache/ibatis/executor/ExecutorTestHelper.java index b812fdc7c..0b596cac8 100644 --- a/src/test/java/org/apache/ibatis/executor/ExecutorTestHelper.java +++ b/src/test/java/org/apache/ibatis/executor/ExecutorTestHelper.java @@ -198,7 +198,7 @@ public static MappedStatement prepareSelectAllAuthorsAutoMappedStatement(final C } }).build()); } - }).build(); + }).fetchSize(1000).build(); } public static MappedStatement prepareSelectOneAuthorMappedStatementWithConstructorResults(final Configuration config) { diff --git a/src/test/java/org/apache/ibatis/parsing/GenericTokenParserTest.java b/src/test/java/org/apache/ibatis/parsing/GenericTokenParserTest.java index 9dcf1c397..67b928c5d 100644 --- a/src/test/java/org/apache/ibatis/parsing/GenericTokenParserTest.java +++ b/src/test/java/org/apache/ibatis/parsing/GenericTokenParserTest.java @@ -73,6 +73,8 @@ public void shallNotInterpolateSkippedVaiables() { assertEquals("${skipped} variable", parser.parse("\\${skipped} variable")); assertEquals("This is a ${skipped} variable", parser.parse("This is a \\${skipped} variable")); + assertEquals("null ${skipped} variable", parser.parse("${skipped} \\${skipped} variable")); + assertEquals("The null is ${skipped} variable", parser.parse("The ${skipped} is \\${skipped} variable")); } @Test(timeout = 1000) diff --git a/src/test/java/org/apache/ibatis/submitted/call_setters_on_nulls/CallSettersOnNullsTest.java b/src/test/java/org/apache/ibatis/submitted/call_setters_on_nulls/CallSettersOnNullsTest.java index fd2b87a26..8cf627c48 100644 --- a/src/test/java/org/apache/ibatis/submitted/call_setters_on_nulls/CallSettersOnNullsTest.java +++ b/src/test/java/org/apache/ibatis/submitted/call_setters_on_nulls/CallSettersOnNullsTest.java @@ -107,7 +107,12 @@ public void shouldCallNullOnMapForSingleColumnWithResultMap() { try { Mapper mapper = sqlSession.getMapper(Mapper.class); List> oneColumns = mapper.getNameOnlyMapped(); - Assert.assertNotNull(oneColumns.get(1)); +// Assert.assertNotNull(oneColumns.get(1)); + // TEST changed after fix for #307 + // When callSetterOnNull is true, setters are called with null values + // but if all the values for an object are null + // the object itself should be null (same as default behaviour) + Assert.assertNull(oneColumns.get(1)); } finally { sqlSession.close(); } diff --git a/src/test/java/org/apache/ibatis/submitted/dynsql/DynSqlMapper.java b/src/test/java/org/apache/ibatis/submitted/dynsql/DynSqlMapper.java new file mode 100644 index 000000000..6e1e7f5b4 --- /dev/null +++ b/src/test/java/org/apache/ibatis/submitted/dynsql/DynSqlMapper.java @@ -0,0 +1,23 @@ +/*- + * Copyright 2009-2015 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package org.apache.ibatis.submitted.dynsql; + +import org.apache.ibatis.annotations.Param; + +public interface DynSqlMapper { + String selectDescription(@Param("p") String p); +} diff --git a/src/test/java/org/apache/ibatis/submitted/dynsql/DynSqlMapper.xml b/src/test/java/org/apache/ibatis/submitted/dynsql/DynSqlMapper.xml new file mode 100644 index 000000000..825558aca --- /dev/null +++ b/src/test/java/org/apache/ibatis/submitted/dynsql/DynSqlMapper.xml @@ -0,0 +1,33 @@ + + + + + + + + \ No newline at end of file diff --git a/src/test/java/org/apache/ibatis/submitted/dynsql/DynSqlTest.java b/src/test/java/org/apache/ibatis/submitted/dynsql/DynSqlTest.java index 05f7a8e89..37d052b37 100644 --- a/src/test/java/org/apache/ibatis/submitted/dynsql/DynSqlTest.java +++ b/src/test/java/org/apache/ibatis/submitted/dynsql/DynSqlTest.java @@ -158,4 +158,16 @@ public void testOgnlStaticMethodCall() { } } + @Test + public void testBindNull() { + SqlSession sqlSession = sqlSessionFactory.openSession(); + try { + DynSqlMapper mapper = sqlSession.getMapper(DynSqlMapper.class); + String description = mapper.selectDescription(null); + assertEquals("Pebbles", description); + } finally { + sqlSession.close(); + } + } + } diff --git a/src/test/java/org/apache/ibatis/submitted/dynsql/MapperConfig.xml b/src/test/java/org/apache/ibatis/submitted/dynsql/MapperConfig.xml index 018e5edfa..ce2fd8330 100644 --- a/src/test/java/org/apache/ibatis/submitted/dynsql/MapperConfig.xml +++ b/src/test/java/org/apache/ibatis/submitted/dynsql/MapperConfig.xml @@ -38,6 +38,7 @@ + diff --git a/src/test/java/org/apache/ibatis/submitted/foreach/ForEachTest.java b/src/test/java/org/apache/ibatis/submitted/foreach/ForEachTest.java index 4cda2bca7..5131c23a9 100644 --- a/src/test/java/org/apache/ibatis/submitted/foreach/ForEachTest.java +++ b/src/test/java/org/apache/ibatis/submitted/foreach/ForEachTest.java @@ -107,4 +107,21 @@ public void shouldHandleMoreComplexNullItem() { } } + @Test + public void nullItemInContext() { + SqlSession sqlSession = sqlSessionFactory.openSession(); + try { + Mapper mapper = sqlSession.getMapper(Mapper.class); + User user1 = new User(); + user1.setId(3); + List users = new ArrayList(); + users.add(user1); + users.add(null); + String name = mapper.selectWithNullItemCheck(users); + Assert.assertEquals("User3", name); + } finally { + sqlSession.close(); + } + } + } diff --git a/src/test/java/org/apache/ibatis/submitted/foreach/Mapper.java b/src/test/java/org/apache/ibatis/submitted/foreach/Mapper.java index ce7105b5a..4d2f789d9 100644 --- a/src/test/java/org/apache/ibatis/submitted/foreach/Mapper.java +++ b/src/test/java/org/apache/ibatis/submitted/foreach/Mapper.java @@ -25,4 +25,6 @@ public interface Mapper { int countByBestFriend(List users); + String selectWithNullItemCheck(List users); + } diff --git a/src/test/java/org/apache/ibatis/submitted/foreach/Mapper.xml b/src/test/java/org/apache/ibatis/submitted/foreach/Mapper.xml index 79eca87b8..0404b85ff 100644 --- a/src/test/java/org/apache/ibatis/submitted/foreach/Mapper.xml +++ b/src/test/java/org/apache/ibatis/submitted/foreach/Mapper.xml @@ -50,4 +50,16 @@ + + diff --git a/src/test/java/org/apache/ibatis/submitted/multipleresultsetswithassociation/CreateDB1.sql b/src/test/java/org/apache/ibatis/submitted/multipleresultsetswithassociation/CreateDB1.sql new file mode 100644 index 000000000..64b23373a --- /dev/null +++ b/src/test/java/org/apache/ibatis/submitted/multipleresultsetswithassociation/CreateDB1.sql @@ -0,0 +1,33 @@ +-- Copyright 2009-2012 the original author or authors. +-- +-- Licensed under the Apache License, Version 2.0 (the "License"); +-- you may not use this file except in compliance with the License. +-- You may obtain a copy of the License at +-- +-- http://www.apache.org/licenses/LICENSE-2.0 +-- +-- Unless required by applicable law or agreed to in writing, software +-- distributed under the License is distributed on an "AS IS" BASIS, +-- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +-- See the License for the specific language governing permissions and +-- limitations under the License. + + DROP PROCEDURE GetOrderDetailsAndHeaders IF EXISTS; + DROP TABLE order_detail IF EXISTS; + DROP TABLE order_header IF EXISTS; + + CREATE TABLE order_detail + ( + order_id integer NOT NULL, + line_number integer NOT NULL, + quantity integer NOT NULL, + item_description varchar(50) NOT NULL, + PRIMARY KEY (order_id, line_number) + ); + + CREATE TABLE order_header + ( + order_id integer NOT NULL, + cust_name varchar(50) NOT NULL, + PRIMARY KEY (order_id) + ); diff --git a/src/test/java/org/apache/ibatis/submitted/multipleresultsetswithassociation/CreateDB2.sql b/src/test/java/org/apache/ibatis/submitted/multipleresultsetswithassociation/CreateDB2.sql new file mode 100644 index 000000000..63336300f --- /dev/null +++ b/src/test/java/org/apache/ibatis/submitted/multipleresultsetswithassociation/CreateDB2.sql @@ -0,0 +1,30 @@ +-- Copyright 2009-2012 the original author or authors. +-- +-- Licensed under the Apache License, Version 2.0 (the "License"); +-- you may not use this file except in compliance with the License. +-- You may obtain a copy of the License at +-- +-- http://www.apache.org/licenses/LICENSE-2.0 +-- +-- Unless required by applicable law or agreed to in writing, software +-- distributed under the License is distributed on an "AS IS" BASIS, +-- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +-- See the License for the specific language governing permissions and +-- limitations under the License. + + CREATE PROCEDURE GetOrderDetailsAndHeaders() + READS SQL DATA + DYNAMIC RESULT SETS 1 + BEGIN ATOMIC + + DECLARE result1 CURSOR FOR + SELECT * FROM order_detail + FOR READ ONLY ; + + DECLARE result2 CURSOR FOR + SELECT * FROM order_header + FOR READ ONLY ; + + OPEN result1 ; + OPEN result2 ; + END; diff --git a/src/test/java/org/apache/ibatis/submitted/multipleresultsetswithassociation/CreateDB3.sql b/src/test/java/org/apache/ibatis/submitted/multipleresultsetswithassociation/CreateDB3.sql new file mode 100644 index 000000000..c2fc14d92 --- /dev/null +++ b/src/test/java/org/apache/ibatis/submitted/multipleresultsetswithassociation/CreateDB3.sql @@ -0,0 +1,33 @@ +-- Copyright 2009-2012 the original author or authors. +-- +-- Licensed under the Apache License, Version 2.0 (the "License"); +-- you may not use this file except in compliance with the License. +-- You may obtain a copy of the License at +-- +-- http://www.apache.org/licenses/LICENSE-2.0 +-- +-- Unless required by applicable law or agreed to in writing, software +-- distributed under the License is distributed on an "AS IS" BASIS, +-- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +-- See the License for the specific language governing permissions and +-- limitations under the License. + + INSERT INTO order_header(order_id, cust_name) + VALUES (1, 'Fred'); + INSERT INTO order_header(order_id, cust_name) + VALUES (2, 'Barney'); + INSERT INTO order_header(order_id, cust_name) + VALUES (3, 'Homer'); + + INSERT INTO order_detail(order_id, line_number, quantity, item_description) + VALUES (1, 1, 1, 'Pen'); + INSERT INTO order_detail(order_id, line_number, quantity, item_description) + VALUES (1, 2, 3, 'Pencil'); + INSERT INTO order_detail(order_id, line_number, quantity, item_description) + VALUES (1, 3, 2, 'Notepad'); + INSERT INTO order_detail(order_id, line_number, quantity, item_description) + VALUES (2, 1, 1, 'Compass'); + INSERT INTO order_detail(order_id, line_number, quantity, item_description) + VALUES (2, 2, 1, 'Protractor'); + INSERT INTO order_detail(order_id, line_number, quantity, item_description) + VALUES (2, 3, 2, 'Pencil'); diff --git a/src/test/java/org/apache/ibatis/submitted/multipleresultsetswithassociation/Mapper.java b/src/test/java/org/apache/ibatis/submitted/multipleresultsetswithassociation/Mapper.java new file mode 100644 index 000000000..216657c61 --- /dev/null +++ b/src/test/java/org/apache/ibatis/submitted/multipleresultsetswithassociation/Mapper.java @@ -0,0 +1,24 @@ +/* + * Copyright 2009-2012 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.ibatis.submitted.multipleresultsetswithassociation; + +import java.util.List; + +public interface Mapper { + + List getOrderDetailsWithHeaders(); + +} \ No newline at end of file diff --git a/src/test/java/org/apache/ibatis/submitted/multipleresultsetswithassociation/Mapper.xml b/src/test/java/org/apache/ibatis/submitted/multipleresultsetswithassociation/Mapper.xml new file mode 100644 index 000000000..87b801b0a --- /dev/null +++ b/src/test/java/org/apache/ibatis/submitted/multipleresultsetswithassociation/Mapper.xml @@ -0,0 +1,38 @@ + + + + + + + + + + + + + + + + + + + diff --git a/src/test/java/org/apache/ibatis/submitted/multipleresultsetswithassociation/MultipleResultSetTest.java b/src/test/java/org/apache/ibatis/submitted/multipleresultsetswithassociation/MultipleResultSetTest.java new file mode 100644 index 000000000..425364e05 --- /dev/null +++ b/src/test/java/org/apache/ibatis/submitted/multipleresultsetswithassociation/MultipleResultSetTest.java @@ -0,0 +1,95 @@ +/* + * Copyright 2009-2012 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.ibatis.submitted.multipleresultsetswithassociation; + +import java.io.IOException; +import java.io.Reader; +import java.sql.Connection; +import java.util.List; + +import org.apache.ibatis.io.Resources; +import org.apache.ibatis.jdbc.ScriptRunner; +import org.apache.ibatis.session.SqlSession; +import org.apache.ibatis.session.SqlSessionFactory; +import org.apache.ibatis.session.SqlSessionFactoryBuilder; +import org.junit.Assert; +import org.junit.BeforeClass; +import org.junit.Test; + +/* + * This class contains tests for multiple result sets with an association mapping. + * This test is based on the org.apache.ibatis.submitted.multiple_resultsets test. + * + */ +public class MultipleResultSetTest { + + private static SqlSessionFactory sqlSessionFactory; + + @BeforeClass + public static void setUp() throws Exception { + Reader reader = Resources.getResourceAsReader("org/apache/ibatis/submitted/multipleresultsetswithassociation/mybatis-config.xml"); + sqlSessionFactory = new SqlSessionFactoryBuilder().build(reader); + reader.close(); + + // populate in-memory database + // Could not get the table creation, procedure creation, and data population to work from the same script. + // Once it was in three scripts, all seemed well. + SqlSession session = sqlSessionFactory.openSession(); + Connection conn = session.getConnection(); + reader = Resources.getResourceAsReader("org/apache/ibatis/submitted/multipleresultsetswithassociation/CreateDB1.sql"); + runReaderScript(conn, session, reader); + reader.close(); + reader = Resources.getResourceAsReader("org/apache/ibatis/submitted/multipleresultsetswithassociation/CreateDB2.sql"); + runReaderScript(conn, session, reader); + reader.close(); + reader = Resources.getResourceAsReader("org/apache/ibatis/submitted/multipleresultsetswithassociation/CreateDB3.sql"); + runReaderScript(conn, session, reader); + reader.close(); + session.close(); + } + + private static void runReaderScript(Connection conn, SqlSession session, Reader reader) throws Exception { + ScriptRunner runner = new ScriptRunner(conn); + runner.setLogWriter(null); + runner.setSendFullScript(true); + runner.setAutoCommit(true); + runner.setStopOnError(false); + runner.runScript(reader); + } + + @Test + public void shouldGetOrderDetailsEachHavingAnOrderHeader() throws IOException { + SqlSession sqlSession = sqlSessionFactory.openSession(); + try { + Mapper mapper = sqlSession.getMapper(Mapper.class); + List orderDetails = mapper.getOrderDetailsWithHeaders(); + + // There are six order detail records in the database + // As long as the data does not change this should be successful + Assert.assertEquals(6, orderDetails.size()); + + // Each order detail should have a corresponding OrderHeader + // Only 2 of 6 orderDetails have orderHeaders + for(OrderDetail orderDetail : orderDetails){ + Assert.assertNotNull(orderDetail.getOrderHeader()); + } + + } finally { + sqlSession.close(); + } + } + +} diff --git a/src/test/java/org/apache/ibatis/submitted/multipleresultsetswithassociation/OrderDetail.java b/src/test/java/org/apache/ibatis/submitted/multipleresultsetswithassociation/OrderDetail.java new file mode 100644 index 000000000..2f99e5ad5 --- /dev/null +++ b/src/test/java/org/apache/ibatis/submitted/multipleresultsetswithassociation/OrderDetail.java @@ -0,0 +1,66 @@ +/* + * Copyright 2009-2012 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.ibatis.submitted.multipleresultsetswithassociation; + +public class OrderDetail { + + private int orderId; + private int lineNumber; + private int quantity; + private String itemDescription; + + private OrderHeader orderHeader; + + public int getOrderId() { + return orderId; + } + + public void setOrderId(int orderId) { + this.orderId = orderId; + } + + public int getLineNumber() { + return lineNumber; + } + + public void setLineNumber(int lineNumber) { + this.lineNumber = lineNumber; + } + + public int getQuantity() { + return quantity; + } + + public void setQuantity(int quantity) { + this.quantity = quantity; + } + + public String getItemDescription() { + return itemDescription; + } + + public void setItemDescription(String itemDescription) { + this.itemDescription = itemDescription; + } + + public OrderHeader getOrderHeader() { + return orderHeader; + } + + public void setOrderHeader(OrderHeader orderHeader) { + this.orderHeader = orderHeader; + } +} diff --git a/src/test/java/org/apache/ibatis/submitted/multipleresultsetswithassociation/OrderHeader.java b/src/test/java/org/apache/ibatis/submitted/multipleresultsetswithassociation/OrderHeader.java new file mode 100644 index 000000000..1726625d2 --- /dev/null +++ b/src/test/java/org/apache/ibatis/submitted/multipleresultsetswithassociation/OrderHeader.java @@ -0,0 +1,39 @@ +/* + * Copyright 2009-2012 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.ibatis.submitted.multipleresultsetswithassociation; + +public class OrderHeader { + + private int orderId; + private String custName; + + public int getOrderId() { + return orderId; + } + + public void setOrderId(int orderId) { + this.orderId = orderId; + } + + public String getCustName() { + return custName; + } + + public void setCustName(String custName) { + this.custName = custName; + } + +} diff --git a/src/test/java/org/apache/ibatis/submitted/multipleresultsetswithassociation/mybatis-config.xml b/src/test/java/org/apache/ibatis/submitted/multipleresultsetswithassociation/mybatis-config.xml new file mode 100644 index 000000000..02edede5b --- /dev/null +++ b/src/test/java/org/apache/ibatis/submitted/multipleresultsetswithassociation/mybatis-config.xml @@ -0,0 +1,45 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/test/java/org/apache/ibatis/submitted/nestedresulthandler_association/Account.java b/src/test/java/org/apache/ibatis/submitted/nestedresulthandler_association/Account.java new file mode 100644 index 000000000..356a1bb62 --- /dev/null +++ b/src/test/java/org/apache/ibatis/submitted/nestedresulthandler_association/Account.java @@ -0,0 +1,61 @@ +/*- + * Copyright 2009-2014 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package org.apache.ibatis.submitted.nestedresulthandler_association; + +import java.util.Date; + +public class Account { + private String accountUuid; + + private String accountName; + + private Date birthDate; + + private AccountAddress address; + + public String getAccountUuid() { + return accountUuid; + } + + public void setAccountUuid(String accountUuid) { + this.accountUuid = accountUuid; + } + + public String getAccountName() { + return accountName; + } + + public void setAccountName(String accountName) { + this.accountName = accountName; + } + + public Date getBirthDate() { + return birthDate; + } + + public void setBirthDate(Date birthDate) { + this.birthDate = birthDate; + } + + public AccountAddress getAddress() { + return address; + } + + public void setAddress(AccountAddress address) { + this.address = address; + } +} diff --git a/src/test/java/org/apache/ibatis/submitted/nestedresulthandler_association/AccountAddress.java b/src/test/java/org/apache/ibatis/submitted/nestedresulthandler_association/AccountAddress.java new file mode 100644 index 000000000..2e8b9c8ba --- /dev/null +++ b/src/test/java/org/apache/ibatis/submitted/nestedresulthandler_association/AccountAddress.java @@ -0,0 +1,49 @@ +/*- + * Copyright 2009-2014 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package org.apache.ibatis.submitted.nestedresulthandler_association; + +public class AccountAddress { + private String accountUuid; + + private String zipCode; + + private String address; + + public String getAccountUuid() { + return accountUuid; + } + + public void setAccountUuid(String accountUuid) { + this.accountUuid = accountUuid; + } + + public String getZipCode() { + return zipCode; + } + + public void setZipCode(String zipCode) { + this.zipCode = zipCode; + } + + public String getAddress() { + return address; + } + + public void setAddress(String address) { + this.address = address; + } +} diff --git a/src/test/java/org/apache/ibatis/submitted/nestedresulthandler_association/AccountRepository.xml b/src/test/java/org/apache/ibatis/submitted/nestedresulthandler_association/AccountRepository.xml new file mode 100644 index 000000000..be854417a --- /dev/null +++ b/src/test/java/org/apache/ibatis/submitted/nestedresulthandler_association/AccountRepository.xml @@ -0,0 +1,48 @@ + + + + + + + + + + + + + + + + diff --git a/src/test/java/org/apache/ibatis/submitted/nestedresulthandler_association/CreateDB.sql b/src/test/java/org/apache/ibatis/submitted/nestedresulthandler_association/CreateDB.sql new file mode 100644 index 000000000..394f1f2aa --- /dev/null +++ b/src/test/java/org/apache/ibatis/submitted/nestedresulthandler_association/CreateDB.sql @@ -0,0 +1,37 @@ +-- +-- Copyright 2009-2014 the original author or authors. +-- +-- Licensed under the Apache License, Version 2.0 (the "License"); +-- you may not use this file except in compliance with the License. +-- You may obtain a copy of the License at +-- +-- http://www.apache.org/licenses/LICENSE-2.0 +-- +-- Unless required by applicable law or agreed to in writing, software +-- distributed under the License is distributed on an "AS IS" BASIS, +-- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +-- See the License for the specific language governing permissions and +-- limitations under the License. +-- + +DROP TABLE t_account_address if exists; +DROP TABLE t_account if exists; +CREATE TABLE t_account( + account_uuid CHAR(36) PRIMARY KEY + ,account_name VARCHAR(256) + ,birth_date DATETIME +); +CREATE TABLE t_account_address( + account_uuid CHAR(36) PRIMARY KEY + ,zip_code CHAR(7) + ,address VARCHAR(256) +); + +INSERT INTO t_account (account_uuid,account_name,birth_date) VALUES ('4d3c8bdd-5379-4aeb-bc56-fcb01eb7cc01', 'Bob1', '2014-01-01 00:00:00.000'); +INSERT INTO t_account (account_uuid,account_name,birth_date) VALUES ('4d3c8bdd-5379-4aeb-bc56-fcb01eb7cc02', 'Bob2', '2014-01-02 00:00:00.000'); +INSERT INTO t_account (account_uuid,account_name,birth_date) VALUES ('4d3c8bdd-5379-4aeb-bc56-fcb01eb7cc03', 'Bob3', '2014-01-03 00:00:00.000'); +INSERT INTO t_account (account_uuid,account_name,birth_date) VALUES ('4d3c8bdd-5379-4aeb-bc56-fcb01eb7cc04', 'Bob4', '2014-01-04 00:00:00.000'); +INSERT INTO t_account (account_uuid,account_name,birth_date) VALUES ('4d3c8bdd-5379-4aeb-bc56-fcb01eb7cc05', 'Bob5', '2014-01-05 00:00:00.000'); +INSERT INTO t_account (account_uuid,account_name,birth_date) VALUES ('4d3c8bdd-5379-4aeb-bc56-fcb01eb7cc11', 'Mark1', '2014-02-01 00:00:00.000'); + +INSERT INTO t_account_address (account_uuid,zip_code,address) VALUES ('4d3c8bdd-5379-4aeb-bc56-fcb01eb7cc02', '1710051', 'Tokyo Toshimaku Nagasaki'); diff --git a/src/test/java/org/apache/ibatis/submitted/nestedresulthandler_association/NestedResultHandlerAssociationTest.java b/src/test/java/org/apache/ibatis/submitted/nestedresulthandler_association/NestedResultHandlerAssociationTest.java new file mode 100644 index 000000000..328011a99 --- /dev/null +++ b/src/test/java/org/apache/ibatis/submitted/nestedresulthandler_association/NestedResultHandlerAssociationTest.java @@ -0,0 +1,106 @@ +/* + * Copyright 2009-2014 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.ibatis.submitted.nestedresulthandler_association; + +import static org.junit.Assert.*; + +import java.io.Reader; +import java.sql.Connection; +import java.text.SimpleDateFormat; +import java.util.ArrayList; +import java.util.Date; +import java.util.List; + +import org.apache.ibatis.io.Resources; +import org.apache.ibatis.jdbc.ScriptRunner; +import org.apache.ibatis.session.ResultContext; +import org.apache.ibatis.session.ResultHandler; +import org.apache.ibatis.session.RowBounds; +import org.apache.ibatis.session.SqlSession; +import org.apache.ibatis.session.SqlSessionFactory; +import org.apache.ibatis.session.SqlSessionFactoryBuilder; +import org.junit.BeforeClass; +import org.junit.Test; + +public class NestedResultHandlerAssociationTest { + + private static SqlSessionFactory sqlSessionFactory; + + @BeforeClass + public static void setUp() throws Exception { + // create an SqlSessionFactory + Reader reader = Resources.getResourceAsReader("org/apache/ibatis/submitted/nestedresulthandler_association/mybatis-config.xml"); + sqlSessionFactory = new SqlSessionFactoryBuilder().build(reader); + reader.close(); + + // populate in-memory database + SqlSession session = sqlSessionFactory.openSession(); + Connection conn = session.getConnection(); + reader = Resources.getResourceAsReader("org/apache/ibatis/submitted/nestedresulthandler_association/CreateDB.sql"); + ScriptRunner runner = new ScriptRunner(conn); + runner.setLogWriter(null); + runner.runScript(reader); + reader.close(); + session.close(); + } + + @Test + public void shouldHandleRowBounds() throws Exception { + SqlSession sqlSession = sqlSessionFactory.openSession(); + final SimpleDateFormat fmt = new SimpleDateFormat("yyyy-MM-dd"); + Date targetMonth = fmt.parse("2014-01-01"); + final List accounts = new ArrayList(); + try { + sqlSession.select("collectPageByBirthMonth", targetMonth, new RowBounds(1, 2), new ResultHandler() { + @Override + public void handleResult(ResultContext context) { + Account account = (Account) context.getResultObject(); + accounts.add(account); + } + }); + } finally { + sqlSession.close(); + } + assertEquals(2, accounts.size()); + assertEquals("Bob2", accounts.get(0).getAccountName()); + assertEquals("Bob3", accounts.get(1).getAccountName()); + } + + @Test + public void shouldHandleStop() throws Exception { + SqlSession sqlSession = sqlSessionFactory.openSession(); + final SimpleDateFormat fmt = new SimpleDateFormat("yyyy-MM-dd"); + final List accounts = new ArrayList(); + try { + Date targetMonth = fmt.parse("2014-01-01"); + sqlSession.select("collectPageByBirthMonth", targetMonth, new ResultHandler() { + @Override + public void handleResult(ResultContext context) { + Account account = (Account) context.getResultObject(); + accounts.add(account); + if (accounts.size() > 1) + context.stop(); + } + }); + } finally { + sqlSession.close(); + } + assertEquals(2, accounts.size()); + assertEquals("Bob1", accounts.get(0).getAccountName()); + assertEquals("Bob2", accounts.get(1).getAccountName()); + } + +} diff --git a/src/test/java/org/apache/ibatis/submitted/nestedresulthandler_association/mybatis-config.xml b/src/test/java/org/apache/ibatis/submitted/nestedresulthandler_association/mybatis-config.xml new file mode 100644 index 000000000..a2f5a8b78 --- /dev/null +++ b/src/test/java/org/apache/ibatis/submitted/nestedresulthandler_association/mybatis-config.xml @@ -0,0 +1,40 @@ + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/test/java/org/apache/ibatis/submitted/nestedresulthandler_multiple_association/Binome.java b/src/test/java/org/apache/ibatis/submitted/nestedresulthandler_multiple_association/Binome.java new file mode 100644 index 000000000..9ee6b6102 --- /dev/null +++ b/src/test/java/org/apache/ibatis/submitted/nestedresulthandler_multiple_association/Binome.java @@ -0,0 +1,66 @@ +/* + * Copyright 2009-2014 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.ibatis.submitted.nestedresulthandler_multiple_association; + +public class Binome { + private T one; + private U two; + + public Binome() { + } + + public Binome(final T one, final U two) { + this.one = one; + this.two = two; + } + + public T getOne() { + return one; + } + + public void setOne(T one) { + this.one = one; + } + + public U getTwo() { + return two; + } + + public void setTwo(U two) { + this.two = two; + } + + @Override + public int hashCode() { + return (one != null ? one.hashCode() : 0) + + (two != null ? two.hashCode() : 0); + } + + @Override + public boolean equals(final Object obj) { + if (obj instanceof Binome) { + Binome bin = (Binome) obj; + return one != null && one.equals(bin.getOne()) && two != null + && two.equals(bin.getTwo()); + } + return super.equals(obj); + } + + @Override + public String toString() { + return "Binome [one=" + one + ", two=" + two + "]"; + } +} diff --git a/src/test/java/org/apache/ibatis/submitted/nestedresulthandler_multiple_association/ChildBean.java b/src/test/java/org/apache/ibatis/submitted/nestedresulthandler_multiple_association/ChildBean.java new file mode 100644 index 000000000..04d1ded6e --- /dev/null +++ b/src/test/java/org/apache/ibatis/submitted/nestedresulthandler_multiple_association/ChildBean.java @@ -0,0 +1,42 @@ +/* + * Copyright 2009-2014 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.ibatis.submitted.nestedresulthandler_multiple_association; + +public class ChildBean { + private Integer id; + private String value; + + public Integer getId() { + return id; + } + + public void setId(Integer id) { + this.id = id; + } + + public String getValue() { + return value; + } + + public void setValue(String value) { + this.value = value; + } + + @Override + public String toString() { + return "ChildBean [id=" + id + ", value=" + value + "]"; + } +} diff --git a/src/test/java/org/apache/ibatis/submitted/nestedresulthandler_multiple_association/CreateDB.sql b/src/test/java/org/apache/ibatis/submitted/nestedresulthandler_multiple_association/CreateDB.sql new file mode 100644 index 000000000..029942543 --- /dev/null +++ b/src/test/java/org/apache/ibatis/submitted/nestedresulthandler_multiple_association/CreateDB.sql @@ -0,0 +1,45 @@ +-- +-- Copyright 2009-2014 the original author or authors. +-- +-- Licensed under the Apache License, Version 2.0 (the "License"); +-- you may not use this file except in compliance with the License. +-- You may obtain a copy of the License at +-- +-- http://www.apache.org/licenses/LICENSE-2.0 +-- +-- Unless required by applicable law or agreed to in writing, software +-- distributed under the License is distributed on an "AS IS" BASIS, +-- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +-- See the License for the specific language governing permissions and +-- limitations under the License. +-- + +DROP TABLE parent if exists; +DROP TABLE child if exists; +create table parent( + id integer, + value varchar(20) +); + +create table child( + id integer, + value varchar(20) +); + +create table parent_child( + idparent integer, + idchild_from integer, + idchild_to integer +); + +insert into parent (id, value) values (1, 'parent1'); +insert into parent (id, value) values (2, 'parent2'); + +insert into child (id, value) values (1, 'child1'); +insert into child (id, value) values (2, 'child2'); +insert into child (id, value) values (3, 'child3'); +insert into child (id, value) values (4, 'child4'); + +insert into parent_child (idparent, idchild_from, idchild_to) values (1, 1, 2); +insert into parent_child (idparent, idchild_from, idchild_to) values (2, 2, 3); +insert into parent_child (idparent, idchild_from, idchild_to) values (2, 1, 2); \ No newline at end of file diff --git a/src/test/java/org/apache/ibatis/submitted/nestedresulthandler_multiple_association/NestedResultHandlerMultipleAssociationTest.java b/src/test/java/org/apache/ibatis/submitted/nestedresulthandler_multiple_association/NestedResultHandlerMultipleAssociationTest.java new file mode 100644 index 000000000..830f33dbc --- /dev/null +++ b/src/test/java/org/apache/ibatis/submitted/nestedresulthandler_multiple_association/NestedResultHandlerMultipleAssociationTest.java @@ -0,0 +1,92 @@ +/* + * Copyright 2009-2014 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.ibatis.submitted.nestedresulthandler_multiple_association; + +import java.io.Reader; +import java.sql.Connection; +import java.util.List; + +import org.apache.ibatis.io.Resources; +import org.apache.ibatis.jdbc.ScriptRunner; +import org.apache.ibatis.session.SqlSession; +import org.apache.ibatis.session.SqlSessionFactory; +import org.apache.ibatis.session.SqlSessionFactoryBuilder; +import org.junit.Assert; +import org.junit.BeforeClass; +import org.junit.Test; + +public class NestedResultHandlerMultipleAssociationTest { + + private static SqlSessionFactory sqlSessionFactory; + + @BeforeClass + public static void setUp() throws Exception { + // create an SqlSessionFactory + Reader reader = Resources + .getResourceAsReader("org/apache/ibatis/submitted/nestedresulthandler_multiple_association/mybatis-config.xml"); + sqlSessionFactory = new SqlSessionFactoryBuilder().build(reader); + reader.close(); + + // populate in-memory database + SqlSession session = sqlSessionFactory.openSession(); + Connection conn = session.getConnection(); + reader = Resources + .getResourceAsReader("org/apache/ibatis/submitted/nestedresulthandler_multiple_association/CreateDB.sql"); + ScriptRunner runner = new ScriptRunner(conn); + runner.setLogWriter(null); + runner.runScript(reader); + reader.close(); + session.close(); + } + + @Test + public void failure() throws Exception { + SqlSession sqlSession = sqlSessionFactory.openSession(); + + // Parents have child going from somewhere to somewhere, they are stored in + // a Binome object + // In this test we have 2 parents: + // Parent1 is going from Child1 to Child2 + // Parent2 is going from Child2 to Child3 and from Child1 to Child2 + // You'll see a NULL entry in the list instead of the Binome Child1/Child2 + List list = sqlSession.selectList("selectParentBeans"); + for (ParentBean pb : list) { + for (Binome childs : pb.getChilds()) { + Assert.assertNotNull(childs); + Assert.assertNotNull(childs.getOne()); + Assert.assertNotNull(childs.getTwo()); + } + } + + sqlSession.close(); + } + + @Test + public void success() throws Exception { + SqlSession sqlSession = sqlSessionFactory.openSession(); + + ParentBean parent = sqlSession.selectOne("selectParentBeanById", 2); + + // If you only select the Parent2 it works + for (Binome childs : parent.getChilds()) { + Assert.assertNotNull(childs); + Assert.assertNotNull(childs.getOne()); + Assert.assertNotNull(childs.getTwo()); + } + sqlSession.close(); + } + +} diff --git a/src/test/java/org/apache/ibatis/submitted/nestedresulthandler_multiple_association/ParentBean.java b/src/test/java/org/apache/ibatis/submitted/nestedresulthandler_multiple_association/ParentBean.java new file mode 100644 index 000000000..327626faa --- /dev/null +++ b/src/test/java/org/apache/ibatis/submitted/nestedresulthandler_multiple_association/ParentBean.java @@ -0,0 +1,43 @@ +package org.apache.ibatis.submitted.nestedresulthandler_multiple_association; + +import java.util.List; + +public class ParentBean { + private Integer id; + private String value; + private List> childs; + + public Integer getId() { + return id; + } + + public void setId(Integer id) { + this.id = id; + } + + public String getValue() { + return value; + } + + public void setValue(String value) { + this.value = value; + } + + public List> getChilds() { + return childs; + } + + public void setChilds(List> childs) { + this.childs = childs; + } + + @Override + public String toString() { + StringBuilder sb = new StringBuilder("ParentBean [id=" + id + ", value=" + + value + "]\nChilds:\n"); + for (Binome binome : childs) { + sb.append("\tChild : ").append(binome).append('\n'); + } + return sb.toString(); + } +} diff --git a/src/test/java/org/apache/ibatis/submitted/nestedresulthandler_multiple_association/mapper.xml b/src/test/java/org/apache/ibatis/submitted/nestedresulthandler_multiple_association/mapper.xml new file mode 100644 index 000000000..eb7f75775 --- /dev/null +++ b/src/test/java/org/apache/ibatis/submitted/nestedresulthandler_multiple_association/mapper.xml @@ -0,0 +1,52 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/src/test/java/org/apache/ibatis/submitted/nestedresulthandler_multiple_association/mybatis-config.xml b/src/test/java/org/apache/ibatis/submitted/nestedresulthandler_multiple_association/mybatis-config.xml new file mode 100644 index 000000000..6080b46ea --- /dev/null +++ b/src/test/java/org/apache/ibatis/submitted/nestedresulthandler_multiple_association/mybatis-config.xml @@ -0,0 +1,40 @@ + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/test/java/org/apache/ibatis/submitted/primitive_array/CreateDB.sql b/src/test/java/org/apache/ibatis/submitted/primitive_array/CreateDB.sql new file mode 100644 index 000000000..3b9b65e8e --- /dev/null +++ b/src/test/java/org/apache/ibatis/submitted/primitive_array/CreateDB.sql @@ -0,0 +1,30 @@ +-- +-- Copyright 2009-2014 the original author or authors. +-- +-- Licensed under the Apache License, Version 2.0 (the "License"); +-- you may not use this file except in compliance with the License. +-- You may obtain a copy of the License at +-- +-- http://www.apache.org/licenses/LICENSE-2.0 +-- +-- Unless required by applicable law or agreed to in writing, software +-- distributed under the License is distributed on an "AS IS" BASIS, +-- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +-- See the License for the specific language governing permissions and +-- limitations under the License. +-- + +drop table users if exists; + +create table users ( + id int, + name varchar(20) +); +create table udata ( + user_id int, + num int +); + +insert into users (id, name) values(1, 'User1'); +insert into udata (user_id, num) values(1, 100); +insert into udata (user_id, num) values(1, 300); diff --git a/src/test/java/org/apache/ibatis/submitted/primitive_array/Mapper.java b/src/test/java/org/apache/ibatis/submitted/primitive_array/Mapper.java new file mode 100644 index 000000000..76b1d419c --- /dev/null +++ b/src/test/java/org/apache/ibatis/submitted/primitive_array/Mapper.java @@ -0,0 +1,22 @@ +/* + * Copyright 2009-2014 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.ibatis.submitted.primitive_array; + +public interface Mapper { + + User getUser(Integer id); + +} diff --git a/src/test/java/org/apache/ibatis/submitted/primitive_array/Mapper.xml b/src/test/java/org/apache/ibatis/submitted/primitive_array/Mapper.xml new file mode 100644 index 000000000..7195901d0 --- /dev/null +++ b/src/test/java/org/apache/ibatis/submitted/primitive_array/Mapper.xml @@ -0,0 +1,40 @@ + + + + + + + + + + + + + + + + + diff --git a/src/test/java/org/apache/ibatis/submitted/primitive_array/PrimitiveArrayTest.java b/src/test/java/org/apache/ibatis/submitted/primitive_array/PrimitiveArrayTest.java new file mode 100644 index 000000000..ebbaabc15 --- /dev/null +++ b/src/test/java/org/apache/ibatis/submitted/primitive_array/PrimitiveArrayTest.java @@ -0,0 +1,66 @@ +/* + * Copyright 2009-2014 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.ibatis.submitted.primitive_array; + +import java.io.Reader; +import java.sql.Connection; + +import org.apache.ibatis.io.Resources; +import org.apache.ibatis.jdbc.ScriptRunner; +import org.apache.ibatis.session.SqlSession; +import org.apache.ibatis.session.SqlSessionFactory; +import org.apache.ibatis.session.SqlSessionFactoryBuilder; +import org.junit.Assert; +import org.junit.BeforeClass; +import org.junit.Test; + +public class PrimitiveArrayTest { + + private static SqlSessionFactory sqlSessionFactory; + + @BeforeClass + public static void setUp() throws Exception { + // create an SqlSessionFactory + Reader reader = Resources.getResourceAsReader("org/apache/ibatis/submitted/primitive_array/mybatis-config.xml"); + sqlSessionFactory = new SqlSessionFactoryBuilder().build(reader); + reader.close(); + + // populate in-memory database + SqlSession session = sqlSessionFactory.openSession(); + Connection conn = session.getConnection(); + reader = Resources.getResourceAsReader("org/apache/ibatis/submitted/primitive_array/CreateDB.sql"); + ScriptRunner runner = new ScriptRunner(conn); + runner.setLogWriter(null); + runner.runScript(reader); + reader.close(); + session.close(); + } + + @Test + public void shouldGetAUser() { + SqlSession sqlSession = sqlSessionFactory.openSession(); + try { + Mapper mapper = sqlSession.getMapper(Mapper.class); + User user = mapper.getUser(1); + Assert.assertEquals("User1", user.getName()); + Assert.assertEquals(2, user.getNum().length); + Assert.assertEquals(100, user.getNum()[0]); + } finally { + sqlSession.close(); + } + } + +} diff --git a/src/test/java/org/apache/ibatis/submitted/primitive_array/User.java b/src/test/java/org/apache/ibatis/submitted/primitive_array/User.java new file mode 100644 index 000000000..262b4e72d --- /dev/null +++ b/src/test/java/org/apache/ibatis/submitted/primitive_array/User.java @@ -0,0 +1,47 @@ +/* + * Copyright 2009-2014 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.ibatis.submitted.primitive_array; + +public class User { + + private Integer id; + private String name; + private int[] num; + + public Integer getId() { + return id; + } + + public void setId(Integer id) { + this.id = id; + } + + public String getName() { + return name; + } + + public void setName(String name) { + this.name = name; + } + + public int[] getNum() { + return num; + } + + public void setNum(int[] num) { + this.num = num; + } +} diff --git a/src/test/java/org/apache/ibatis/submitted/primitive_array/mybatis-config.xml b/src/test/java/org/apache/ibatis/submitted/primitive_array/mybatis-config.xml new file mode 100644 index 000000000..513d74c7c --- /dev/null +++ b/src/test/java/org/apache/ibatis/submitted/primitive_array/mybatis-config.xml @@ -0,0 +1,40 @@ + + + + + + + + + + + + + + + + + + + + + + + +
selectKey AttributesselectKey 的属性

属性

keyProperty -selectKey 语句结果应该被设置的目标属性。 Can be a comma separated list of property names if multiple generated columns are expected. + selectKey 语句结果应该被设置的目标属性。如果希望得到多个生成的列，也可以是逗号分隔的属性名称列表。

keyColumn The column name(s) in the returned result set that match the properties. - Can be a comma separated list of column names if multiple generated columns - are expected. + 匹配属性的返回结果集中的列名称。如果希望得到多个生成的列，也可以是逗号分隔的属性名称列表。

resultType -结果的类型。MyBatis 通常可以算出来,但是写上也没有问题。 -MyBatis 允许任何简单类型用作主键的类型,包括字符串。 + 结果的类型。MyBatis 通常可以推算出来，但是为了更加确定写上也不会有什么问题。MyBatis 允许任何简单类型用作主键的类型，包括字符串。如果希望作用于多个生成的列，则可以使用一个包含期望属性的 Object 或一个 Map。

order -这可以被设置为 BEFORE 或 AFTER。如果设置为 BEFORE,那 -么它会首先选择主键, -设置 keyProperty 然后执行插入语句。 -如果 -设置为 AFTER,那么先执行插入语句,然后是 selectKey 元素- -这和如 Oracle 数据库相似,可以在插入语句中嵌入序列调用。 + 这可以被设置为 BEFORE 或 AFTER。如果设置为 BEFORE，那么它会首先选择主键，设置 keyProperty 然后执行插入语句。如果设置为 AFTER，那么先执行插入语句，然后是 selectKey 元素 - 这和像 Oracle 的数据库相似，在插入语句内部可能有嵌入索引调用。

statementType -和前面的相同,MyBatis 支持 STA -TEMENT ,PREPARED 和 -CALLABLE 语句的映射类型,分别代表 PreparedStatement 和 -CallableStatement 类型。 + 与前面相同，MyBatis 支持 STATEMENT，PREPARED 和 CALLABLE 语句的映射类型，分别代表 PreparedStatement 和 CallableStatement 类型。

- 这个配置使全局的映射器启用或禁用缓存。 + 该配置影响的所有映射器中配置的缓存的全局开关。	true \| false @@ -153,14 +122,13 @@ SqlSessionFactory factory = sqlSessionFactoryBuilder.build(reader, environment, lazyLoadingEnabled	- 全局启用或禁用延迟加载。当禁用时, 所有关联对象都会即时加载。 - This value can be superseded for an specific relation by using the `fetchType` attribute on it. + 延迟加载的全局开关。当开启时，所有关联对象都会延迟加载。特定关联关系中可通过设置`fetchType`属性来覆盖该项的开关状态。	true \| false	- true + false
- 当启用时, 有延迟加载属性的对象在被 - 调用时将会完全加载任意属性。否则, - 每种属性将会按需要加载。 + 当启用时，带有延迟加载属性的对象的加载与否完全取决于对任意延迟属性的调用；反之，每种属性将会按需加载。	true \| false @@ -184,8 +150,7 @@ SqlSessionFactory factory = sqlSessionFactoryBuilder.build(reader, environment, multipleResultSetsEnabled	- 允许或不允许多种结果集从一个单独 - 的语句中返回(需要适合的驱动) + 是否允许单一语句返回多结果集（需要兼容驱动）。	true \| false @@ -199,11 +164,7 @@ SqlSessionFactory factory = sqlSessionFactoryBuilder.build(reader, environment, useColumnLabel	- 使用列标签代替列名。 - 不同的驱动在这 - 方便表现不同。 - 参考驱动文档或充分测 - 试两种方法来决定所使用的驱动。 + 使用列标签代替列名。不同的驱动在这方面会有不同的表现，具体可参考相关驱动文档或通过测试这两种不同的模式来观察所用驱动的结果。	true \| false @@ -217,13 +178,7 @@ SqlSessionFactory factory = sqlSessionFactoryBuilder.build(reader, environment, useGeneratedKeys	- 允许 JDBC 支持生成的键。 - 需要适合的 - 驱动。 - 如果设置为 true 则这个设置强制 - 生成的键被使用, - 尽管一些驱动拒绝兼 - 容但仍然有效(比如 Derby) + 允许 JDBC 支持自动生成主键，需要驱动兼容。如果设置为 true 则这个设置强制使用自动生成主键，尽管一些驱动不能兼容但仍可正常工作（比如 Derby）。	true \| false @@ -237,10 +192,7 @@ SqlSessionFactory factory = sqlSessionFactoryBuilder.build(reader, environment, autoMappingBehavior	- 指定 MyBatis 如何自动映射列到字段/ - 属性。PARTIAL 只会自动映射简单, - 没有嵌套的结果。FULL 会自动映射任 - 意复杂的结果(嵌套的或其他情况) 。 + 指定 MyBatis 是否以及如何自动映射指定的列到字段或属性。NONE 表示取消自动映射；PARTIAL 只会自动映射没有定义嵌套结果集映射的结果集。FULL 会自动映射任意复杂的结果集（包括嵌套和其他情况）。	NONE, PARTIAL, FULL @@ -254,10 +206,7 @@ SqlSessionFactory factory = sqlSessionFactoryBuilder.build(reader, environment, defaultExecutorType	- 配置默认的执行器。SIMPLE 执行器没 - 有什么特别之处。REUSE 执行器重用 - 预处理语句。BATCH 执行器重用语句 - 和批量更新 + 配置默认的执行器。SIMPLE 就是普通的执行器；REUSE 执行器会重用预处理语句（prepared statements）；BATCH 执行器将重用语句并执行批量更新。	SIMPLE @@ -273,9 +222,7 @@ SqlSessionFactory factory = sqlSessionFactoryBuilder.build(reader, environment, defaultStatementTimeout	- 设置超时时间, - 它决定驱动等待一个数 - 据库响应的时间。 + 设置超时时间，它决定驱动等待数据库响应的秒数。	Any positive integer @@ -289,8 +236,7 @@ SqlSessionFactory factory = sqlSessionFactoryBuilder.build(reader, environment, safeRowBoundsEnabled	- Allows using RowBounds on nested - statements. + 允许在嵌套语句中使用行分界（RowBounds）。	true \| false @@ -304,10 +250,7 @@ SqlSessionFactory factory = sqlSessionFactoryBuilder.build(reader, environment, mapUnderscoreToCamelCase	- Enables automatic mapping from - classic database column names - A_COLUMN to camel case classic Java - property names aColumn. + 是否开启自动驼峰命名规则（camel case）映射，即从经典数据库列名 A_COLUMN 到经典 Java 属性名 aColumn 的类似映射。	true \| false @@ -321,9 +264,7 @@ SqlSessionFactory factory = sqlSessionFactoryBuilder.build(reader, environment, localCacheScope	- MyBatis uses local cache to prevent circular references and speed up repeated nested queries. - By default (SESSION) all queries executed during a session are cached. If localCacheScope=STATEMENT local session will be used just for - statement execution, no data will be shared between two different calls to the same SqlSession. + MyBatis 利用本地缓存机制（Local Cache）防止循环引用（circular references）和加速重复嵌套查询。默认值为 SESSION，这种情况下会缓存一个会话中执行的所有查询。若设置值为 STATEMENT，本地会话仅用在语句执行上，对相同 SqlSession 的不同调用将不会共享数据。	SESSION \| STATEMENT @@ -337,8 +278,7 @@ SqlSessionFactory factory = sqlSessionFactoryBuilder.build(reader, environment, jdbcTypeForNull	- Specifies the JDBC type for null values when no specific JDBC type was provided for the parameter. - Some drivers require specifying the column JDBC type but others work with generic values like NULL, VARCHAR or OTHER. + 当没有为参数提供特定的 JDBC 类型时，为空值指定 JDBC 类型。某些驱动需要指定列的 JDBC 类型，多数情况直接用一般类型即可，比如 NULL、VARCHAR 或 OTHER。	JdbcType enumeration. Most common are: NULL, VARCHAR and OTHER @@ -352,7 +292,7 @@ SqlSessionFactory factory = sqlSessionFactoryBuilder.build(reader, environment, lazyLoadTriggerMethods	- Specifies which Object's methods trigger a lazy load + 指定哪个对象的方法触发一次延迟加载。	A method name list separated by commas @@ -366,7 +306,7 @@ SqlSessionFactory factory = sqlSessionFactoryBuilder.build(reader, environment, defaultScriptingLanguage	- Specifies the language used by default for dynamic SQL generation. + 指定动态 SQL 生成的默认语言。	A type alias or fully qualified class name. @@ -379,7 +319,8 @@ SqlSessionFactory factory = sqlSessionFactoryBuilder.build(reader, environment,	callSettersOnNulls	当结果集中含有Null值时是否执行映射对象的setter或者Map对象的put方法。此设置对于原始类型如int,boolean等无效。 +	+ 指定当结果集中值为 null 的时候是否调用映射对象的 setter（map 对象时为 put）方法，这对于有 Map.keySet() 依赖或 null 值初始化的时候是有用的。注意原始类型（int、boolean等）是不能设置成 null 的。	true \| false @@ -393,7 +334,7 @@ SqlSessionFactory factory = sqlSessionFactoryBuilder.build(reader, environment, logPrefix	- Specifies the prefix string that MyBatis will add to the logger names. + 指定 MyBatis 增加到日志名称的前缀。	Any String @@ -407,7 +348,7 @@ SqlSessionFactory factory = sqlSessionFactoryBuilder.build(reader, environment, logImpl	- Specifies which logging implementation MyBatis should use. If this setting is not present logging implementation will be autodiscovered. + 指定 MyBatis 所用日志的具体实现，未指定时将自动查找。	SLF4J \| LOG4J \| LOG4J2 \| JDK_LOGGING \| COMMONS_LOGGING \| STDOUT_LOGGING \| NO_LOGGING @@ -421,7 +362,7 @@ SqlSessionFactory factory = sqlSessionFactoryBuilder.build(reader, environment, proxyFactory	- Specifies the proxy tool that MyBatis will use for creating lazy loading capable objects. + 为 Mybatis 用来创建具有延迟加载能力的对象设置代理工具。	CGLIB \| JAVASSIST @@ -433,7 +374,7 @@ SqlSessionFactory factory = sqlSessionFactoryBuilder.build(reader, environment,

- Java 类型 + Java 类型	JDBC 类型 @@ -996,8 +905,7 @@ public class Author { Enumeration Type	- VARCHAR-任何兼容的字符串类型, - 作为代码存储(而不是索引) + VARCHAR-任何兼容的字符串类型，作为代码存储（而不是索引）
- Any compatible `NUMERIC` or `DOUBLE`, as the position is stored - (not the code itself). + 任何兼容的 `NUMERIC` 或 `DOUBLE` 类型，作为位置存储（而不是代码本身）。

Paso 1: Añade el fichero Log4J JAR +

Paso 1: Añade el fichero Log4j JAR

- Paso 2: Configurar Log4J + Paso 2: Configurar Log4j