summaryrefslogtreecommitdiffstats
path: root/core/modules/qemu/runvirt-plugin-qemu/src/main/java/org/openslx/runvirt/plugin/qemu/configuration/TransformationGenericFileSystemDevices.java
diff options
context:
space:
mode:
Diffstat (limited to 'core/modules/qemu/runvirt-plugin-qemu/src/main/java/org/openslx/runvirt/plugin/qemu/configuration/TransformationGenericFileSystemDevices.java')
-rw-r--r--core/modules/qemu/runvirt-plugin-qemu/src/main/java/org/openslx/runvirt/plugin/qemu/configuration/TransformationGenericFileSystemDevices.java53
1 files changed, 48 insertions, 5 deletions
diff --git a/core/modules/qemu/runvirt-plugin-qemu/src/main/java/org/openslx/runvirt/plugin/qemu/configuration/TransformationGenericFileSystemDevices.java b/core/modules/qemu/runvirt-plugin-qemu/src/main/java/org/openslx/runvirt/plugin/qemu/configuration/TransformationGenericFileSystemDevices.java
index 0417bfdf..88939302 100644
--- a/core/modules/qemu/runvirt-plugin-qemu/src/main/java/org/openslx/runvirt/plugin/qemu/configuration/TransformationGenericFileSystemDevices.java
+++ b/core/modules/qemu/runvirt-plugin-qemu/src/main/java/org/openslx/runvirt/plugin/qemu/configuration/TransformationGenericFileSystemDevices.java
@@ -11,16 +11,55 @@ import org.openslx.virtualization.configuration.VirtualizationConfigurationQemuU
import org.openslx.virtualization.configuration.transformation.TransformationException;
import org.openslx.virtualization.configuration.transformation.TransformationGeneric;
+/**
+ * Generic file system device (shared folder) transformation for Libvirt/QEMU virtualization
+ * configurations.
+ *
+ * @author Manuel Bentele
+ * @version 1.0
+ */
public class TransformationGenericFileSystemDevices extends TransformationGeneric<Domain, CommandLineArgs>
{
- private static final String FILTER_NAME = "File system devices";
+ /**
+ * Name of the configuration transformation.
+ */
+ private static final String NAME = "File system devices";
+ /**
+ * Creates a new file system device (shared folder) transformation for Libvirt/QEMU
+ * virtualization configurations.
+ */
public TransformationGenericFileSystemDevices()
{
- super( TransformationGenericFileSystemDevices.FILTER_NAME );
+ super( TransformationGenericFileSystemDevices.NAME );
}
- private void filterFileSystemDevice( Domain config, String source, String target, int index ) throws TransformationException
+ /**
+ * Validates a virtualization configuration and input arguments for this transformation.
+ *
+ * @param config virtualization configuration for the validation.
+ * @param args input arguments for the validation.
+ * @throws TransformationException validation has failed.
+ */
+ private void validateInputs( Domain config, CommandLineArgs args ) throws TransformationException
+ {
+ if ( config == null || args == null ) {
+ throw new TransformationException( "Virtualization configuration or input arguments are missing!" );
+ }
+ }
+
+ /**
+ * Transforms a storage device in a virtualization configuration selected by its {@code index}.
+ *
+ * @param config virtualization configuration for the transformation.
+ * @param source path of the file system source on a host system.
+ * @param target path of the file system destination in a virtualization guest.
+ * @param index number of the file system device in the virtualization configuration that is
+ * selected.
+ * @throws TransformationException transformation has failed.
+ */
+ private void transformFileSystemDevice( Domain config, String source, String target, int index )
+ throws TransformationException
{
final ArrayList<FileSystem> devices = config.getFileSystemDevices();
final FileSystem fileSystem = VirtualizationConfigurationQemuUtils.getArrayIndex( devices, index );
@@ -52,8 +91,12 @@ public class TransformationGenericFileSystemDevices extends TransformationGeneri
@Override
public void transform( Domain config, CommandLineArgs args ) throws TransformationException
{
- this.filterFileSystemDevice( config, args.getVmFsSrc0(), args.getVmFsTgt0(), 0 );
- this.filterFileSystemDevice( config, args.getVmFsSrc1(), args.getVmFsTgt1(), 1 );
+ // validate configuration and input arguments
+ this.validateInputs( config, args );
+
+ // alter file system devices
+ this.transformFileSystemDevice( config, args.getVmFsSrc0(), args.getVmFsTgt0(), 0 );
+ this.transformFileSystemDevice( config, args.getVmFsSrc1(), args.getVmFsTgt1(), 1 );
// remove all additional file system devices
final ArrayList<FileSystem> devices = config.getFileSystemDevices();