Add utility method to build column lists

Author: jeffgbutler

src/main/java/org/mybatis/dynamic/sql/BasicColumn.java

@@ -1,5 +1,5 @@
 /**
- *    Copyright 2016-2017 the original author or authors.
+ *    Copyright 2016-2019 the original author or authors.
  *
  *    Licensed under the Apache License, Version 2.0 (the "License");
  *    you may not use this file except in compliance with the License.
@@ -66,4 +66,15 @@ default String renderWithTableAndColumnAlias(TableAliasCalculator tableAliasCalc
         return alias().map(a -> nameAndTableAlias + " as " + a) //$NON-NLS-1$
                 .orElse(nameAndTableAlias);
     }
+    
+    /**
+     * Utility method to make it easier to build column lists for methods that require an
+     * array rather than the varargs method.
+     * 
+     * @param columns list of BasicColumn
+     * @return an array of BasicColumn
+     */
+    static BasicColumn[] columnList(BasicColumn...columns) {
+        return columns;
+    }
 }

src/site/markdown/docs/mybatis3.md

@@ -148,7 +148,7 @@ We also envision creating a static field for a reusable list of columns for a se
 
 ```java
 static BasicColumn[] selectList =
-        new BasicColumn[] {id.as("A_ID"), firstName, lastName, birthDate, employed, occupation, addressId};
+    BasicColumn.columnList(id.as("A_ID"), firstName, lastName, birthDate, employed, occupation, addressId);
 ```
 
 The `selectOne` method can be used to implement a generalized select one method:

src/test/java/examples/animal/data/AnimalDataTest.java

@@ -1786,7 +1786,7 @@ public void testUpdateWithAddAndSubtract() {
             assertThat(rows).isEqualTo(1);
 
             AnimalData record = MyBatis3Utils.selectOne(mapper::selectOne,
-                    new BasicColumn[] {id, bodyWeight, brainWeight},
+                    BasicColumn.columnList(id, bodyWeight, brainWeight),
                     animalData,
                     c -> c.where(id, isEqualTo(1))
             );
@@ -1819,7 +1819,7 @@ public void testUpdateWithMultiplyAndDivide() {
             assertThat(rows).isEqualTo(1);
 
             AnimalData record = MyBatis3Utils.selectOne(mapper::selectOne,
-                    new BasicColumn[] {id, bodyWeight, brainWeight},
+                    BasicColumn.columnList(id, bodyWeight, brainWeight),
                     animalData,
                     c -> c.where(id, isEqualTo(1))
             );

src/test/java/examples/schema_supplier/UserMapper.java

@@ -46,7 +46,7 @@ public interface UserMapper {
     List<User> selectMany(SelectStatementProvider selectStatement);
 
     default List<User> select(MyBatis3SelectCompleter completer) {
-        return MyBatis3Utils.selectList(this::selectMany, new BasicColumn[] {id, name}, user, completer);
+        return MyBatis3Utils.selectList(this::selectMany, BasicColumn.columnList(id, name), user, completer);
     }
 
     default int insert(User record) {

src/test/java/examples/simple/PersonMapper.java

@@ -84,7 +84,7 @@ public interface PersonMapper {
     Optional<PersonRecord> selectOne(SelectStatementProvider selectStatement);
 
     static BasicColumn[] selectList =
-            new BasicColumn[] {id.as("A_ID"), firstName, lastName, birthDate, employed, occupation, addressId};
+            BasicColumn.columnList(id.as("A_ID"), firstName, lastName, birthDate, employed, occupation, addressId);
 
     @UpdateProvider(type=SqlProviderAdapter.class, method="update")
     int update(UpdateStatementProvider updateStatement);

src/test/java/examples/simple/PersonWithAddressMapper.java

@@ -71,8 +71,8 @@ public interface PersonWithAddressMapper {
     Optional<PersonWithAddress> selectOne(SelectStatementProvider selectStatement);
 
     static BasicColumn[] selectList =
-            new BasicColumn[] {id.as("A_ID"), firstName, lastName, birthDate, employed, occupation, address.id,
-                    address.streetAddress, address.city, address.state};
+            BasicColumn.columnList(id.as("A_ID"), firstName, lastName, birthDate, employed, occupation, address.id,
+                    address.streetAddress, address.city, address.state);
 
     default Optional<PersonWithAddress> selectOne(MyBatis3SelectCompleter completer) {
         CompletableQuery<SelectModel> start = SqlBuilder.select(selectList).from(person)