Add sample on doc for #1582

mybatis · Jun 29, 2019 · fa33822 · fa33822
1 parent 0ba144e
commit fa33822
Show file tree

Hide file tree

Showing 5 changed files with 130 additions and 1 deletion.
diff --git a/src/site/es/xdoc/statement-builders.xml b/src/site/es/xdoc/statement-builders.xml
@@ -472,6 +472,32 @@ public String insertPersonsSql() {
     .INTO_VALUES("#{subPerson.id}", "#{subPerson.fullName}")
     .toString();
 }
+]]></source>
+
+        <p>Since version 3.5.2, you can create select statement for limiting search result rows clause as follow:</p>
+
+        <source><![CDATA[
+public String selectPersonsWithOffsetLimitSql() {
+  // SELECT id, name FROM PERSON
+  //     LIMIT #{limit} OFFSET #{offset}
+  return new SQL()
+    .SELECT("id", "name")
+    .FROM("PERSON")
+    .LIMIT("#{limit}")
+    .OFFSET("#{offset}")
+    .toString();
+}
+
+public String selectPersonsWithFetchFirstSql() {
+  // SELECT id, name FROM PERSON
+  //     OFFSET #{offset} ROWS FETCH FIRST #{limit} ROWS ONLY
+  return new SQL()
+    .SELECT("id", "name")
+    .FROM("PERSON")
+    .OFFSET_ROWS("#{offset}")
+    .FETCH_FIRST_ROWS_ONLY("#{limit}")
+    .toString();
+}
 ]]></source>
 
       </subsection>

diff --git a/src/site/ja/xdoc/statement-builders.xml b/src/site/ja/xdoc/statement-builders.xml
@@ -477,7 +477,7 @@ public String updatePersonSql() {
 }
 ]]></source>
 
-        <p>バージョン3.4.2以降では、次のように一括挿入用のステートメントを作成することができます。</p>
+        <p>バージョン3.5.2以降では、次のように一括挿入用のステートメントを作成することができます。</p>
 
         <source><![CDATA[
 public String insertPersonsSql() {
@@ -491,6 +491,32 @@ public String insertPersonsSql() {
     .INTO_VALUES("#{subPerson.id}", "#{subPerson.fullName}")
     .toString();
 }
+]]></source>
+
+        <p>バージョン3.5.2以降では、次のように検索結果行を制限するための検索ステートメントを作成することができます。</p>
+
+        <source><![CDATA[
+public String selectPersonsWithOffsetLimitSql() {
+  // SELECT id, name FROM PERSON
+  //     LIMIT #{limit} OFFSET #{offset}
+  return new SQL()
+    .SELECT("id", "name")
+    .FROM("PERSON")
+    .LIMIT("#{limit}")
+    .OFFSET("#{offset}")
+    .toString();
+}
+
+public String selectPersonsWithFetchFirstSql() {
+  // SELECT id, name FROM PERSON
+  //     OFFSET #{offset} ROWS FETCH FIRST #{limit} ROWS ONLY
+  return new SQL()
+    .SELECT("id", "name")
+    .FROM("PERSON")
+    .OFFSET_ROWS("#{offset}")
+    .FETCH_FIRST_ROWS_ONLY("#{limit}")
+    .toString();
+}
 ]]></source>
 
       </subsection>

diff --git a/src/site/ko/xdoc/statement-builders.xml b/src/site/ko/xdoc/statement-builders.xml
@@ -519,6 +519,32 @@ public String insertPersonsSql() {
     .INTO_VALUES("#{subPerson.id}", "#{subPerson.fullName}")
     .toString();
 }
+]]></source>
+
+        <p>Since version 3.5.2, you can create select statement for limiting search result rows clause as follow:</p>
+
+        <source><![CDATA[
+public String selectPersonsWithOffsetLimitSql() {
+  // SELECT id, name FROM PERSON
+  //     LIMIT #{limit} OFFSET #{offset}
+  return new SQL()
+    .SELECT("id", "name")
+    .FROM("PERSON")
+    .LIMIT("#{limit}")
+    .OFFSET("#{offset}")
+    .toString();
+}
+
+public String selectPersonsWithFetchFirstSql() {
+  // SELECT id, name FROM PERSON
+  //     OFFSET #{offset} ROWS FETCH FIRST #{limit} ROWS ONLY
+  return new SQL()
+    .SELECT("id", "name")
+    .FROM("PERSON")
+    .OFFSET_ROWS("#{offset}")
+    .FETCH_FIRST_ROWS_ONLY("#{limit}")
+    .toString();
+}
 ]]></source>
 
       </subsection>

diff --git a/src/site/xdoc/statement-builders.xml b/src/site/xdoc/statement-builders.xml
@@ -550,6 +550,31 @@ public String insertPersonsSql() {
 }
 ]]></source>
 
+        <p>Since version 3.5.2, you can create select statement for limiting search result rows clause as follow:</p>
+
+        <source><![CDATA[
+public String selectPersonsWithOffsetLimitSql() {
+  // SELECT id, name FROM PERSON
+  //     LIMIT #{limit} OFFSET #{offset}
+  return new SQL()
+    .SELECT("id", "name")
+    .FROM("PERSON")
+    .LIMIT("#{limit}")
+    .OFFSET("#{offset}")
+    .toString();
+}
+
+public String selectPersonsWithFetchFirstSql() {
+  // SELECT id, name FROM PERSON
+  //     OFFSET #{offset} ROWS FETCH FIRST #{limit} ROWS ONLY
+  return new SQL()
+    .SELECT("id", "name")
+    .FROM("PERSON")
+    .OFFSET_ROWS("#{offset}")
+    .FETCH_FIRST_ROWS_ONLY("#{limit}")
+    .toString();
+}
+]]></source>
 
       </subsection>
 

diff --git a/src/site/zh/xdoc/statement-builders.xml b/src/site/zh/xdoc/statement-builders.xml
@@ -521,6 +521,32 @@ public String insertPersonsSql() {
     .INTO_VALUES("#{subPerson.id}", "#{subPerson.fullName}")
     .toString();
 }
+]]></source>
+
+        <p>Since version 3.5.2, you can create select statement for limiting search result rows clause as follow:</p>
+
+        <source><![CDATA[
+public String selectPersonsWithOffsetLimitSql() {
+  // SELECT id, name FROM PERSON
+  //     LIMIT #{limit} OFFSET #{offset}
+  return new SQL()
+    .SELECT("id", "name")
+    .FROM("PERSON")
+    .LIMIT("#{limit}")
+    .OFFSET("#{offset}")
+    .toString();
+}
+
+public String selectPersonsWithFetchFirstSql() {
+  // SELECT id, name FROM PERSON
+  //     OFFSET #{offset} ROWS FETCH FIRST #{limit} ROWS ONLY
+  return new SQL()
+    .SELECT("id", "name")
+    .FROM("PERSON")
+    .OFFSET_ROWS("#{offset}")
+    .FETCH_FIRST_ROWS_ONLY("#{limit}")
+    .toString();
+}
 ]]></source>
 
       </subsection>