Support subsetted database cloning

Author: labkey-adam

api/src/org/labkey/api/data/DatabaseMigrationConfiguration.java

@@ -0,0 +1,47 @@
+package org.labkey.api.data;
+
+import org.jetbrains.annotations.Nullable;
+
+import java.util.function.Predicate;
+
+public interface DatabaseMigrationConfiguration
+{
+    boolean shouldInsertData();
+    DbScope getSourceScope();
+    DbScope getTargetScope();
+    DbScope getMetadataScope();
+    Predicate<String> getColumnNameFilter();
+
+    class DefaultDatabaseMigrationConfiguration implements DatabaseMigrationConfiguration
+    {
+        @Override
+        public boolean shouldInsertData()
+        {
+            return true;
+        }
+
+        @Override
+        public @Nullable DbScope getSourceScope()
+        {
+            return null;
+        }
+
+        @Override
+        public DbScope getTargetScope()
+        {
+            return null;
+        }
+
+        @Override
+        public DbScope getMetadataScope()
+        {
+            return null;
+        }
+
+        @Override
+        public Predicate<String> getColumnNameFilter()
+        {
+            return null;
+        }
+    }
+}

api/src/org/labkey/api/data/DatabaseMigrationService.java

@@ -2,7 +2,7 @@
 
 import org.apache.logging.log4j.Logger;
 import org.jetbrains.annotations.NotNull;
-import org.jetbrains.annotations.Nullable;
+import org.labkey.api.data.DatabaseMigrationConfiguration.DefaultDatabaseMigrationConfiguration;
 import org.labkey.api.query.TableSorter;
 import org.labkey.api.services.ServiceRegistry;
 import org.labkey.api.util.logging.LogHelper;
@@ -29,8 +29,13 @@ static void setInstance(DatabaseMigrationService impl)
         ServiceRegistry.get().registerService(DatabaseMigrationService.class, impl);
     }
 
+    default DatabaseMigrationConfiguration getDatabaseMigrationConfiguration(String migration)
+    {
+        return new DefaultDatabaseMigrationConfiguration();
+    }
+
     // By default, no-op implementation that simply logs
-    default void migrate(boolean shouldInsertData, @Nullable String migrationDataSource)
+    default void migrate(DatabaseMigrationConfiguration configuration)
     {
         LOG.warn("Database migration service is not present; database migration is a premium feature.");
     }