aboutsummaryrefslogtreecommitdiffstats
path: root/lib/public/UserMigration/IMigrator.php
diff options
context:
space:
mode:
Diffstat (limited to 'lib/public/UserMigration/IMigrator.php')
-rw-r--r--lib/public/UserMigration/IMigrator.php80
1 files changed, 80 insertions, 0 deletions
diff --git a/lib/public/UserMigration/IMigrator.php b/lib/public/UserMigration/IMigrator.php
new file mode 100644
index 00000000000..8ce2cca8f98
--- /dev/null
+++ b/lib/public/UserMigration/IMigrator.php
@@ -0,0 +1,80 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * SPDX-FileCopyrightText: 2022 Nextcloud GmbH and Nextcloud contributors
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+namespace OCP\UserMigration;
+
+use OCP\IUser;
+use Symfony\Component\Console\Output\OutputInterface;
+
+/**
+ * @since 24.0.0
+ */
+interface IMigrator {
+ /**
+ * Export user data
+ *
+ * @throws UserMigrationException
+ * @since 24.0.0
+ */
+ public function export(
+ IUser $user,
+ IExportDestination $exportDestination,
+ OutputInterface $output,
+ ): void;
+
+ /**
+ * Import user data
+ *
+ * @throws UserMigrationException
+ * @since 24.0.0
+ */
+ public function import(
+ IUser $user,
+ IImportSource $importSource,
+ OutputInterface $output,
+ ): void;
+
+ /**
+ * Returns the unique ID
+ *
+ * @since 24.0.0
+ */
+ public function getId(): string;
+
+ /**
+ * Returns the display name
+ *
+ * @since 24.0.0
+ */
+ public function getDisplayName(): string;
+
+ /**
+ * Returns the description
+ *
+ * @since 24.0.0
+ */
+ public function getDescription(): string;
+
+ /**
+ * Returns the version of the export format for this migrator
+ *
+ * @since 24.0.0
+ */
+ public function getVersion(): int;
+
+ /**
+ * Checks whether it is able to import a version of the export format for this migrator
+ * Use $importSource->getMigratorVersion($this->getId()) to get the version from the archive
+ *
+ * @since 24.0.0
+ */
+ public function canImport(
+ IImportSource $importSource,
+ ): bool;
+}