From 3bfe65c5087006f07b9539fb41337fd12bdfcbc5 Mon Sep 17 00:00:00 2001 From: Kazuki Shimizu Date: Fri, 1 Nov 2019 23:34:52 +0900 Subject: [PATCH] Update document for gh-1698 --- src/site/es/xdoc/java-api.xml | 6 +++--- src/site/ja/xdoc/java-api.xml | 6 ++++-- src/site/ko/xdoc/java-api.xml | 6 ++++-- src/site/xdoc/java-api.xml | 9 +++++---- src/site/zh/xdoc/java-api.xml | 4 ++-- 5 files changed, 18 insertions(+), 13 deletions(-) diff --git a/src/site/es/xdoc/java-api.xml b/src/site/es/xdoc/java-api.xml index 39081b53781..58823e116e9 100644 --- a/src/site/es/xdoc/java-api.xml +++ b/src/site/es/xdoc/java-api.xml @@ -203,7 +203,7 @@ int delete(String statement, Object parameter)]]> int insert(String statement) int update(String statement) int delete(String statement)]]> - +

A Cursor offers the same results as a List, except it fetches data lazily using an Iterator.

entities = session.selectCursor(statement, param)) { for (MyEntity entity:entities) { @@ -353,7 +353,7 @@ void rollback(boolean force)
  • <idArg>
    • - Un argumento que es parte de un ConstructorArgs. Atributos: id, column, javaType, jdbcType, typeHandler, select and resultMap. El atributo id es un valor booleano que identifica la propiedad que será usada en las comparaciones, parecido al elemento XML <idArg>. + Un argumento que es parte de un ConstructorArgs. Atributos: id, column, javaType, jdbcType, typeHandler, select and resultMap. El atributo id es un valor booleano que identifica la propiedad que será usada en las comparaciones, parecido al elemento XML <idArg>. Since 3.5.4, it can be used as repeatable annotation. @TypeDiscriminator @@ -382,7 +382,7 @@ void rollback(boolean force)
  • <id>
    • - Un result mapping entre una columna y una propiedad o campo. Atributos: : id, column, property, javaType, jdbcType, typeHandler, one, many. El atributo id es un valor booleano que indica que la propiedad debe usarse en comparaciones (similar al <id> de los mapeos XML). El atributo one sirve para asociaciones de simples, similar al <association>, y el atributo many es para colecciones, similar al <collection>. Sus denominaciones son tales para evitar conflictos con nombres de clases. + Un result mapping entre una columna y una propiedad o campo. Atributos: : id, column, property, javaType, jdbcType, typeHandler, one, many. El atributo id es un valor booleano que indica que la propiedad debe usarse en comparaciones (similar al <id> de los mapeos XML). El atributo one sirve para asociaciones de simples, similar al <association>, y el atributo many es para colecciones, similar al <collection>. Sus denominaciones son tales para evitar conflictos con nombres de clases. Since 3.5.4, it can be used as repeatable annotation. @One diff --git a/src/site/ja/xdoc/java-api.xml b/src/site/ja/xdoc/java-api.xml index 40f836f8f6e..6c13aa79c42 100644 --- a/src/site/ja/xdoc/java-api.xml +++ b/src/site/ja/xdoc/java-api.xml @@ -356,7 +356,8 @@ void rollback(boolean force) ConstructorArgs に含まれる個々のコンストラクター引数です。属性: id, column, javaType, jdbcType, typeHandler, select, - resultMap. id は真偽値で、指定したプロパティがオブジェクトをユニークに識別できる値であることを表します。この働きは XML 要素の <idArg> に相当します。 + resultMap. id は真偽値で、指定したプロパティがオブジェクトをユニークに識別できる値であることを表します。この働きは XML 要素の <idArg> に相当します。 + 3.5.4以降では、繰り返し可能な注釈として使用することができます。 @TypeDiscriminator @@ -389,7 +390,8 @@ void rollback(boolean force) ある結果列とプロパティまたはフィールドのマッピング情報を定義します。属性: id, column, property, javaType, jdbcType, typeHandler, one, - many. id は真偽値で、そのプロパティがオブジェクトの比較に使うよう指示します（XML マッピングにおける id 要素とほぼ同じです）。one は XML における association 要素に、many は collection 要素に相当します（クラス名のコンフリクトを避けるため異なる名称が使われています）。 + many. id は真偽値で、そのプロパティがオブジェクトの比較に使うよう指示します（XML マッピングにおける id 要素とほぼ同じです）。one は XML における association 要素に、many は collection 要素に相当します（クラス名のコンフリクトを避けるため異なる名称が使われています）。 + 3.5.4以降では、繰り返し可能な注釈として使用することができます。 @One diff --git a/src/site/ko/xdoc/java-api.xml b/src/site/ko/xdoc/java-api.xml index 09295403ed0..ddff7f06f07 100644 --- a/src/site/ko/xdoc/java-api.xml +++ b/src/site/ko/xdoc/java-api.xml @@ -454,7 +454,8 @@ void rollback(boolean force) ConstructorArgs 의 일부로 한개의 생성자 인자 사용가능한 속성들 : id, column, javaType, jdbcType, typeHandler, select 그리고 resultMap. id 속성은 비교하기 위해 사용되는 값이다. - XML에서는 <idArg> 엘리먼트와 유사하다. + XML에서는 <idArg> 엘리먼트와 유사하다. + Since 3.5.4, it can be used as repeatable annotation. @TypeDiscriminator @@ -494,7 +495,8 @@ void rollback(boolean force) id 속성은 프로퍼티를 비교할 때 사용할지를 표시하는 boolean 값이다. (XML 에서 <id> 와 유사하다.) one 속성은 한개의 관계(associations)이고 <association> 과 유사하다. many 속성은 collection이고 <collection> 과 유사하다. - 클래스의 명명규칙 충돌을 피하기 위해 명명되었다. + 클래스의 명명규칙 충돌을 피하기 위해 명명되었다. + Since 3.5.4, it can be used as repeatable annotation. @One diff --git a/src/site/xdoc/java-api.xml b/src/site/xdoc/java-api.xml index 607a664a23c..2f257faa824 100644 --- a/src/site/xdoc/java-api.xml +++ b/src/site/xdoc/java-api.xml @@ -209,14 +209,14 @@ int delete(String statement, Object parameter)]]> int insert(String statement) int update(String statement) int delete(String statement)]]> - +

    A Cursor offers the same results as a List, except it fetches data lazily using an Iterator.

    entities = session.selectCursor(statement, param)) { for (MyEntity entity : entities) { // process one entity } }]]> - +

    Finally, there are three advanced versions of the select methods that allow you to restrict the range of rows to return, or provide custom result handling logic, usually for very large data sets.

    List selectList (String statement, Object parameter, RowBounds rowBounds) Cursor selectCursor(String statement, Object parameter, RowBounds rowBounds) @@ -372,7 +372,7 @@ void rollback(boolean force) A single constructor argument that is part of a ConstructorArgs collection. Attributes: id, column, javaType, jdbcType, typeHandler, select, resultMap. The id attribute is a boolean value that identifies the property to be used for comparisons, - similar to the <idArg> XML element. + similar to the <idArg> XML element. Since 3.5.4, it can be used as repeatable annotation. @TypeDiscriminator @@ -410,7 +410,8 @@ void rollback(boolean force) many. The id attribute is a boolean value that indicates that the property should be used for comparisons (similar to <id> in the XML mappings). The one attribute is for single associations, similar to <association>, and the many attribute - is for collections, similar to <collection>. They are named as they are to avoid class naming conflicts. + is for collections, similar to <collection>. They are named as they are to avoid class naming conflicts. + Since 3.5.4, it can be used as repeatable annotation. @One diff --git a/src/site/zh/xdoc/java-api.xml b/src/site/zh/xdoc/java-api.xml index 0293f857c18..8390e54f226 100644 --- a/src/site/zh/xdoc/java-api.xml +++ b/src/site/zh/xdoc/java-api.xml @@ -360,7 +360,7 @@ void rollback(boolean force)
  • <idArg>
    • - 单参数构造方法，是 ConstructorArgs 集合的一部分。属性有：id, column, javaType, jdbcType, typeHandler, select 和 resultMap。id 属性是布尔值，来标识用于比较的属性，和<idArg> XML 元素相似。 + 单参数构造方法，是 ConstructorArgs 集合的一部分。属性有：id, column, javaType, jdbcType, typeHandler, select 和 resultMap。id 属性是布尔值，来标识用于比较的属性，和<idArg> XML 元素相似。Since 3.5.4, it can be used as repeatable annotation. @TypeDiscriminator @@ -389,7 +389,7 @@ void rollback(boolean force)
  • <id>
    • - 在列和属性或字段之间的单独结果映射。属性有：id, column, javaType, jdbcType, typeHandler, one, many。id 属性是一个布尔值，来标识应该被用于比较（和在 XML 映射中的<id>相似）的属性。one 属性是单独的联系，和 <association> 相似，而 many 属性是对集合而言的，和<collection>相似。它们这样命名是为了避免名称冲突。 + 在列和属性或字段之间的单独结果映射。属性有：id, column, javaType, jdbcType, typeHandler, one, many。id 属性是一个布尔值，来标识应该被用于比较（和在 XML 映射中的<id>相似）的属性。one 属性是单独的联系，和 <association> 相似，而 many 属性是对集合而言的，和<collection>相似。它们这样命名是为了避免名称冲突。Since 3.5.4, it can be used as repeatable annotation. @One