com.mulesoft.runtime.upgrade.tool.service.api

Interface BackupService

All Known Implementing Classes:

DefaultBackupService

public interface BackupService

A service for backup related operations.

Method Summary

Modifier and Type	Method and Description
void	create(MuleDistribution muleDistribution, List<Path> relativePathOfFilesToBeBackedUp) Creates a backup copy of the given file paths within the Mule distribution directory that will be undergoing the upgrade.
void	printBackUpDescriptor(Optional<BackupDescriptor> backupDescriptor) Prints a BackUp Descriptor with a pretty format .
Optional<BackupDescriptor>	readBackupDescriptor(Path muleDistribution) Retrieves the backup creation metadata stored in the YAML file within the backup directory location if any has been previously generated as part of an upgrade process.

Method Detail

readBackupDescriptor

Optional<BackupDescriptor> readBackupDescriptor(Path muleDistribution)
                                         throws IOException

Retrieves the backup creation metadata stored in the YAML file within the backup directory location if any has been previously generated as part of an upgrade process.

Parameters:

muleDistribution - location of the Mule distribution where backup could reside.

Returns:

a Optional of a BackupDescriptor.

Throws:

IOException - In case of any I/O related error while reading the info from the metadata file.

create

void create(MuleDistribution muleDistribution,
            List<Path> relativePathOfFilesToBeBackedUp)
     throws IOException

Creates a backup copy of the given file paths within the Mule distribution directory that will be undergoing the upgrade. Backup creation metadata is stored in a YAML file which is created within the backup directory. The purpose of creating this backup is to be later used in an upgrade rollback operation if needed.

Parameters:

muleDistribution - a MuleDistribution representing the Mule distro where the backup will be taken from.

relativePathOfFilesToBeBackedUp - the list of all relative paths to the Mule distribution that should be backed up.

Throws:

IOException - In case of any I/O related error while creating the backup.

printBackUpDescriptor

void printBackUpDescriptor(Optional<BackupDescriptor> backupDescriptor)

Prints a BackUp Descriptor with a pretty format .

Parameters:

backupDescriptor - BackUp Descriptor selected.