Skip to content

Commit fd20995

Browse files
harawataharawata
committed
Replicated the doc change 20f8f7b (incomplete translation in es, ko, zh). [ci skip]
1 parent 3730e83 commit fd20995

File tree

8 files changed

+52
-26
lines changed

8 files changed

+52
-26
lines changed

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -443,7 +443,7 @@ try (SqlSession session = sqlSessionFactory.openSession()) {
443443
<td><code>@SelectKey</code></td>
444444
<td><code>Method</code></td>
445445
<td><code>&lt;selectKey&gt;</code></td>
446-
<td>Esta anotación es igual que la &lt;selectKey&gt; para métodos anotados con @Insert o @InsertProvider. Se ignora en otros métodos. Si especificas la anotación @SelectKey, entonces MyBatis ignorará todas las propiedades de generación de claves proporcionadas por la anotación @Options, o mediante propiedades de configuración. Atributos: statement un array de strings que contienen la SQL a ejecutar, keyProperty que es la propiedad del objeto parámetro que se actualizará con el Nuevo valor, before que debe valer true o false para indicar si la sentencia SQL debe ejecutarse antes o después de la insert, resultType que es el tipo de la propiedad keyProperty, y statementType=PREPARED.</td>
446+
<td>Esta anotación es igual que la &lt;selectKey&gt; para métodos anotados con @Insert, @InsertProvider, @Update o @UpdateProvider. Se ignora en otros métodos. Si especificas la anotación @SelectKey, entonces MyBatis ignorará todas las propiedades de generación de claves proporcionadas por la anotación @Options, o mediante propiedades de configuración. Atributos: statement un array de strings que contienen la SQL a ejecutar, keyProperty que es la propiedad del objeto parámetro que se actualizará con el Nuevo valor, before que debe valer true o false para indicar si la sentencia SQL debe ejecutarse antes o después de la insert, resultType que es el tipo de la propiedad keyProperty, y statementType=PREPARED.</td>
447447
</tr>
448448
<tr>
449449
<td><code>@ResultMap</code></td>

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

Lines changed: 13 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -276,18 +276,18 @@ ps.setInt(1,id);]]></source>
276276
</tr>
277277
<tr>
278278
<td><code>useGeneratedKeys</code></td>
279-
<td>(solo en insert) Indica a MyBatis que utilice el método getGeneratedKeys de JDBC para recuperar las claves autogeneras automáticamente por la base de datos. (ej. campos autoincrementales en SGBD como MySQL o SQL Server). Por defecto: false
279+
<td>(solo en insert y update) Indica a MyBatis que utilice el método getGeneratedKeys de JDBC para recuperar las claves autogeneras automáticamente por la base de datos. (ej. campos autoincrementales en SGBD como MySQL o SQL Server). Por defecto: false
280280
</td>
281281
</tr>
282282
<tr>
283283
<td><code>keyProperty</code></td>
284-
<td>(solo en insert) Indica la propiedad a la que MyBatis debe asignar la clave autogenerada devuelva por getGeneratedKeys o por un elemento hijo de tipo selectKey. Por defecto: no informado.
284+
<td>(solo en insert y update) Indica la propiedad a la que MyBatis debe asignar la clave autogenerada devuelva por getGeneratedKeys o por un elemento hijo de tipo selectKey. Por defecto: no informado. Can be a comma separated list of property names if multiple generated columns are expected.
285285
</td>
286286
</tr>
287287
<tr>
288288
<td><code>keyColumn</code></td>
289-
<td>(solo en insert) Indica el nombre de la columna en tabla con clave generada. Solo se requiere en algunas bases de datos (como PostgreSQL) donde la
290-
columna clave no es la primera de la tabla.
289+
<td>(solo en insert y update) Indica el nombre de la columna en tabla con clave generada. Solo se requiere en algunas bases de datos (como PostgreSQL) donde la
290+
columna clave no es la primera de la tabla. Can be a comma separated list of columns names if multiple generated columns are expected.
291291
</td>
292292
</tr>
293293
<tr>
@@ -369,7 +369,15 @@ Por ejemplo, si la columna id de la tabla Author del ejemplo siguiente fuera aut
369369
<tbody>
370370
<tr>
371371
<td><code>keyProperty</code></td>
372-
<td>La propiedad destino con la que debe informarse el resultado del selectKey statement.</td>
372+
<td>La propiedad destino con la que debe informarse el resultado del selectKey statement. Can be a comma separated list of property names if multiple generated columns are expected.
373+
</td>
374+
</tr>
375+
<tr>
376+
<td><code>keyColumn</code></td>
377+
<td>The column name(s) in the returned result set that match the properties.
378+
Can be a comma separated list of column names if multiple generated columns
379+
are expected.
380+
</td>
373381
</tr>
374382
<tr>
375383
<td><code>resultType</code></td>

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -466,7 +466,7 @@ try (SqlSession session = sqlSessionFactory.openSession()) {
466466
<td><code>@SelectKey</code></td>
467467
<td><code>Method</code></td>
468468
<td><code>&lt;selectKey&gt;</code></td>
469-
<td>このアノテーションを <code>@Insert</code> or <code>@InsertProvider</code> が付加されたメソッドに追加することで、XML の <code>&lt;selectKey&gt;</code> に相当する機能を実現することができます（他のメソッドに追加しても無視されます）。<code>@SelectKey</code> アノテーションが指定されている場合、<code>@Options</code> アノテーションや設定プロパティによるキーの自動生成に関する設定は無視されます。
469+
<td>このアノテーションを <code>@Insert</code>, <code>@InsertProvider</code>, <code>@Update</code>, <code>@UpdateProvider</code> が付加されたメソッドに追加することで、XML の <code>&lt;selectKey&gt;</code> に相当する機能を実現することができます（他のメソッドに追加しても無視されます）。<code>@SelectKey</code> アノテーションが指定されている場合、<code>@Options</code> アノテーションや設定プロパティによるキーの自動生成に関する設定は無視されます。
470470
属性: <code>statement</code> SQL ステートメントを構成する String の配列です。 <code>keyProperty</code> は自動生成されたキーの値が設定される引数オブジェクトのプロパティを指定します。<code>before</code> insert の前にステートメントを実行する場合は true、後に実行する場合は false を指定します。<code>resultType</code> は keyProperty で指定したプロパティの Java タイプです。<code>statementType</code> はステートメントの種類で STATEMENT, PREPARED, CALLABLE のいずれかを指定します（デフォルトは PREPARED）。</td>
471471
</tr>
472472
<tr>

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

Lines changed: 9 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -315,18 +315,18 @@ ps.setInt(1,id);]]></source>
315315
</tr>
316316
<tr>
317317
<td>useGeneratedKeys</td>
318-
<td>（insert のみ）MyBatis に対して、JDBC の getGeneratedKeys メソッドを使ってデータベース側で自動生成されたキーを取得するよう指示します（例えば MySQL や SQL Server のような RDBMS における auto increment が設定された列の値が取得できます）。デフォルト値は false です。
318+
<td>（insert, update のみ）MyBatis に対して、JDBC の getGeneratedKeys メソッドを使ってデータベース側で自動生成されたキーを取得するよう指示します（例えば MySQL や SQL Server のような RDBMS における auto increment が設定された列の値が取得できます）。デフォルト値は false です。
319319
</td>
320320
</tr>
321321
<tr>
322322
<td>keyProperty</td>
323323
<td>
324-
（insert のみ）getGeneratedKeys メソッドまたは selectKey 要素で指定されたクエリによって取得したキーの値は、ここで指定したプロパティにセットされます。
324+
（insert, update のみ）getGeneratedKeys メソッドまたは selectKey 要素で指定されたクエリによって取得したキーの値は、ここで指定したプロパティにセットされます。カンマ区切りでの複数指定にも対応しています。
325325
</td>
326326
</tr>
327327
<tr>
328328
<td>keyColumn</td>
329-
<td>（insert のみ）テーブル内で自動生成が設定されている列の名前を指定します。この設定は、特定のデータベース（例えば PostgreSQL）で、テーブルの先頭以外の列にキーの自動生成が設定されている場合にのみ必要となります。
329+
<td>（insert, update のみ）テーブル内で自動生成が設定されている列の名前を指定します。この設定は、特定のデータベース（例えば PostgreSQL）で、テーブルの先頭以外の列にキーの自動生成が設定されている場合にのみ必要となります。カンマ区切りでの複数指定にも対応しています。
330330
</td>
331331
</tr>
332332
<tr>
@@ -414,12 +414,16 @@ ps.setInt(1,id);]]></source>
414414
<tbody>
415415
<tr>
416416
<td>keyProperty</td>
417-
<td>selectKey ステートメントの結果がセットされるプロパティを指定します。</td>
417+
<td>selectKey ステートメントの結果がセットされるプロパティを指定します。カンマ区切りでの複数指定にも対応しています。</td>
418+
</tr>
419+
<tr>
420+
<td>keyColumn</td>
421+
<td>プロパティに対応する結果セット中の列名を指定します。カンマ区切りでの複数指定にも対応しています。</td>
418422
</tr>
419423
<tr>
420424
<td>resultType</td>
421425
<td>
422-
結果の型を指定します。ほとんどの場合、MyBatis は自動的に型を推測することができますが、念のため設定しておいても害はありません。文字列も含めて、任意の単純型を指定することができます。
426+
結果の型を指定します。ほとんどの場合、MyBatis は自動的に型を推測することができますが、念のため設定しておいても害はありません。文字列も含めて、任意の単純型を指定することができます。複数の列が自動生成対象となっている場合、対応するプロパティを持つクラスあるいは Map を指定することができます。
423427
</td>
424428
</tr>
425429
<tr>

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -585,7 +585,7 @@ Note: 이 섹션은 SelectBuilder 클래스에 대한
585585
<td><code>@SelectKey</code></td>
586586
<td><code>Method</code></td>
587587
<td><code>&lt;selectKey&gt;</code></td>
588-
<td>이 애노테이션은 @Insert 또는 @InsertProvider
588+
<td>이 애노테이션은 @Insert, @InsertProvider, @Update 또는 @UpdateProvider
589589
애노테이션을 사용하는 메서드에서 &lt;selectKey&gt;와
590590
똑같다. 다른 메서드에서는 무시된다. @SelectKey
591591
애노테이션을 명시하면, MyBatis 는 @Options

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

Lines changed: 13 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -253,19 +253,19 @@ ps.setInt(1,id);]]></source>
253253
</tr>
254254
<tr>
255255
<td><code>useGeneratedKeys</code></td>
256-
<td>(입력(insert)에만 적용) 데이터베이스에서 내부적으로 생성한 키(예를 들어, MySQL 또는 SQL
256+
<td>(입력(insert, update)에만 적용) 데이터베이스에서 내부적으로 생성한 키(예를 들어, MySQL 또는 SQL
257257
Server 와 같은 RDBMS 의 자동 증가 필드)를 받는 JDBC getGeneratedKeys 메서드를
258258
사용하도록 설정하다. 디폴트는 false 이다.</td>
259259
</tr>
260260
<tr>
261261
<td><code>keyProperty</code></td>
262-
<td>(입력(insert)에만 적용) getGeneratedKeys 메서드나 insert 구문의 selectKey 하위 요소에 의해
263-
리턴된 키를 셋팅할 프로퍼티를 지정. 디폴트는 셋팅하지 않는 것이다.</td>
262+
<td>(입력(insert, update)에만 적용) getGeneratedKeys 메서드나 insert 구문의 selectKey 하위 요소에 의해
263+
리턴된 키를 셋팅할 프로퍼티를 지정. 디폴트는 셋팅하지 않는 것이다. Can be a comma separated list of property names if multiple generated columns are expected.</td>
264264
</tr>
265265
<tr>
266266
<td><code>keyColumn</code></td>
267-
<td>(입력(insert)에만 적용) 생성키를 가진 테이블의 칼럼명을 셋팅. 키 칼럼이 테이블이 첫번째 칼럼이
268-
아닌 데이터베이스(PostgreSQL 처럼)에서만 필요하다.</td>
267+
<td>(입력(insert, update)에만 적용) 생성키를 가진 테이블의 칼럼명을 셋팅. 키 칼럼이 테이블이 첫번째 칼럼이
268+
아닌 데이터베이스(PostgreSQL 처럼)에서만 필요하다. Can be a comma separated list of columns names if multiple generated columns are expected.</td>
269269
</tr>
270270
<tr>
271271
<td><code>databaseId</code></td>
@@ -341,7 +341,14 @@ Server 와 같은 RDBMS 의 자동 증가 필드)를 받는 JDBC getGeneratedKey
341341
<tbody>
342342
<tr>
343343
<td><code>keyProperty</code></td>
344-
<td>selectKey 구문의 결과가 셋팅될 대상 프로퍼티</td>
344+
<td>selectKey 구문의 결과가 셋팅될 대상 프로퍼티. Can be a comma separated list of property names if multiple generated columns are expected.</td>
345+
</tr>
346+
<tr>
347+
<td><code>keyColumn</code></td>
348+
<td>The column name(s) in the returned result set that match the properties.
349+
Can be a comma separated list of column names if multiple generated columns
350+
are expected.
351+
</td>
345352
</tr>
346353
<tr>
347354
<td><code>resultType</code></td>

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -771,7 +771,7 @@ type,method。type 属性是类的完全限
771771
<td><code>Method</code></td>
772772
<td><code>&lt;selectKey&gt;</code></td>
773773
<td>This annotation duplicates the <code>&lt;selectKey&gt;</code> functionality for methods annotated with
774-
<code>@Insert</code> or <code>@InsertProvider</code>. It is ignored for other methods. If you specify a
774+
<code>@Insert</code>, <code>@InsertProvider</code>, <code>@Update</code> or <code>@UpdateProvider</code>. It is ignored for other methods. If you specify a
775775
<code>@SelectKey</code> annotation, then MyBatis will ignore any generated key properties set via the
776776
<code>@Options</code> annotation, or configuration properties.
777777
Attributes: statement an array of strings which is the SQL statement to execute, <code>keyProperty</code> which

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

Lines changed: 13 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -352,7 +352,7 @@ TEMENT,PREPARED 或 CALLABLE 的一种。这会让 MyBatis
352352
<tr>
353353
<td><code>useGeneratedKeys</code></td>
354354
<td>
355-
( 仅 对 insert 有 用 ) 这 会 告 诉 MyBatis 使 用 JDBC 的
355+
( 仅 对 insert, update 有 用 ) 这 会 告 诉 MyBatis 使 用 JDBC 的
356356
getGeneratedKeys 方法来取出由数据(比如:像 MySQL 和 SQL
357357
Server 这样的数据库管理系统的自动递增字段)内部生成的主键。
358358
默认值:false。
@@ -361,23 +361,23 @@ Server 这样的数据库管理系统的自动递增字段)内部生成的主键
361361
<tr>
362362
<td><code>keyProperty</code></td>
363363
<td>
364-
(仅对 insert 有用)
364+
(仅对 insert, update 有用)
365365
标记一个属性,
366366
MyBatis 会通过 getGeneratedKeys
367367
或者通过 insert 语句的 selectKey 子元素设置它的值。
368368
默认:
369-
不设置。
369+
不设置。 Can be a comma separated list of property names if multiple generated columns are expected.
370370
</td>
371371
</tr>
372372
<tr>
373373
<td><code>keyColumn</code></td>
374374
<td>
375-
(仅对 insert 有用)
375+
(仅对 insert, update 有用)
376376
标记一个属性,
377377
MyBatis 会通过 getGeneratedKeys
378378
或者通过 insert 语句的 selectKey 子元素设置它的值。
379379
默认:
380-
不设置。
380+
不设置。 Can be a comma separated list of columns names if multiple generated columns are expected.
381381
</td>
382382
</tr>
383383
<tr>
@@ -474,7 +474,14 @@ selectKey 元素描述如下:
474474
<tr>
475475
<td><code>keyProperty</code></td>
476476
<td>
477-
selectKey 语句结果应该被设置的目标属性。
477+
selectKey 语句结果应该被设置的目标属性。 Can be a comma separated list of property names if multiple generated columns are expected.
478+
</td>
479+
</tr>
480+
<tr>
481+
<td><code>keyColumn</code></td>
482+
<td>The column name(s) in the returned result set that match the properties.
483+
Can be a comma separated list of column names if multiple generated columns
484+
are expected.
478485
</td>
479486
</tr>
480487
<tr>

0 commit comments

Comments
 (0)