Add a helper function to select all rows and specify order

Author: jeffgbutler

src/main/java/org/mybatis/dynamic/sql/util/mybatis3/MyBatis3SelectByExampleHelper.java

@@ -18,6 +18,7 @@
 import java.util.List;
 import java.util.function.Function;
 
+import org.mybatis.dynamic.sql.SortSpecification;
 import org.mybatis.dynamic.sql.select.MyBatis3SelectModelAdapter;
 import org.mybatis.dynamic.sql.select.QueryExpressionDSL;
 import org.mybatis.dynamic.sql.util.Buildable;
@@ -86,4 +87,16 @@ public interface MyBatis3SelectByExampleHelper<T> extends
     static <T> MyBatis3SelectByExampleHelper<T> allRows() {
         return h -> h;
     }
+
+    /**
+     * Returns a helper that can be used to select every row in a table with a specified sort order.
+     * 
+     * @param <T> the type of row returned
+     * @param columns sort columns
+     * 
+     * @return the helper that will select every row in a table in the specified order
+     */
+    static <T> MyBatis3SelectByExampleHelper<T> allRowsOrderdBy(SortSpecification...columns) {
+        return h -> h.orderBy(columns);
+    }
 }

src/main/java/org/mybatis/dynamic/sql/util/mybatis3/MyBatis3UpdateByExampleValueSetter.java

@@ -21,7 +21,7 @@
 import org.mybatis.dynamic.sql.update.UpdateDSL;
 
 /**
- * Represents a function that can be used to create an "UpdateByExample" method in the style
+ * Represents a function that can be used to set values in an "UpdateByExample" method in the style
  * of MyBatis Generator. When using this function, you can create a method that will map record fields to
  * tables columns to be updated in a common mapper, and then allow a user to set a where clause as needed.
  * 

src/test/java/examples/simple/SimpleTableAnnotatedNewStyleMapperTest.java

@@ -88,6 +88,22 @@ public void testSelectAll() {
             List<SimpleTableRecord> rows = mapper.selectByExample(MyBatis3SelectByExampleHelper.allRows());
 
             assertThat(rows.size()).isEqualTo(6);
+            assertThat(rows.get(0).getId()).isEqualTo(1);
+            assertThat(rows.get(5).getId()).isEqualTo(6);
+        }
+    }
+
+    @Test
+    public void testSelectAllOrdered() {
+        try (SqlSession session = sqlSessionFactory.openSession()) {
+            SimpleTableAnnotatedMapperNewStyle mapper = session.getMapper(SimpleTableAnnotatedMapperNewStyle.class);
+            
+            List<SimpleTableRecord> rows = mapper
+                    .selectByExample(MyBatis3SelectByExampleHelper.allRowsOrderdBy(lastName.descending(), firstName.descending()));
+            
+            assertThat(rows.size()).isEqualTo(6);
+            assertThat(rows.get(0).getId()).isEqualTo(5);
+            assertThat(rows.get(5).getId()).isEqualTo(1);
         }
     }