Refactored builder to only have on table and a type with a separate argument for ids

Author: HHMagnus

.idea/misc.xml

@@ -1,17 +1,24 @@
 package dev.mhh.cloner.api;
 
+import dev.mhh.cloner.api.builder.CloneConfigurationBuilder;
 import dev.mhh.cloner.api.table.TableConfig;
 import dev.mhh.cloner.impl.builder.CloneConfigurationBuilderImpl;
 
 import java.io.Serializable;
 import java.util.List;
+import java.util.function.Function;
 
-public record CloneConfiguration(
-        List<TableConfig<?>> rootTables,
+public record CloneConfiguration<T extends Serializable>(
+        TableConfig<T> rootTable,
         String idColumnName,
-        String schema
+        String schema,
+        Function<T, String> idToDatabaseStringFunction
 ) implements Serializable {
-    public static CloneConfigurationBuilder builder() {
-        return new CloneConfigurationBuilderImpl();
+    public static <T extends Serializable> CloneConfigurationBuilder<T> builder(
+            final String tableName,
+            final String columnName,
+            final Class<T> columnClass
+    ) {
+        return new CloneConfigurationBuilderImpl<>(tableName, columnName, columnClass);
     }
 }

core/src/main/java/dev/mhh/cloner/api/CloneConfiguration.java

@@ -2,9 +2,19 @@
 
 import java.io.InputStream;
 import java.io.OutputStream;
+import java.io.Serializable;
 import java.sql.Connection;
+import java.util.List;
 
-public interface Cloner {
-    void exportClone(OutputStream outputStream, CloneConfiguration configuration, Connection connection) throws CloneException;
-    void importClone(InputStream inputStream, Connection connection) throws CloneException;
+public interface Cloner<T extends Serializable> {
+    void exportClone(
+            OutputStream outputStream,
+            Connection connection,
+            CloneConfiguration<T> configuration,
+            List<T> ids
+    ) throws CloneException;
+    void importClone(
+            InputStream inputStream,
+            Connection connection
+    ) throws CloneException;
 }

core/src/main/java/dev/mhh/cloner/api/CloneConfigurationBuilder.java

@@ -0,0 +1,70 @@
+package dev.mhh.cloner.api.builder;
+
+import dev.mhh.cloner.api.CloneConfiguration;
+
+import java.io.Serializable;
+import java.util.List;
+import java.util.function.Consumer;
+import java.util.function.Function;
+
+/**
+ * Builder for configuring how a root table and its related tables
+ * should be cloned, including join relationships and nested sub-tables.
+ *
+ * <p>The configuration forms a tree where each table may define
+ * joins to related tables using different join strategies.</p>
+ */
+public interface CloneConfigurationBuilder<T extends Serializable> extends CloneConfigurationSubBuilder<T> {
+
+    /**
+     * Defines the name of the column used to identify rows with foreign key joins
+     *
+     * @param columnName defaults it "id"
+     * @return this builder for fluent chaining
+     */
+    CloneConfigurationBuilder<T> idColumnName(final String columnName);
+
+    /**
+     * Defines the PostgreSQL schema to use for the clone.
+     * @param schema defaults to "public"
+     * @return this builder for fluent chaining
+     */
+    CloneConfigurationBuilder<T> schema(final String schema);
+
+    /**
+     * Function that is used to convert the id columns given as T to a database string that can be used in a where.
+     * Some defaults already exist, so this is only needed if T is a custom type
+     * @param idsToDatabaseStringFunction the function to convert
+     * @return this builder for fluent chaining
+     */
+    CloneConfigurationBuilder<T> idsToDatabaseStringFunction(final Function<T, String> idsToDatabaseStringFunction);
+
+    @Override
+    CloneConfigurationBuilder<T> joinByJoinTableForeignKey(String tableName, String foreignKey, Consumer<CloneConfigurationSubBuilder<T>> subTables);
+
+    @Override
+    default CloneConfigurationBuilder<T> joinByJoinTableForeignKey(String tableName, String foreignKey) {
+        return joinByJoinTableForeignKey(tableName, foreignKey, _ -> {});
+    }
+
+    @Override
+    CloneConfigurationBuilder<T> joinByMainTableForeignKey(String tableName, String foreignKey, Consumer<CloneConfigurationSubBuilder<T>> subTables);
+
+    @Override
+    default CloneConfigurationBuilder<T> joinByMainTableForeignKey(String tableName, String foreignKey) {
+        return joinByMainTableForeignKey(tableName, foreignKey, _ -> {});
+    }
+
+    @Override
+    CloneConfigurationBuilder<T> joinByMatchingColumns(String tableName, String mainTableColumn, String joinedTableColumn, Consumer<CloneConfigurationSubBuilder<T>> subTables);
+
+    @Override
+    default CloneConfigurationBuilder<T> joinByMatchingColumns(String tableName, String mainTableColumn, String joinedTableColumn) {
+        return joinByMatchingColumns(tableName, mainTableColumn, joinedTableColumn, _ -> {});
+    }
+
+    /**
+     * @return the fully configured clone configuration
+     */
+    CloneConfiguration<T> build();
+}