Skip to content

Commit 675a56e

Browse files
committed
add id property to subsection
1 parent 2a12ffa commit 675a56e

File tree

2 files changed

+15
-15
lines changed

2 files changed

+15
-15
lines changed

src/site/zh/xdoc/configuration.xml

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -57,7 +57,7 @@
5757
</ul>
5858
</li>
5959
</ul>
60-
<subsection name="properties">
60+
<subsection name="properties" id="properties">
6161
<p>这些属性都是可外部配置且可动态替换的,既可以在典型的 Java 属性文件中配置,亦可通过 properties 元素的子元素来传递。例如:</p>
6262
<source><![CDATA[<properties resource="org/mybatis/example/config.properties">
6363
<property name="username" value="dev_user"/>
@@ -90,7 +90,7 @@ SqlSessionFactory factory = sqlSessionFactoryBuilder.build(reader, environment,
9090
</ul>
9191
<p>因此,通过方法参数传递的属性具有最高优先级,资源文件及 url 属性配置的次之,最低优先级的是 properties 属性中指定的属性。</p>
9292
</subsection>
93-
<subsection name="settings">
93+
<subsection name="settings" id="settings">
9494
<p>调整 settings 中的设置是非常关键的,它们会改变 MyBatis 的运行时行为。下表描述了设置中各项的意图、默认值等。</p>
9595

9696
<table>
@@ -393,7 +393,7 @@ SqlSessionFactory factory = sqlSessionFactoryBuilder.build(reader, environment,
393393
</settings>]]></source>
394394

395395
</subsection>
396-
<subsection name="typeAliases">
396+
<subsection name="typeAliases" id="typeAliases">
397397
<p>类型别名是为 Java 类型命名的一个短的名字。它只和 XML 配置有关,存在的意义仅在于用来减少类完全限定名的冗余。例如:</p>
398398
<source><![CDATA[<typeAliases>
399399
<typeAlias alias="Author" type="domain.blog.Author"/>
@@ -649,7 +649,7 @@ public class Author {
649649
</tbody>
650650
</table>
651651
</subsection>
652-
<subsection name="typeHandlers">
652+
<subsection name="typeHandlers" id="typeHandlers">
653653
<p>无论是 MyBatis 在预处理语句(PreparedStatement)中设置一个参数时,还是从结果集中取出一个值时,都会用类型处理器将获取的值以合适的方式转换成 Java 类型。下表描述了一些默认的类型处理器。</p>
654654
<table>
655655
<thead>
@@ -1055,7 +1055,7 @@ public class GenericTypeHandler<E extends MyObject> extends BaseTypeHandler<E> {
10551055
<p>注意,这里的 select 语句强制使用 <code>resultMap</code> 来代替 <code>resultType</code>。</p>
10561056
</subsection>
10571057

1058-
<subsection name="对象工厂(objectFactory)">
1058+
<subsection name="对象工厂(objectFactory)" id="objectFactory">
10591059
<p>MyBatis 每次创建结果对象的新实例时,它都会使用一个对象工厂(ObjectFactory)实例来完成。默认的对象工厂需要做的仅仅是实例化目标类,要么通过默认构造方法,要么在参数映射存在的时候通过参数构造方法来实例化。如果想覆盖对象工厂的默认行为,则可以通过创建自己的对象工厂来实现。比如:</p>
10601060
<source><![CDATA[// ExampleObjectFactory.java
10611061
public class ExampleObjectFactory extends DefaultObjectFactory {
@@ -1080,7 +1080,7 @@ public class ExampleObjectFactory extends DefaultObjectFactory {
10801080
<p>ObjectFactory 接口很简单,它包含两个创建用的方法,一个是处理默认构造方法的,另外一个是处理带参数的构造方法的。最后,setProperties 方法可以被用来配置 ObjectFactory,在初始化你的 ObjectFactory 实例后,objectFactory 元素体中定义的属性会被传递给 setProperties 方法。</p>
10811081

10821082
</subsection>
1083-
<subsection name="插件(plugins)">
1083+
<subsection name="插件(plugins)" id="plugins">
10841084
<p>
10851085
MyBatis 允许你在已映射语句执行过程中的某一点进行拦截调用。默认情况下,MyBatis 允许使用插件来拦截的方法调用包括:
10861086
</p>
@@ -1135,7 +1135,7 @@ public class ExamplePlugin implements Interceptor {
11351135
</p>
11361136
<p>除了用插件来修改 MyBatis 核心行为之外,还可以通过完全覆盖配置类来达到目的。只需继承后覆盖其中的每个方法,再把它传递到 sqlSessionFactoryBuilder.build(myConfig) 方法即可。再次重申,这可能会严重影响 MyBatis 的行为,务请慎之又慎。</p>
11371137
</subsection>
1138-
<subsection name="配置环境(environments)">
1138+
<subsection name="配置环境(environments)" id="environments">
11391139
<p>MyBatis 可以配置成适应多种环境,这种机制有助于将 SQL 映射应用于多种数据库之中,现实情况下有多种理由需要这么做。例如,开发、测试和生产环境需要有不同的配置;或者共享相同 Schema 的多个生产数据库,想使用相同的 SQL 映射。许多类似的用例。</p>
11401140
<p>
11411141
<strong>不过要记住:尽管可以配置多个环境,每个 SqlSessionFactory 实例只能选择其一。</strong>
@@ -1329,7 +1329,7 @@ public class C3P0DataSourceFactory extends UnpooledDataSourceFactory {
13291329

13301330
</subsection>
13311331

1332-
<subsection name="databaseIdProvider">
1332+
<subsection name="databaseIdProvider" id="databaseIdProvider">
13331333
<p>MyBatis 可以根据不同的数据库厂商执行不同的语句,这种多厂商的支持是基于映射语句中的 <code>databaseId</code> 属性的。MyBatis 会加载不带 <code>databaseId</code> 属性和带有匹配当前数据库 <code>databaseId</code> 属性的所有语句。如果同时找到带有 <code>databaseId</code> 和不带 <code>databaseId</code> 的相同语句,则后者会被舍弃。为支持多厂商特性只要像下面这样在 mybatis-config.xml 文件中加入 <code>databaseIdProvider</code> 即可:</p>
13341334

13351335
<source><![CDATA[<databaseIdProvider type="DB_VENDOR" />
@@ -1354,7 +1354,7 @@ public class C3P0DataSourceFactory extends UnpooledDataSourceFactory {
13541354

13551355
</subsection>
13561356

1357-
<subsection name="映射器(mappers)">
1357+
<subsection name="映射器(mappers)" id="mappers">
13581358
<p>既然 MyBatis 的行为已经由上述元素配置完了,我们现在就要定义 SQL 映射语句了。但是首先我们需要告诉 MyBatis 到哪里去找到这些语句。Java 在自动查找这方面没有提供一个很好的方法,所以最佳的方式是告诉 MyBatis 到哪里去找映射文件。你可以使用相对于类路径的资源引用,或完全限定资源定位符(包括 <code>file:///</code> 的 URL),或类名和包名等。例如:</p>
13591359
<source><![CDATA[<!-- Using classpath relative resources -->
13601360
<mappers>

src/site/zh/xdoc/sqlmap-xml.xml

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -73,7 +73,7 @@
7373
</ul>
7474
<p>下一部分将从语句本身开始来描述每个元素的细节。</p>
7575

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

@@ -204,7 +204,7 @@ ps.setInt(1,id);]]></source>
204204
</table>
205205
</subsection>
206206

207-
<subsection name="insert, update 和 delete">
207+
<subsection name="insert, update 和 delete" id="insert_update_and_delete">
208208
<p>
209209
数据变更语句 insert,update 和 delete 的实现非常接近:
210210
</p>
@@ -407,7 +407,7 @@ ps.setInt(1,id);]]></source>
407407
</select>]]></source>
408408
</subsection>
409409

410-
<subsection name="参数(Parameters)">
410+
<subsection name="参数(Parameters)" id="Parameters">
411411
<p>前面的所有语句中你所见到的都是简单参数的例子,实际上参数是 MyBatis 非常强大的元素,对于简单的做法,大概 90% 的情况参数都很少,比如:
412412
</p>
413413

@@ -489,7 +489,7 @@ ps.setInt(1,id);]]></source>
489489
</p>
490490
</subsection>
491491

492-
<subsection name="Result Maps">
492+
<subsection name="Result Maps" id="Result_Maps">
493493
<p>
494494
resultMap 元素是 MyBatis 中最重要最强大的元素。它就是让你远离 90%的需要从结果
495495
集中取出数据的 JDBC 代码的那个东西,
@@ -1637,7 +1637,7 @@ MyBatis 会从结果集中得到每条记录,
16371637

16381638
</subsection>
16391639

1640-
<subsection name="自动映射">
1640+
<subsection name="自动映射" id="Auto-mapping">
16411641

16421642
<p>
16431643
正如你在前面一节看到的,在简单的场景下,MyBatis可以替你自动映射查询结果。
@@ -1735,7 +1735,7 @@ MyBatis 会从结果集中得到每条记录,
17351735

17361736
</subsection>
17371737

1738-
<subsection name="缓存">
1738+
<subsection name="缓存" id="cache">
17391739
<p>
17401740
MyBatis 包含一个非常强大的查询缓存特性,它可以非常方便地配置和定制。MyBatis 3
17411741
中的缓存实现的很多改进都已经实现了,使得它更加强大而且易于配置。

0 commit comments

Comments
 (0)