Skip to content

Commit 84af95f

Browse files
committed
Update documentation for gh-1829
1 parent 3558137 commit 84af95f

File tree

7 files changed

+16
-4
lines changed

7 files changed

+16
-4
lines changed

src/main/java/org/apache/ibatis/annotations/Many.java

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -37,6 +37,7 @@
3737
* Returns the columnPrefix.
3838
*
3939
* @return the columnPrefix.
40+
* @since 3.5.5
4041
*/
4142
String columnPrefix() default "";
4243

src/main/java/org/apache/ibatis/annotations/One.java

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -37,6 +37,7 @@
3737
* Returns the columnPrefix.
3838
*
3939
* @return the columnPrefix.
40+
* @since 3.5.5
4041
*/
4142
String columnPrefix() default "";
4243

src/site/es/xdoc/java-api.xml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -392,6 +392,7 @@ void rollback(boolean force)</source>
392392
Un mapeo a una propiedad que contiene un tipo complejo. Atributos: select, que contiene el nombre completamente cualificado de un mapped statement (o un método de mapper) que puede cargar la instancia del tipo indicado.
393393
<code>fetchType</code>, que sobrescribe el parámetro global de configuración <code>lazyLoadingEnabled</code> para este mapeo.
394394
<code>resultMap</code>(available since 3.5.5), which is the fully qualified name of a result map that map to a single container object from select result.
395+
<code>columnPrefix</code>(available since 3.5.5), which is column prefix for grouping select columns at nested result map.
395396
Nota: Habrás visto que el mapeo de tipo join no se soporta mediante el API de anotaciones. Esto es debido a las limitaciones de las anotaciones en Java que no permiten referencias circulares.</td>
396397
</tr>
397398
<tr>
@@ -401,6 +402,7 @@ void rollback(boolean force)</source>
401402
<td>Un mapeo a una propiedad que contiene una colección de tipos complejos. Atributos: select, que contiene el nombre completamente cualificado de un mapped statement (o un método de mapper) que puede cargar la instancia del tipo indicado.
402403
<code>fetchType</code>, que sobrescribe el parámetro global de configuración <code>lazyLoadingEnabled</code> para este mapeo.
403404
<code>resultMap</code>(available since 3.5.5), which is the fully qualified name of a result map that map to collection object from select result.
405+
<code>columnPrefix</code>(available since 3.5.5), which is column prefix for grouping select columns at nested result map.
404406
Nota: Habrás visto que el mapeo de tipo join no se soporta mediante el API de anotaciones. Esto es debido a las limitaciones de las anotaciones en Java que no permiten referencias circulares.</td>
405407
</tr>
406408
<tr>

src/site/ja/xdoc/java-api.xml

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -397,20 +397,22 @@ void rollback(boolean force)</source>
397397
<td><code>@One</code></td>
398398
<td>N/A</td>
399399
<td><code>&lt;association&gt;</code></td>
400-
<td>複雑型のプロパティのマッピング情報を定義します。属性: <code>select</code>, <code>fetchType</code>, <code>resultMap</code>(3.5.5以降で利用可能).
400+
<td>複雑型のプロパティのマッピング情報を定義します。属性: <code>select</code>, <code>fetchType</code>, <code>resultMap</code>(3.5.5以降で利用可能), <code>columnPrefix</code>(3.5.5以降で利用可能).
401401
select は適切な型を読み込むことができるマップドステートメント(Mapper メソッド)の完全修飾名です。
402402
fetchType はグローバルな設定 <code>lazyLoadingEnabled</code> をオーバーライドする場合に指定します。
403403
resultMap は結果列を単一のコンテナオブジェクト(JavaBeanなど)へマッピングするための結果マップの完全修飾名を指定します。
404+
columnPrefix はネストした結果マップで結果列をグループ化するためのカラム名のプレフィックスを指定します。
404405
<span class="label important">NOTE</span> アノテーション API では結合マッピングがサポートされていません。これは Java アノテーションでは循環参照が許可されないためです。</td>
405406
</tr>
406407
<tr>
407408
<td><code>@Many</code></td>
408409
<td>N/A</td>
409410
<td><code>&lt;collection&gt;</code></td>
410-
<td>複雑型のプロパティのマッピング情報を定義します。属性: <code>select</code>, <code>fetchType</code>, <code>resultMap</code>(3.5.5以降で利用可能).
411+
<td>複雑型のプロパティのマッピング情報を定義します。属性: <code>select</code>, <code>fetchType</code>, <code>resultMap</code>(3.5.5以降で利用可能), <code>columnPrefix</code>(3.5.5以降で利用可能).
411412
select は適切な型のコレクションを読み込むことができるマップドステートメント(Mapper メソッド)の完全修飾名です。
412413
fetchType はグローバルな設定 <code>lazyLoadingEnabled</code> をオーバーライドする場合に指定します。
413414
resultMap は結果列をコレクションオブジェクト(JavaBeanのリストなど)へマッピングするための結果マップの完全修飾名を指定します。
415+
columnPrefix はネストした結果マップで結果列をグループ化するためのカラム名のプレフィックスを指定します。
414416
<span class="label important">NOTE</span> アノテーション API では結合マッピングがサポートされていません。これは Java アノテーションでは循環参照が許可されないためです。</td>
415417
</tr>
416418
<tr>

src/site/ko/xdoc/java-api.xml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -506,6 +506,7 @@ void rollback(boolean force)</source>
506506
사용가능한 속성들 : select(매핑 구문의 이름, 예를들어 매퍼 메소드).
507507
<code>fetchType</code>, which supersedes the global configuration parameter <code>lazyLoadingEnabled</code> for this mapping.
508508
<code>resultMap</code>(available since 3.5.5), which is the fully qualified name of a result map that map to a single container object from select result.
509+
<code>columnPrefix</code>(available since 3.5.5), which is column prefix for grouping select columns at nested result map.
509510
Note: 조인 매핑은 애노테이션 API 를 통해서는 지원되지 않는다는 것을 알아야 한다.
510511
순환(circular) 참조를 허용하지 않는 자바 애노테이션의 제약사항때문이다.</td>
511512
</tr>
@@ -517,6 +518,7 @@ void rollback(boolean force)</source>
517518
사용가능한 속성들 : select(매핑 구문의 이름, 예를들어 매퍼 메소드)
518519
<code>fetchType</code>, which supersedes the global configuration parameter <code>lazyLoadingEnabled</code> for this mapping.
519520
<code>resultMap</code>(available since 3.5.5), which is the fully qualified name of a result map that map to collection object from select result.
521+
<code>columnPrefix</code>(available since 3.5.5), which is column prefix for grouping select columns at nested result map.
520522
Note: 조인 매핑은 애노테이션 API 를 통해서는 지원되지 않는다는 것을 알아야 한다.
521523
순환(circular) 참조를 허용하지 않는 자바 애노테이션의 제약사항때문이다.</td>
522524
</tr>

src/site/xdoc/java-api.xml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -423,6 +423,7 @@ void rollback(boolean force)</source>
423423
mapping.
424424
<code>resultMap</code>(available since 3.5.5), which is the fully qualified name of a result map that map to
425425
a single container object from select result.
426+
<code>columnPrefix</code>(available since 3.5.5), which is column prefix for grouping select columns at nested result map.
426427
<span class="label important">NOTE</span> You will notice that join mapping is not supported via the Annotations API.
427428
This is due to the limitation in Java Annotations that does not allow for circular references.</td>
428429
</tr>
@@ -436,6 +437,7 @@ void rollback(boolean force)</source>
436437
mapping.
437438
<code>resultMap</code>(available since 3.5.5), which is the fully qualified name of a result map that map to
438439
collection object from select result.
440+
<code>columnPrefix</code>(available since 3.5.5), which is column prefix for grouping select columns at nested result map.
439441
<span class="label important">NOTE</span> You will notice that join mapping is not supported via the
440442
Annotations API. This is due to the limitation in Java Annotations that does not allow for circular references.</td>
441443
</tr>

src/site/zh/xdoc/java-api.xml

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -388,7 +388,8 @@ try (SqlSession session = sqlSessionFactory.openSession()) {
388388
       <td>复杂类型的单个属性映射。属性:
389389
<code>select</code>,指定可加载合适类型实例的映射语句(也就是映射器方法)全限定名;
390390
<code>fetchType</code>,指定在该映射中覆盖全局配置参数 <code>lazyLoadingEnabled</code>;
391-
<code>resultMap</code>(available since 3.5.5), which is the fully qualified name of a result map that map to a single container object from select result。
391+
<code>resultMap</code>(available since 3.5.5), which is the fully qualified name of a result map that map to a single container object from select result;
392+
<code>columnPrefix</code>(available since 3.5.5), which is column prefix for grouping select columns at nested result map.
392393
<span class="label important">提示</span> 注解 API 不支持联合映射。这是由于 Java 注解不允许产生循环引用。</td>
393394
</tr>
394395
<tr>
@@ -398,7 +399,8 @@ try (SqlSession session = sqlSessionFactory.openSession()) {
398399
       <td>复杂类型的集合属性映射。属性:
399400
<code>select</code>,指定可加载合适类型实例集合的映射语句(也就是映射器方法)全限定名;
400401
<code>fetchType</code>,指定在该映射中覆盖全局配置参数 <code>lazyLoadingEnabled</code>
401-
<code>resultMap</code>(available since 3.5.5), which is the fully qualified name of a result map that map to collection object from select result。
402+
<code>resultMap</code>(available since 3.5.5), which is the fully qualified name of a result map that map to collection object from select result;
403+
<code>columnPrefix</code>(available since 3.5.5), which is column prefix for grouping select columns at nested result map.
402404
<span class="label important">提示</span> 注解 API 不支持联合映射。这是由于 Java 注解不允许产生循环引用。</td>
403405
</tr>
404406
<tr>

0 commit comments

Comments
 (0)