From 1ac12abb5ce91fcca1e0938300d80d7d0cba8a7b Mon Sep 17 00:00:00 2001 From: caily Date: Tue, 17 Oct 2017 00:04:11 +0800 Subject: [PATCH 1/5] optimize translation of file getting-started.xml --- src/site/zh/xdoc/getting-started.xml | 34 +++++++++++----------------- 1 file changed, 13 insertions(+), 21 deletions(-) diff --git a/src/site/zh/xdoc/getting-started.xml b/src/site/zh/xdoc/getting-started.xml index e6f5030f21..4c18dfa94b 100644 --- a/src/site/zh/xdoc/getting-started.xml +++ b/src/site/zh/xdoc/getting-started.xml @@ -29,20 +29,19 @@

-本章将会以简略的步骤告诉你如何安装和创建 MyBatis-Spring,并构建一个简单的数据 -访问事务性的应用程序。 +本章将会以简略的步骤告诉你如何安装和创建 MyBatis-Spring，并构建一个简单的数据访问事务性的应用程序。

-要使用 MyBatis-Spring 模块,你只需要包含 +要使用MyBatis-Spring模块，只需要在类路径下包含 mybatis-spring-x.x.x.jar -文 件就可以了,并在类路径中加入相关的依赖。 +文件和相关依赖。

-如果你使用 Maven,那么在 pom.xml 中加入下面的代码即可: +如果使用Maven，仅需要在pom.xml中加入以下代码即可：

@@ -54,13 +53,11 @@

-要和 Spring 一起使用 MyBatis,你需要在 Spring 应用上下文中定义至少两样东西:一个 -SqlSessionFactory 和至少一个数据映射器类。 +要和Spring一起使用MyBatis，需要在Spring应用上下文中定义至少两样东西：一个SqlSessionFactory和至少一个数据映射器类。

-在 MyBatis-Spring 中,SqlSessionFactoryBean 是用于创建 SqlSessionFactory 的。要 -配置这个工厂 bean,放置下面的代码在 Spring 的 XML 配置文件中: +在MyBatis-Spring中，可使用SqlSessionFactoryBean来创建SqlSessionFactory。要配置这个工厂bean，只需要把下面代码放在Spring的XML配置文件中：

]]>

-要注意 SqlSessionFactory 需要一个 DataSource(数据源,译者注) -。这可以是任意 -的 DataSource,配置它就和配置其它 Spring 数据库连接一样。 +需要注意的是：SqlSessionFactory需要一个DataSource（数据源，译者注）。这可以是任意的DataSource，配置它就和配置其它Spring数据库连接一样。

-假设你定义了一个如下的数据 mapper 接口: +假设你定义了一个如下的mapper接口：

-那么可以使用 MapperFactoryBean,像下面这样来把接口加入到 Spring 中: +那么可以通过MapperFactoryBean像下面那样把接口加入到Spring中:

]]>

-要注意,所指定的映射器类必须是一个接口,而不是具体的实现类。在这个示例中,注 -解被用来指定 SQL 语句,但是 MyBatis 的映射器 XML 文件也可以用。 +需要注意的是：所指定的映射器类必须是一个接口，而不是具体的实现类。在这个示例中通过注解来指定SQL语句，但是通过MyBatis映射器的XML文件也行。

-一旦配置好,你可以用注入其它任意 Spring 的 bean 相同的方式直接注入映射器到你的 -business/service 对象中。MapperFactoryBean 处理 SqlSession 的创建和关闭它。如果使用 -了 Spring 的事务,那么当事务完成时,session 将会提交或回滚。最终,任何异常都会被翻 -译成 Spring 的 DataAccessException 异常。 +一旦完成配置，你可以像其它Spring中的bean注入方法将映射器到业务(bussiness)或服务(service)对象中。MapperFactoryBean用来处理SqlSession的创建和关闭动作。 +如果使用了Spring的事务，那么当事务完成时，session将会被提交或回滚。最终任何异常都会被翻译成Spring的DataAccessException异常。

-调用 MyBatis 数据方法现在只需一行代码: +调用MyBatis数据方法现在只需一行代码：

Date: Tue, 17 Oct 2017 00:37:47 +0800 Subject: [PATCH 2/5] optimize and fix translation of file factorybean.xml --- src/site/zh/xdoc/factorybean.xml | 93 +++++++++++++++++++------------- 1 file changed, 55 insertions(+), 38 deletions(-) diff --git a/src/site/zh/xdoc/factorybean.xml b/src/site/zh/xdoc/factorybean.xml index 5dfc16ac4c..07222dd275 100644 --- a/src/site/zh/xdoc/factorybean.xml +++ b/src/site/zh/xdoc/factorybean.xml @@ -29,25 +29,24 @@

-在基本的 MyBatis 中,session 工厂可以使用 SqlSessionFactoryBuilder 来创建。而在 -MyBatis-Spring 中,则使用 SqlSessionFactoryBean 来替代。 +在基础的MyBatis中，通过SqlSessionFactoryBuilder来创建SqlSessionFactory。而在 +MyBatis-Spring中，则使用SqlSessionFactoryBean来创建。

-要创建工厂 bean,放置下面的代码在 Spring 的 XML 配置文件中: +要创建工厂bean，将下面的代码放到Spring的XML配置文件中：

]]>

-要注意 SqlSessionFactoryBean 实现了 Spring 的 FactoryBean 接口(请参考 Spring 文 -档的 3.8 章节)这就说明了由 Spring 最终创建的 bean 不是 SqlSessionFactoryBean 本身, -。 -而是工厂类的 getObject()返回的方法的结果。这种情况下,Spring 将会在应用启动时为你 -创建 SqlSessionFactory 对象,然后将它以 SqlSessionFactory 为名来存储。在 Java 中, -相同的代码是: +需要注意的是SqlSessionFactoryBean实现了Spring的FactoryBean接口（参考 Spring 文 +档的3.8 章节）。这意味着由Spring最终创建的bean并不是SqlSessionFactoryBean本身， +而是工厂类（SqlSessionFactoryBean）的 getObject()方法的返回结果。这种情况下，Spring +将会在应用启动时为你创建SqlSessionFactory的bean对象，然后将其名字设为sqlSessionFactory。 +在 Java 中的等效代码如下:

-在一般的 MyBatis-Spring 用法中, -你不需要直接使用 SqlSessionFactoryBean 或和其对 -应的 SqlSessionFactory。相反,session 工厂将会被注入到 MapperFactoryBean 或其它扩 -展了 SqlSessionDaoSupport 的 DAO(Data Access Object,数据访问对象,译者注)中。 +在通常的MyBatis-Spring 用法中，你不需要直接使用SqlSessionFactoryBean或对 +应的SqlSessionFactory。相反，session的工厂bean将会被注入到MapperFactoryBean或其它扩 +展了SqlSessionDaoSupport的DAO（Data Access Object，数据访问对象，译者注）中。

-SqlSessionFactory 有一个单独的必须属性,就是 JDBC 的 DataSource。这可以是任意 -的 DataSource,其配置应该和其它 Spring 数据库连接是一样的。 +SqlSessionFactory有一个唯一的必要属性：用于JDBC的DataSource。这可以是任意 +的DataSource对象，它的配置应该和其它Spring数据库连接是一样的。

-一个通用的属性是 configLocation,它是用来指定 MyBatis 的 XML 配置文件路径的。 -如果基本的 MyBatis 配置需要改变, -那么这就是一个需要它的地方。 -通常这会是<settings> +一个通用的属性是configLocation，它用来指定MyBatis的XML配置文件路径。 +如果需要修改MyBatis的基础配置，那么它就有用了。通常这会是<settings> 或<typeAliases>的部分。

-要注意这个配置文件不需要是一个完整的 MyBatis 配置。确切地说,任意环境,数据源 -和 MyBatis 的事务管理器都会被忽略。SqlSessionFactoryBean 会创建它自己的,使用这些 -值定制 MyBatis 的 Environment 时是需要的。 +需要注意的是，这个配置文件并不需要是一个完整的MyBatis配置。确切地说，任何环境，数据源 +和MyBatis的事务管理器都会被忽略。SqlSessionFactoryBean会创建它自己的,使用这些 +值定制MyBatis的Environment时是需要的。

-如果 MyBatis 映射器 XML 文件在和映射器类相同的路径下不存在,那么另外一个需要 -配置文件的原因就是它了。使用这个配置,有两种选择。第一是手动在 MyBatis 的 XML 配 -置文件中使用<mappers>部分来指定类路径。第二是使用工厂 bean 的 mapperLocations 属 -性。 +如果MyBatis在映射器类对应的路径下不存在与之相应的映射器XML文件，那么此时也需要配置文件。 +有两种方式来使用配置：第一种是是手动在MyBatis的XML配置文件中使用<mappers>部分来 +指定类路径；第二种是使用工厂bean的mapperLocations属性。

-mapperLocations 属性使用一个资源位置的 list。 -这个属性可以用来指定 MyBatis 的 XML -映射器文件的位置。 -它的值可以包含 Ant 样式来加载一个目录中所有文件, -或者从基路径下 +mapperLocations属性使用list来表示资源位置。这个属性可以用来指定MyBatis的XML +映射器文件的位置。它的值可以包含Ant样式来加载一个目录中所有文件,或者从基路径下 递归搜索所有路径。比如:

@@ -106,20 +98,45 @@ mapperLocations 属性使用一个资源位置的 list。 ]]>

-这会从类路径下加载在 sample.config.mappers 包和它的子包中所有的 MyBatis 映射器 -XML 文件。 +这会从类路径下加载在sample.config.mappers包和它的子包中所有的MyBatis映射器XML文件。

-在容器环境管理事务中,一个可能需要的属性是 transactionFactoryClass。请参考 -第四章(4.2 节)中来查看有关部分。 +在容器环境管理事务中,一个可能需要的属性是transactionFactoryClass。请参考第四章(4.2 节)中来查看有关部分。 +如果你正在使用多数据库功能，那么就需要设置databaseIdProvider属性。

+ + + + + sqlserver + db2 + oracle + mysql + + + + + + + + + + + + + + + ]]> + +

NOTE - Since 1.3.0, configuration property has been added. - It can be specified a Configuration instance directly without MyBatis XML configuration file. - For example: + 自1.3.0版本开始添加configuration属性。 + 它能够在没有MyBatis对应的XML配置文件的情况下直接指定Configuration实例。 + 举个栗子:

Date: Thu, 16 Nov 2017 15:39:00 +0800 Subject: [PATCH 3/5] remote useless file --- src/site/zh/xdoc/getting-started.xml.vm | 134 ------------------------ 1 file changed, 134 deletions(-) delete mode 100644 src/site/zh/xdoc/getting-started.xml.vm diff --git a/src/site/zh/xdoc/getting-started.xml.vm b/src/site/zh/xdoc/getting-started.xml.vm deleted file mode 100644 index ce5a8d3ac4..0000000000 --- a/src/site/zh/xdoc/getting-started.xml.vm +++ /dev/null @@ -1,134 +0,0 @@ - - - - - - MyBatis-Spring | 第二章 入门 - Hunter Presnall - Eduardo Macarron - Nan Lei - - - -
-

-本章将会以简略的步骤告诉你如何安装和创建 MyBatis-Spring，并构建一个简单的数据访问事务性的应用程序。 -

- - -

-要使用MyBatis-Spring模块，只需要在类路径下包含 - mybatis-spring-${project.version}.jar -文件和相关依赖。 -

-

-如果使用Maven，仅需要在pom.xml中加入以下代码即可： -

- - org.mybatis - mybatis-spring - ${project.version} -]]> - - - -

-要和Spring一起使用MyBatis，需要在Spring应用上下文中定义至少两样东西：一个SqlSessionFactory和至少一个数据映射器类。 -

- -

-在MyBatis-Spring中，可使用SqlSessionFactoryBean来创建SqlSessionFactory。要配置这个工厂bean，只需要把下面代码放在Spring的XML配置文件中： -

- - - -]]> - - - -

-需要注意的是：SqlSessionFactory需要一个DataSource（数据源，译者注）。这可以是任意的DataSource，配置它就和配置其它Spring数据库连接一样。 -

- -

-假设你定义了一个如下的mapper接口： -

- - -

-那么可以通过MapperFactoryBean像下面那样把接口加入到Spring中: -

- - - - -]]> - -

-需要注意的是：所指定的映射器类必须是一个接口，而不是具体的实现类。在这个示例中通过注解来指定SQL语句，但是通过MyBatis映射器的XML文件也行。 -

- -

-一旦完成配置，你可以像其它Spring中的bean注入方法将映射器到业务(bussiness)或服务(service)对象中。MapperFactoryBean用来处理SqlSession的创建和关闭动作。 -如果使用了Spring的事务，那么当事务完成时，session将会被提交或回滚。最终任何异常都会被翻译成Spring的DataAccessException异常。 -

- -

- 如果你使用Java代码来配置： -

- - -

-调用MyBatis数据方法现在只需一行代码： -

- - -
- - From e22960e64b0e75109045ee60a14b8cb12ffb6ee5 Mon Sep 17 00:00:00 2001 From: caily Date: Fri, 17 Nov 2017 11:12:42 +0800 Subject: [PATCH 4/5] change file name back --- src/site/zh/xdoc/getting-started.xml | 134 --------------------------- 1 file changed, 134 deletions(-) delete mode 100644 src/site/zh/xdoc/getting-started.xml diff --git a/src/site/zh/xdoc/getting-started.xml b/src/site/zh/xdoc/getting-started.xml deleted file mode 100644 index ce5a8d3ac4..0000000000 --- a/src/site/zh/xdoc/getting-started.xml +++ /dev/null @@ -1,134 +0,0 @@ - - - - - - MyBatis-Spring | 第二章 入门 - Hunter Presnall - Eduardo Macarron - Nan Lei - - - -
-

-本章将会以简略的步骤告诉你如何安装和创建 MyBatis-Spring，并构建一个简单的数据访问事务性的应用程序。 -

- - -

-要使用MyBatis-Spring模块，只需要在类路径下包含 - mybatis-spring-${project.version}.jar -文件和相关依赖。 -

-

-如果使用Maven，仅需要在pom.xml中加入以下代码即可： -

- - org.mybatis - mybatis-spring - ${project.version} -]]> - - - -

-要和Spring一起使用MyBatis，需要在Spring应用上下文中定义至少两样东西：一个SqlSessionFactory和至少一个数据映射器类。 -

- -

-在MyBatis-Spring中，可使用SqlSessionFactoryBean来创建SqlSessionFactory。要配置这个工厂bean，只需要把下面代码放在Spring的XML配置文件中： -

- - - -]]> - - - -

-需要注意的是：SqlSessionFactory需要一个DataSource（数据源，译者注）。这可以是任意的DataSource，配置它就和配置其它Spring数据库连接一样。 -

- -

-假设你定义了一个如下的mapper接口： -

- - -

-那么可以通过MapperFactoryBean像下面那样把接口加入到Spring中: -

- - - - -]]> - -

-需要注意的是：所指定的映射器类必须是一个接口，而不是具体的实现类。在这个示例中通过注解来指定SQL语句，但是通过MyBatis映射器的XML文件也行。 -

- -

-一旦完成配置，你可以像其它Spring中的bean注入方法将映射器到业务(bussiness)或服务(service)对象中。MapperFactoryBean用来处理SqlSession的创建和关闭动作。 -如果使用了Spring的事务，那么当事务完成时，session将会被提交或回滚。最终任何异常都会被翻译成Spring的DataAccessException异常。 -

- -

- 如果你使用Java代码来配置： -

- - -

-调用MyBatis数据方法现在只需一行代码： -

- - -
- - From 63a2311de1c79da5ad186201d43194160b47bf09 Mon Sep 17 00:00:00 2001 From: caily Date: Fri, 17 Nov 2017 11:14:41 +0800 Subject: [PATCH 5/5] change file name back --- src/site/zh/xdoc/getting-started.xml.vm | 134 ++++++++++++++++++++++++ 1 file changed, 134 insertions(+) create mode 100644 src/site/zh/xdoc/getting-started.xml.vm diff --git a/src/site/zh/xdoc/getting-started.xml.vm b/src/site/zh/xdoc/getting-started.xml.vm new file mode 100644 index 0000000000..ce5a8d3ac4 --- /dev/null +++ b/src/site/zh/xdoc/getting-started.xml.vm @@ -0,0 +1,134 @@ + + + + + + MyBatis-Spring | 第二章 入门 + Hunter Presnall + Eduardo Macarron + Nan Lei + + + +
+

+本章将会以简略的步骤告诉你如何安装和创建 MyBatis-Spring，并构建一个简单的数据访问事务性的应用程序。 +

+ + +

+要使用MyBatis-Spring模块，只需要在类路径下包含 + mybatis-spring-${project.version}.jar +文件和相关依赖。 +

+

+如果使用Maven，仅需要在pom.xml中加入以下代码即可： +

+ + org.mybatis + mybatis-spring + ${project.version} +]]> + + + +

+要和Spring一起使用MyBatis，需要在Spring应用上下文中定义至少两样东西：一个SqlSessionFactory和至少一个数据映射器类。 +

+ +

+在MyBatis-Spring中，可使用SqlSessionFactoryBean来创建SqlSessionFactory。要配置这个工厂bean，只需要把下面代码放在Spring的XML配置文件中： +

+ + + +]]> + + + +

+需要注意的是：SqlSessionFactory需要一个DataSource（数据源，译者注）。这可以是任意的DataSource，配置它就和配置其它Spring数据库连接一样。 +

+ +

+假设你定义了一个如下的mapper接口： +

+ + +

+那么可以通过MapperFactoryBean像下面那样把接口加入到Spring中: +

+ + + + +]]> + +

+需要注意的是：所指定的映射器类必须是一个接口，而不是具体的实现类。在这个示例中通过注解来指定SQL语句，但是通过MyBatis映射器的XML文件也行。 +

+ +

+一旦完成配置，你可以像其它Spring中的bean注入方法将映射器到业务(bussiness)或服务(service)对象中。MapperFactoryBean用来处理SqlSession的创建和关闭动作。 +如果使用了Spring的事务，那么当事务完成时，session将会被提交或回滚。最终任何异常都会被翻译成Spring的DataAccessException异常。 +

+ +

+ 如果你使用Java代码来配置： +

+ + +

+调用MyBatis数据方法现在只需一行代码： +

+ + +
+ +