Add the selectAsRow method to NativeSql DSL (#723)

Author: nakamura-to

docs/criteria-api.rst

@@ -454,6 +454,15 @@ The above query issues the following SQL statement:
 Up to 9 numbers, the column results are held by ``Tuple2`` to ``Tuple9``.
 For more than 9 numbers, the results are held by ``Row``.
 
+You can get a ``Row`` list explicitly by using ``selectAsRow`` as follows:
+
+.. code-block:: java
+
+    Employee_ e = new Employee_();
+
+    List<Row> list =
+        nativeSql.from(e).selectAsRow(e.employeeName, e.employeeNo).fetch();
+
 Column projection and mapping (Entityql, NativeSql)
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

doma-core/src/main/java/org/seasar/doma/jdbc/criteria/statement/NativeSqlSelectStarting.java

@@ -747,6 +747,21 @@ public SetOperand<Row> select(
     for (int i = 0; i < propertyMetamodels.length; i++) {
       Objects.requireNonNull(propertyMetamodels[i], "propertyMetamodels[" + i + "]");
     }
+    return selectAsRowInternal(propertyMetamodel, propertyMetamodels);
+  }
+
+  public SetOperand<Row> selectAsRow(
+      PropertyMetamodel<?> propertyMetamodel, PropertyMetamodel<?>... propertyMetamodels) {
+    Objects.requireNonNull(propertyMetamodel);
+    Objects.requireNonNull(propertyMetamodels);
+    for (int i = 0; i < propertyMetamodels.length; i++) {
+      Objects.requireNonNull(propertyMetamodels[i], "propertyMetamodels[" + i + "]");
+    }
+    return selectAsRowInternal(propertyMetamodel, propertyMetamodels);
+  }
+
+  private SetOperand<Row> selectAsRowInternal(
+      PropertyMetamodel<?> propertyMetamodel, PropertyMetamodel<?>... propertyMetamodels) {
     List<PropertyMetamodel<?>> list = new ArrayList<>(1 + propertyMetamodels.length);
     list.add(propertyMetamodel);
     list.addAll(Arrays.asList(propertyMetamodels));

doma-kotlin/src/main/kotlin/org/seasar/doma/jdbc/criteria/statement/KNativeSqlSelectStarting.kt

@@ -291,6 +291,14 @@ class KNativeSqlSelectStarting<ENTITY>(private val statement: NativeSqlSelectSta
         return KNativeSqlSelectIntermediate(setOperand)
     }
 
+    fun selectAsRow(
+        propertyMetamodel: PropertyMetamodel<*>,
+        vararg propertyMetamodels: PropertyMetamodel<*>?
+    ): KSetOperand<Row> {
+        val setOperand = statement.selectAsRow(propertyMetamodel, *propertyMetamodels)
+        return KNativeSqlSelectIntermediate(setOperand)
+    }
+
     fun <RESULT> selectTo(
         entityMetamodel: EntityMetamodel<RESULT>?,
         vararg propertyMetamodels: PropertyMetamodel<*>?