Skip to content

Commit f61151b

Browse files
emacarronemacarron
committed
Wrong auto-mapping docs. Fixes #306.
1 parent 71257d0 commit f61151b

File tree

5 files changed

+28
-54
lines changed

5 files changed

+28
-54
lines changed

‎src/site/es/xdoc/sqlmap-xml.xml

Lines changed: 6 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1510,7 +1510,7 @@ SELECT * FROM POST WHERE BLOG_ID = #{id}]]></source>
15101510
presentes en el ResultSet y que no tienen un mapeo manual se auto-mapearán. Posteriormente se procesarán los mapeos manuales.
15111511
En el siguiente ejemplo las columnas <i>id</i> y <i>userName</i> se auto-mapearán y la columna <i>hashed_password</i> se mapeará manualmente.</p>
15121512

1513-
<source><![CDATA[<select id="selectUsers" resultType="User">
1513+
<source><![CDATA[<select id="selectUsers" resultMap="userResultMap">
15141514
select
15151515
user_id as "id",
15161516
user_name as "userName",
@@ -1555,7 +1555,7 @@ SELECT * FROM POST WHERE BLOG_ID = #{id}]]></source>
15551555
</select>]]></source>
15561556

15571557
<source><![CDATA[<resultMap id="blogResult" type="Blog">
1558-
<association property="author" javaType="Author" resultMap="authorResult"/>
1558+
<association property="author" resultMap="authorResult"/>
15591559
</resultMap>
15601560
15611561
<resultMap id="authorResult" type="Author">
@@ -1569,18 +1569,13 @@ SELECT * FROM POST WHERE BLOG_ID = #{id}]]></source>
15691569
</p>
15701570

15711571
<p>
1572-
Independientemente del nivel de auto-mapeo configurado puedes activar o desactivar el auto-mapeo para un statement especifico
1572+
Independientemente del nivel de auto-mapeo configurado puedes activar o desactivar el auto-mapeo para un ResultMap especifico
15731573
añadiendole el atributo<code>autoMapping</code>:
15741574
</p>
15751575

1576-
<source><![CDATA[<select id="selectUsers" resultType="User" autoMapping="false">
1577-
select
1578-
user_id as "id",
1579-
user_name as "userName",
1580-
hashed_password
1581-
from some_table
1582-
where id = #{id}
1583-
</select>]]></source>
1576+
<source><![CDATA[<resultMap id="userResultMap" type="User" autoMapping="false">
1577+
<result property="password" column="hashed_password"/>
1578+
</resultMap>]]></source>
15841579

15851580

15861581
</subsection>

‎src/site/ja/xdoc/sqlmap-xml.xml

Lines changed: 5 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1731,7 +1731,7 @@ SELECT * FROM POST WHERE BLOG_ID = #{id}]]></source>
17311731
次の例では、<i>hashed_password</i> 列が password プロパティにマップされ、<i>id</i> と <i>userName</i> 列が自動マッピングの対象となります。
17321732
</p>
17331733

1734-
<source><![CDATA[<select id="selectUsers" resultType="User">
1734+
<source><![CDATA[<select id="selectUsers" resultMap="userResultMap">
17351735
select
17361736
user_id as "id",
17371737
user_name as "userName",
@@ -1776,7 +1776,7 @@ SELECT * FROM POST WHERE BLOG_ID = #{id}]]></source>
17761776
</select>]]></source>
17771777

17781778
<source><![CDATA[<resultMap id="blogResult" type="Blog">
1779-
<association property="author" javaType="Author" resultMap="authorResult"/>
1779+
<association property="author" resultMap="authorResult"/>
17801780
</resultMap>
17811781
17821782
<resultMap id="authorResult" type="Author">
@@ -1787,20 +1787,14 @@ SELECT * FROM POST WHERE BLOG_ID = #{id}]]></source>
17871787
この Result Map では、<i>Blog</i> と <i>Author</i> の両方が自動マッピングの対象となりますが、<i>Author</i> に <i>id</i> というプロパティがあり、ResultSet に <i>id</i> という列が含まれているため、Author の id に Blog の id がセットされることになります。
17881788
自動マッピングで <code>FULL</code> を指定する場合は、こうした意図しないマッピングが行われないように注意する必要があります。
17891789
</p>
1790-
17911790

17921791
<p>
17931792
尚、グローバルな自動マッピング設定とは別に、<code>autoMapping</code> 属性を指定することで特定のステートメントでの自動マッピング動作を有効／無効化することもできます。
17941793
</p>
17951794

1796-
<source><![CDATA[<select id="selectUsers" resultType="User" autoMapping="false">
1797-
select
1798-
user_id as "id",
1799-
user_name as "userName",
1800-
hashed_password
1801-
from some_table
1802-
where id = #{id}
1803-
</select>]]></source>
1795+
<source><![CDATA[<resultMap id="userResultMap" type="User" autoMapping="false">
1796+
<result property="password" column="hashed_password"/>
1797+
</resultMap>]]></source>
18041798

18051799
</subsection>
18061800

‎src/site/ko/xdoc/sqlmap-xml.xml

Lines changed: 5 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1387,7 +1387,7 @@ vehicle 간의 관계를 알 수 있다. 그러므로, 나머지 프로퍼티들
13871387
이런 경우 각각의 결과매핑에서 ResultSet의 모든 칼럼은 자동매핑이 아니라 수동매핑으로 처리한다.
13881388
다음 샘플에서 <i>id</i> 와 <i>userName</i> 칼럼은 자동매핑되고 <i>hashed_password</i> 칼럼은 수동으로 매핑한다. </p>
13891389

1390-
<source><![CDATA[<select id="selectUsers" resultType="User">
1390+
<source><![CDATA[<select id="selectUsers" resultMap="userResultMap">
13911391
select
13921392
user_id as "id",
13931393
user_name as "userName",
@@ -1432,7 +1432,7 @@ vehicle 간의 관계를 알 수 있다. 그러므로, 나머지 프로퍼티들
14321432
</select>]]></source>
14331433

14341434
<source><![CDATA[<resultMap id="blogResult" type="Blog">
1435-
<association property="author" javaType="Author" resultMap="authorResult"/>
1435+
<association property="author" resultMap="authorResult"/>
14361436
</resultMap>
14371437
14381438
<resultMap id="authorResult" type="Author">
@@ -1450,14 +1450,9 @@ vehicle 간의 관계를 알 수 있다. 그러므로, 나머지 프로퍼티들
14501450
자동매핑 설정에 상관없이 구문별로 <code>autoMapping</code>속성을 추가해서 자동매핑을 사용하거나 사용하지 않을수도 있다.
14511451
</p>
14521452

1453-
<source><![CDATA[<select id="selectUsers" resultType="User" autoMapping="false">
1454-
select
1455-
user_id as "id",
1456-
user_name as "userName",
1457-
hashed_password
1458-
from some_table
1459-
where id = #{id}
1460-
</select>]]></source>
1453+
<source><![CDATA[<resultMap id="userResultMap" type="User" autoMapping="false">
1454+
<result property="password" column="hashed_password"/>
1455+
</resultMap>]]></source>
14611456

14621457
</subsection>
14631458

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

Lines changed: 6 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1887,7 +1887,7 @@ SELECT * FROM POST WHERE BLOG_ID = #{id}]]></source>
18871887
ResultSet that have not a manual mapping will be auto-mapped, then manual mappings will be processed.
18881888
In the following sample <i>id</i> and <i>userName</i> columns will be auto-mapped and <i>hashed_password</i> column will be mapped.</p>
18891889

1890-
<source><![CDATA[<select id="selectUsers" resultType="User">
1890+
<source><![CDATA[<select id="selectUsers" resultMap="userResultMap">
18911891
select
18921892
user_id as "id",
18931893
user_name as "userName",
@@ -1932,7 +1932,7 @@ SELECT * FROM POST WHERE BLOG_ID = #{id}]]></source>
19321932
</select>]]></source>
19331933

19341934
<source><![CDATA[<resultMap id="blogResult" type="Blog">
1935-
<association property="author" javaType="Author" resultMap="authorResult"/>
1935+
<association property="author" resultMap="authorResult"/>
19361936
</resultMap>
19371937
19381938
<resultMap id="authorResult" type="Author">
@@ -1946,18 +1946,13 @@ SELECT * FROM POST WHERE BLOG_ID = #{id}]]></source>
19461946
</p>
19471947

19481948
<p>
1949-
Regardless of the auto-mapping level configured you can enable or disable the automapping for an specific statement
1949+
Regardless of the auto-mapping level configured you can enable or disable the automapping for an specific ResultMap
19501950
by adding the attribute <code>autoMapping</code> to it:
19511951
</p>
19521952

1953-
<source><![CDATA[<select id="selectUsers" resultType="User" autoMapping="false">
1954-
select
1955-
user_id as "id",
1956-
user_name as "userName",
1957-
hashed_password
1958-
from some_table
1959-
where id = #{id}
1960-
</select>]]></source>
1953+
<source><![CDATA[<resultMap id="userResultMap" type="User" autoMapping="false">
1954+
<result property="password" column="hashed_password"/>
1955+
</resultMap>]]></source>
19611956

19621957
</subsection>
19631958
<subsection name="cache">

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

Lines changed: 6 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1661,7 +1661,7 @@ MyBatis 会从结果集中得到每条记录,
16611661
如果没有被手工映射，则将被自动映射。自动映射处理完毕后手工映射才会被处理。
16621662
在接下来的例子中， <i>id</i> 和 <i>userName</i>列将被自动映射， <i>hashed_password</i> 列将根据配置映射。
16631663
</p>
1664-
<source><![CDATA[<select id="selectUsers" resultType="User">
1664+
<source><![CDATA[<select id="selectUsers" resultMap="userResultMap">
16651665
select
16661666
user_id as "id",
16671667
user_name as "userName",
@@ -1706,7 +1706,7 @@ MyBatis 会从结果集中得到每条记录,
17061706
</select>]]></source>
17071707

17081708
<source><![CDATA[<resultMap id="blogResult" type="Blog">
1709-
<association property="author" javaType="Author" resultMap="authorResult"/>
1709+
<association property="author" resultMap="authorResult"/>
17101710
</resultMap>
17111711
17121712
<resultMap id="authorResult" type="Author">
@@ -1720,18 +1720,13 @@ MyBatis 会从结果集中得到每条记录,
17201720
</p>
17211721

17221722
<p>
1723-
Regardless of the auto-mapping level configured you can enable or disable the automapping for an specific statement
1723+
Regardless of the auto-mapping level configured you can enable or disable the automapping for an specific ResultMap
17241724
by adding the attribute <code>autoMapping</code> to it:
17251725
</p>
17261726

1727-
<source><![CDATA[<select id="selectUsers" resultType="User" autoMapping="false">
1728-
select
1729-
user_id as "id",
1730-
user_name as "userName",
1731-
hashed_password
1732-
from some_table
1733-
where id = #{id}
1734-
</select>]]></source>
1727+
<source><![CDATA[<resultMap id="userResultMap" type="User" autoMapping="false">
1728+
<result property="password" column="hashed_password"/>
1729+
</resultMap>]]></source>
17351730

17361731
</subsection>
17371732

0 commit comments

Comments
 (0)