Skip to content

Commit 1fbcf09

Browse files
harawataharawata
committed
Replicated doc changes for #331 to the localized version. es, ko and zh need translation.
1 parent 48e52bf commit 1fbcf09

File tree

4 files changed

+120
-20
lines changed

4 files changed

+120
-20
lines changed

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

Lines changed: 30 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -397,18 +397,43 @@ Por ejemplo, si la columna id de la tabla Author del ejemplo siguiente fuera aut
397397
</subsection>
398398

399399
<subsection name="sql">
400-
<p>Este elemento se utiliza para definir un fragmento reusable de código SQL que puede ser incluido en otras sentencias. Por ejemplo:
400+
<p>Este elemento se utiliza para definir un fragmento reusable de código SQL que puede ser incluido en otras sentencias. It can be statically (during load phase) parametrized. Different property values can
401+
vary in include instances. Por ejemplo:
401402
</p>
402403

403-
<source><![CDATA[<sql id="userColumns"> id,username,password </sql>]]></source>
404+
<source><![CDATA[<sql id="userColumns"> ${alias}.id,${alias}.username,${alias}.password </sql>]]></source>
404405

405406
<p>Este fragmento de SQL puede ser incluido en otra sentencia, por ejemplo:
406407
</p>
407408

408409
<source><![CDATA[<select id="selectUsers" resultType="map">
409-
select <include refid="userColumns"/>
410-
from some_table
411-
where id = #{id}
410+
select
411+
<include refid="userColumns"><property name="alias" value="t1"/></include>,
412+
<include refid="userColumns"><property name="alias" value="t2"/></include>
413+
from some_table t1
414+
cross join some_table t2
415+
</select>]]></source>
416+
417+
<p>
418+
Property value can be also used in include refid attribute or property values inside include clause, for example:
419+
</p>
420+
421+
<source><![CDATA[<sql id="sometable">
422+
${prefix}Table
423+
</sql>
424+
425+
<sql id="someinclude">
426+
from
427+
<include refid="${include_target}"/>
428+
</sql>
429+
430+
<select id="select" resultType="map">
431+
select
432+
field1, field2, field3
433+
<include refid="someinclude">
434+
<property name="prefix" value="Some"/>
435+
<property name="include_target" value="sometable"/>
436+
</include>
412437
</select>]]></source>
413438
</subsection>
414439

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

Lines changed: 30 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -446,20 +446,45 @@ ps.setInt(1,id);]]></source>
446446

447447
<subsection name="sql">
448448
<p>
449-
この要素を使うと、再利用可能な SQL コードのスニペットを定義しておいて、他のステートメントにインクルードすることができます。<br />
449+
この要素を使うと、再利用可能な SQL コードのスニペットを定義しておいて、他のステートメントにインクルードすることができます。このときパラメータを指定することもできますが、インクルードの解決はロード時に行われるので、静的な文字列のみ指定可能です。<br />
450450
例：
451451
</p>
452452

453-
<source><![CDATA[<sql id="userColumns"> id,username,password </sql>]]></source>
453+
<source><![CDATA[<sql id="userColumns"> ${alias}.id,${alias}.username,${alias}.password </sql>]]></source>
454454

455455
<p>
456456
上記の SQL スニペットを他のステートメントにインクルードするには、次のように記述します。
457457
</p>
458458

459459
<source><![CDATA[<select id="selectUsers" resultType="map">
460-
select <include refid="userColumns"/>
461-
from some_table
462-
where id = #{id}
460+
select
461+
<include refid="userColumns"><property name="alias" value="t1"/></include>,
462+
<include refid="userColumns"><property name="alias" value="t2"/></include>
463+
from some_table t1
464+
cross join some_table t2
465+
</select>]]></source>
466+
467+
<p>
468+
呼び出し側の property 要素で指定された値を、sql 要素に内包された include 要素の refid 属性や property 要素の value 属性として指定することも可能です。<br />
469+
例：
470+
</p>
471+
472+
<source><![CDATA[<sql id="sometable">
473+
${prefix}Table
474+
</sql>
475+
476+
<sql id="someinclude">
477+
from
478+
<include refid="${include_target}"/>
479+
</sql>
480+
481+
<select id="select" resultType="map">
482+
select
483+
field1, field2, field3
484+
<include refid="someinclude">
485+
<property name="prefix" value="Some"/>
486+
<property name="include_target" value="sometable"/>
487+
</include>
463488
</select>]]></source>
464489
</subsection>
465490

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

Lines changed: 30 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -371,16 +371,41 @@ selectKey 구문을 실행한다. Oracle 과 같은 데이터베이스에서는
371371
</subsection>
372372

373373
<subsection name="sql">
374-
<p>이 요소는 다른 구문에서 재사용가능한 SQL 구문을 정의할 때 사용된다.</p>
374+
<p>이 요소는 다른 구문에서 재사용가능한 SQL 구문을 정의할 때 사용된다. It can be statically (during load phase) parametrized. Different property values can
375+
vary in include instances.</p>
375376

376-
<source><![CDATA[<sql id="userColumns"> id,username,password </sql>]]></source>
377+
<source><![CDATA[<sql id="userColumns"> ${alias}.id,${alias}.username,${alias}.password </sql>]]></source>
377378

378379
<p>SQL 조각은 다른 구문에 포함시킬수 있다.</p>
379380

380381
<source><![CDATA[<select id="selectUsers" resultType="map">
381-
select <include refid="userColumns"/>
382-
from some_table
383-
where id = #{id}
382+
select
383+
<include refid="userColumns"><property name="alias" value="t1"/></include>,
384+
<include refid="userColumns"><property name="alias" value="t2"/></include>
385+
from some_table t1
386+
cross join some_table t2
387+
</select>]]></source>
388+
389+
<p>
390+
Property value can be also used in include refid attribute or property values inside include clause, for example:
391+
</p>
392+
393+
<source><![CDATA[<sql id="sometable">
394+
${prefix}Table
395+
</sql>
396+
397+
<sql id="someinclude">
398+
from
399+
<include refid="${include_target}"/>
400+
</sql>
401+
402+
<select id="select" resultType="map">
403+
select
404+
field1, field2, field3
405+
<include refid="someinclude">
406+
<property name="prefix" value="Some"/>
407+
<property name="include_target" value="sometable"/>
408+
</include>
384409
</select>]]></source>
385410
</subsection>
386411

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

Lines changed: 30 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -392,18 +392,43 @@ ps.setInt(1,id);]]></source>
392392
</subsection>
393393

394394
<subsection name="sql">
395-
<p>这个元素可以被用来定义可重用的 SQL 代码段，可以包含在其他语句中。比如：
395+
<p>这个元素可以被用来定义可重用的 SQL 代码段，可以包含在其他语句中。It can be statically (during load phase) parametrized. Different property values can
396+
vary in include instances. 比如：
396397
</p>
397398

398-
<source><![CDATA[<sql id="userColumns"> id,username,password </sql>]]></source>
399+
<source><![CDATA[<sql id="userColumns"> ${alias}.id,${alias}.username,${alias}.password </sql>]]></source>
399400

400401
<p>这个 SQL 片段可以被包含在其他语句中，例如：
401402
</p>
402403

403404
<source><![CDATA[<select id="selectUsers" resultType="map">
404-
select <include refid="userColumns"/>
405-
from some_table
406-
where id = #{id}
405+
select
406+
<include refid="userColumns"><property name="alias" value="t1"/></include>,
407+
<include refid="userColumns"><property name="alias" value="t2"/></include>
408+
from some_table t1
409+
cross join some_table t2
410+
</select>]]></source>
411+
412+
<p>
413+
Property value can be also used in include refid attribute or property values inside include clause, for example:
414+
</p>
415+
416+
<source><![CDATA[<sql id="sometable">
417+
${prefix}Table
418+
</sql>
419+
420+
<sql id="someinclude">
421+
from
422+
<include refid="${include_target}"/>
423+
</sql>
424+
425+
<select id="select" resultType="map">
426+
select
427+
field1, field2, field3
428+
<include refid="someinclude">
429+
<property name="prefix" value="Some"/>
430+
<property name="include_target" value="sometable"/>
431+
</include>
407432
</select>]]></source>
408433
</subsection>
409434

0 commit comments

Comments
 (0)