Skip to content

Commit 7c25e9c

Browse files
emacarronemacarron
committed
Merge pull request #389 from nanlei/site_zh
Translate statement-builders.xml, Update index/getting-started/dynamic sql/logging xmls
2 parents 9a65bbb + 9bcd4b8 commit 7c25e9c

File tree

6 files changed

+422
-381
lines changed

6 files changed

+422
-381
lines changed

‎src/site/site_zh.xml

Lines changed: 20 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -22,32 +22,32 @@
2222
<menu name="参考文档">
2323
<item name="简介" href="index.html"/>
2424
<item name="入门" href="getting-started.html"/>
25-
<item name="XML 配置" href="configuration.html" collapse="true">
26-
<item href="configuration.html#properties" name="properties" />
27-
<item href="configuration.html#settings" name="settings" />
28-
<item href="configuration.html#typeAliases" name="typeAliases" />
29-
<item href="configuration.html#typeHandlers" name="typeHandlers" />
30-
<item href="configuration.html#objectFactory" name="objectFactory" />
31-
<item href="configuration.html#plugins" name="plugins" />
32-
<item href="configuration.html#environments" name="environments" />
33-
<item href="configuration.html#databaseIdProvider" name="databaseIdProvider" />
34-
<item href="configuration.html#mappers" name="mappers" />
25+
<item name="XML配置" href="configuration.html" collapse="true">
26+
<item href="configuration.html#properties" name="属性(properties)" />
27+
<item href="configuration.html#settings" name="设置(settings)" />
28+
<item href="configuration.html#typeAliases" name="类型别名(typeAliases)" />
29+
<item href="configuration.html#typeHandlers" name="类型处理(typeHandlers)" />
30+
<item href="configuration.html#objectFactory" name="对象工厂(objectFactory)" />
31+
<item href="configuration.html#plugins" name="插件(plugins)" />
32+
<item href="configuration.html#environments" name="环境配置(environments)" />
33+
<item href="configuration.html#databaseIdProvider" name="数据库厂商标识(databaseIdProvider)" />
34+
<item href="configuration.html#mappers" name="映射器(mappers)" />
3535
</item>
36-
<item name="XML 映射文件" href="sqlmap-xml.html" collapse="true">
37-
<item href="sqlmap-xml.html#select" name="select" />
38-
<item href="sqlmap-xml.html#insert_update_and_delete" name="insert, update and delete" />
39-
<item href="sqlmap-xml.html#Parameters" name="Parameters" />
40-
<item href="sqlmap-xml.html#Result_Maps" name="Result Maps" />
41-
<item href="sqlmap-xml.html#Auto-mapping" name="Auto-mapping" />
36+
<item name="XML映射文件" href="sqlmap-xml.html" collapse="true">
37+
<item href="sqlmap-xml.html#select" name="查询(select)" />
38+
<item href="sqlmap-xml.html#insert_update_and_delete" name="更新(insert, update and delete)" />
39+
<item href="sqlmap-xml.html#Parameters" name="参数(Parameters)" />
40+
<item href="sqlmap-xml.html#Result_Maps" name="结果集(Result Maps)" />
41+
<item href="sqlmap-xml.html#Auto-mapping" name="自动映射(Auto-mapping)" />
4242
<item href="sqlmap-xml.html#cache" name="cache" />
4343
</item>
44-
<item name="动态 SQL" href="dynamic-sql.html"/>
44+
<item name="动态SQL" href="dynamic-sql.html"/>
4545
<item name="Java API" href="java-api.html" collapse="true">
46-
<item name="Directory Structure" href="java-api.html#directoryStructure" />
46+
<item name="目录结构" href="java-api.html#directoryStructure" />
4747
<item name="SqlSessions" href="java-api.html#sqlSessions" />
4848
</item>
49-
<item name="SQL 组装类" href="statement-builders.html" collapse="true" />
50-
<item name="日志处理" href="logging.html"/>
49+
<item name="SQL语句构建器" href="statement-builders.html" collapse="true" />
50+
<item name="日志" href="logging.html"/>
5151
</menu>
5252

5353
<menu ref="reports"/>

‎src/site/zh/xdoc/dynamic-sql.xml

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -29,9 +29,9 @@
2929

3030
<body>
3131
<section name="动态 SQL">
32-
<p>MyBatis 的强大特性之一便是它的动态 SQL 能力。如果你有使用 JDBC 或其他类似框架的经验，你就能体会到根据不同条件拼接 SQL 字符串有多么痛苦。拼接的时候要确保不能忘了必要的空格，还要注意省掉列名列表最后的逗号。利用动态 SQL 这一特性可以彻底摆脱这种痛苦。</p>
33-
<p>通常使用动态 SQL 不可能是独立的一部分,MyBatis 当然使用一种强大的动态 SQL 语言来改进这种情形,这种语言可以被用在任意映射的 SQL 语句中。</p>
34-
<p>动态 SQL 元素和使用 JSTL 或其他相似的基于 XML 的文本处理器相似。在 MyBatis 之前的版本中,有很多的元素需要来了解。MyBatis 3 大大提升了它们,现在用不到原先一半的元素就能工作了。MyBatis 采用功能强大的基于 OGNL 的表达式来消除其他元素。</p>
32+
<p>MyBatis 的强大特性之一便是它的动态 SQL。如果你有使用 JDBC 或其他类似框架的经验，你就能体会到根据不同条件拼接 SQL 语句有多么痛苦。拼接的时候要确保不能忘了必要的空格，还要注意省掉列名列表最后的逗号。利用动态 SQL 这一特性可以彻底摆脱这种痛苦。</p>
33+
<p>通常使用动态 SQL 不可能是独立的一部分,MyBatis 当然使用一种强大的动态 SQL 语言来改进这种情形,这种语言可以被用在任意的 SQL 映射语句中。</p>
34+
<p>动态 SQL 元素和使用 JSTL 或其他类似基于 XML 的文本处理器相似。在 MyBatis 之前的版本中,有很多的元素需要来了解。MyBatis 3 大大提升了它们,现在用不到原先一半的元素就可以了。MyBatis 采用功能强大的基于 OGNL 的表达式来消除其他元素。</p>
3535
<ul>
3636
<li>if</li>
3737
<li>choose (when, otherwise)</li>
@@ -48,7 +48,7 @@
4848
AND title like #{title}
4949
</if>
5050
</select>]]></source>
51-
<p>这条语句提供了一个可选的文本查找类型的功能。如果没有传入“title”，那么所有处于“ACTIVE”状态的BLOG都会返回；反之若传入了“title”，那么就会把相近“title”的BLOG返回（就这个例子而言，细心的读者会发现其中的参数值是可以包含一些掩码或通配符的）。</p>
51+
<p>这条语句提供了一个可选的文本查找类型的功能。如果没有传入“title”，那么所有处于“ACTIVE”状态的BLOG都会返回；反之若传入了“title”，那么就会把模糊查找“title”内容的BLOG结果返回（就这个例子而言，细心的读者会发现其中的参数值是可以包含一些掩码或通配符的）。</p>
5252
<p>如果想可选地通过“title”和“author”两个条件搜索该怎么办呢？首先，改变语句的名称让它更具实际意义；然后只要加入另一个条件即可。</p>
5353
<source><![CDATA[<select id="findActiveBlogLike"
5454
resultType="Blog">
@@ -63,7 +63,7 @@
6363
</subsection>
6464
<subsection name="choose, when, otherwise" id="chooseWhenOtherwise">
6565
<p>有些时候，我们不想用到所有的条件语句，而只想从中择其一二。针对这种情况，MyBatis 提供了 choose 元素，它有点像 Java 中的 switch 语句。</p>
66-
<p>还是上面的例子，但是这次变为提供了“title”就按“title”查找，提供了“author”就按“author”查找，若两者都没有提供，就返回所有符合条件的BLOG（实际情况可能是由管理员策略地选出BLOG列表，而不是返回大量无意义的随机结果）。</p>
66+
<p>还是上面的例子，但是这次变为提供了“title”就按“title”查找，提供了“author”就按“author”查找，若两者都没有提供，就返回所有符合条件的BLOG（实际情况可能是由管理员按一定策略选出BLOG列表，而不是返回大量无意义的随机结果）。</p>
6767
<source><![CDATA[<select id="findActiveBlogLike"
6868
resultType="Blog">
6969
SELECT * FROM BLOG WHERE state = ‘ACTIVE’
@@ -104,7 +104,7 @@ WHERE]]></source>
104104
<source><![CDATA[SELECT * FROM BLOG
105105
WHERE
106106
AND title like ‘someTitle’]]></source>
107-
<p>这个查询也会失败。这个问题不能简单的用条件句式来解决，如果你也曾经被迫这样写过，那么你很可能从此以后都不想再这样去写。</p>
107+
<p>这个查询也会失败。这个问题不能简单的用条件句式来解决，如果你也曾经被迫这样写过，那么你很可能从此以后都不想再这样去写了。</p>
108108
<p>MyBatis 有一个简单的处理，这在90%的情况下都会有用。而在不能使用的地方，你可以自定义处理方式来令其正常工作。一处简单的修改就能得到想要的效果：</p>
109109
<source><![CDATA[<select id="findActiveBlogLike"
110110
resultType="Blog">
@@ -156,7 +156,7 @@ AND title like ‘someTitle’]]></source>
156156
#{item}
157157
</foreach>
158158
</select>]]></source>
159-
<p>foreach 元素是非常强大的，它允许你指定一个集合，声明可以用在元素体内的集合项和索引变量。它也允许你指定开闭匹配的字符串以及在迭代之间放置分隔符。这个元素是很智能的，因此它不会偶然地附加多余的分隔符。</p>
159+
<p>foreach 元素的功能是非常强大的，它允许你指定一个集合，声明可以用在元素体内的集合项和索引变量。它也允许你指定开闭匹配的字符串以及在迭代中间放置分隔符。这个元素是很智能的，因此它不会偶然地附加多余的分隔符。</p>
160160
<p><span class="label important">注意</span> 你可以将一个 List 实例或者数组作为参数对象传给 MyBatis，当你这么做的时候，MyBatis 会自动将它包装在一个 Map 中并以名称为键。List 实例将会以“list”作为键，而数组实例的键将是“array”。</p>
161161
<p>到此我们已经完成了涉及 XML 配置文件和 XML 映射文件的讨论。下一部分将详细探讨 Java API，这样才能从已创建的映射中获取最大利益。</p>
162162
</subsection>
@@ -184,7 +184,7 @@ AND title like ‘someTitle’]]></source>
184184
</insert>
185185
]]></source>
186186
</subsection>
187-
<subsection name="Pluggable Scripting Languages For Dynamic SQL">
187+
<subsection name="动态 SQL 中可插拔的脚本语言">
188188
<p>MyBatis 从 3.2 开始支持可插拔的脚本语言，因此你可以在插入一种语言的驱动（language driver）之后来写基于这种语言的动态 SQL 查询。</p>
189189
<p>可以通过实现下面接口的方式来插入一种语言：</p>
190190
<source><![CDATA[public interface LanguageDriver {

0 commit comments

Comments
 (0)