Add some utility interfaces to support new style *ByExample methods

Author: jeffgbutler

src/main/java/org/mybatis/dynamic/sql/delete/DeleteDSL.java

@@ -23,9 +23,10 @@
 import org.mybatis.dynamic.sql.SqlTable;
 import org.mybatis.dynamic.sql.VisitableCondition;
 import org.mybatis.dynamic.sql.delete.render.DeleteStatementProvider;
+import org.mybatis.dynamic.sql.util.Buildable;
 import org.mybatis.dynamic.sql.where.AbstractWhereDSL;
 
-public class DeleteDSL<R> {
+public class DeleteDSL<R> implements Buildable<R> {
 
     private Function<DeleteModel, R> adapterFunction;
     private SqlTable table;
@@ -54,6 +55,7 @@ public <T> DeleteWhereBuilder where(BindableColumn<T> column, VisitableCondition
      * 
      * @return the model class
      */
+    @Override
     public R build() {
         DeleteModel deleteModel = DeleteModel.withTable(table).build();
         return adapterFunction.apply(deleteModel);
@@ -72,7 +74,7 @@ public static <T> DeleteDSL<MyBatis3DeleteModelAdapter<T>> deleteFromWithMapper(
         return deleteFrom(deleteModel -> MyBatis3DeleteModelAdapter.of(deleteModel, mapperMethod), table);
     }
 
-    public class DeleteWhereBuilder extends AbstractWhereDSL<DeleteWhereBuilder> {
+    public class DeleteWhereBuilder extends AbstractWhereDSL<DeleteWhereBuilder> implements Buildable<R> {
 
         private <T> DeleteWhereBuilder() {
             super();
@@ -87,6 +89,7 @@ private <T> DeleteWhereBuilder(BindableColumn<T> column, VisitableCondition<T> c
             super(column, condition, subCriteria);
         }
 
+        @Override
         public R build() {
             DeleteModel deleteModel = DeleteModel.withTable(table)
                     .withWhereModel(buildWhereModel())

src/main/java/org/mybatis/dynamic/sql/delete/MyBatis3DeleteByExampleSupport.java

@@ -0,0 +1,33 @@
+/**
+ *    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.
+ *    You may obtain a copy of the License at
+ *
+ *       http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *    Unless required by applicable law or agreed to in writing, software
+ *    distributed under the License is distributed on an "AS IS" BASIS,
+ *    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *    See the License for the specific language governing permissions and
+ *    limitations under the License.
+ */
+package org.mybatis.dynamic.sql.delete;
+
+import java.util.function.Function;
+
+import org.mybatis.dynamic.sql.util.Buildable;
+
+/**
+ * Represents a function that can be used to create a "DeleteByExample" method in the style
+ * of MyBatis Generator. When using this function, you can create a method that does not require a user to
+ * call the build().execute() methods - making client code look a bit cleaner.
+ *  
+ * @author Jeff Butler
+ *
+ */
+@FunctionalInterface
+public interface MyBatis3DeleteByExampleSupport extends
+        Function<DeleteDSL<MyBatis3DeleteModelAdapter<Integer>>, Buildable<MyBatis3DeleteModelAdapter<Integer>>> {
+}

src/main/java/org/mybatis/dynamic/sql/select/MyBatis3CountByExampleSupport.java

@@ -0,0 +1,25 @@
+/**
+ *    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.
+ *    You may obtain a copy of the License at
+ *
+ *       http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *    Unless required by applicable law or agreed to in writing, software
+ *    distributed under the License is distributed on an "AS IS" BASIS,
+ *    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *    See the License for the specific language governing permissions and
+ *    limitations under the License.
+ */
+package org.mybatis.dynamic.sql.select;
+
+import java.util.function.Function;
+
+import org.mybatis.dynamic.sql.util.Buildable;
+
+@FunctionalInterface
+public interface MyBatis3CountByExampleSupport extends
+        Function<QueryExpressionDSL<MyBatis3SelectModelAdapter<Long>>, Buildable<MyBatis3SelectModelAdapter<Long>>> {
+}

src/main/java/org/mybatis/dynamic/sql/select/MyBatis3SelectByExampleSupport.java

@@ -0,0 +1,27 @@
+/**
+ *    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.
+ *    You may obtain a copy of the License at
+ *
+ *       http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *    Unless required by applicable law or agreed to in writing, software
+ *    distributed under the License is distributed on an "AS IS" BASIS,
+ *    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *    See the License for the specific language governing permissions and
+ *    limitations under the License.
+ */
+package org.mybatis.dynamic.sql.select;
+
+import java.util.List;
+import java.util.function.Function;
+
+import org.mybatis.dynamic.sql.util.Buildable;
+
+@FunctionalInterface
+public interface MyBatis3SelectByExampleSupport<T> extends
+        Function<QueryExpressionDSL<MyBatis3SelectModelAdapter<List<T>>>,
+        Buildable<MyBatis3SelectModelAdapter<List<T>>>> {
+}

src/main/java/org/mybatis/dynamic/sql/update/MyBatis3UpdateByExampleSupport.java

@@ -0,0 +1,25 @@
+/**
+ *    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.
+ *    You may obtain a copy of the License at
+ *
+ *       http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *    Unless required by applicable law or agreed to in writing, software
+ *    distributed under the License is distributed on an "AS IS" BASIS,
+ *    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *    See the License for the specific language governing permissions and
+ *    limitations under the License.
+ */
+package org.mybatis.dynamic.sql.update;
+
+import java.util.function.Function;
+
+import org.mybatis.dynamic.sql.util.Buildable;
+
+@FunctionalInterface
+public interface MyBatis3UpdateByExampleSupport extends
+        Function<UpdateDSL<MyBatis3UpdateModelAdapter<Integer>>, Buildable<MyBatis3UpdateModelAdapter<Integer>>> {
+}

src/main/java/org/mybatis/dynamic/sql/update/UpdateDSL.java

@@ -39,7 +39,7 @@
 import org.mybatis.dynamic.sql.util.ValueMapping;
 import org.mybatis.dynamic.sql.where.AbstractWhereDSL;
 
-public class UpdateDSL<R> {
+public class UpdateDSL<R> implements Buildable<R> {
 
     private Function<UpdateModel, R> adapterFunction;
     private List<UpdateMapping> columnMappings = new ArrayList<>();
@@ -73,6 +73,7 @@ public <T> UpdateWhereBuilder where(BindableColumn<T> column, VisitableCondition
      * 
      * @return the update model
      */
+    @Override
     public R build() {
         UpdateModel updateModel = UpdateModel.withTable(table)
                 .withColumnMappings(columnMappings)
@@ -147,7 +148,7 @@ public UpdateDSL<R> equalToWhenPresent(Supplier<T> valueSupplier) {
         }
     }
 
-    public class UpdateWhereBuilder extends AbstractWhereDSL<UpdateWhereBuilder> {
+    public class UpdateWhereBuilder extends AbstractWhereDSL<UpdateWhereBuilder> implements Buildable<R> {
 
         public <T> UpdateWhereBuilder() {
             super();
@@ -162,6 +163,7 @@ public <T> UpdateWhereBuilder(BindableColumn<T> column, VisitableCondition<T> co
             super(column, condition, subCriteria);
         }
 
+        @Override
         public R build() {
             UpdateModel updateModel = UpdateModel.withTable(table)
                     .withColumnMappings(columnMappings)