diff options
Diffstat (limited to 'core/modules/qemu/runvirt-plugin-qemu/src/main/java/org/openslx/runvirt/plugin/qemu/configuration/TransformationGenericParallelDevices.java')
-rw-r--r-- | core/modules/qemu/runvirt-plugin-qemu/src/main/java/org/openslx/runvirt/plugin/qemu/configuration/TransformationGenericParallelDevices.java | 47 |
1 files changed, 43 insertions, 4 deletions
diff --git a/core/modules/qemu/runvirt-plugin-qemu/src/main/java/org/openslx/runvirt/plugin/qemu/configuration/TransformationGenericParallelDevices.java b/core/modules/qemu/runvirt-plugin-qemu/src/main/java/org/openslx/runvirt/plugin/qemu/configuration/TransformationGenericParallelDevices.java index 7350df32..dff86132 100644 --- a/core/modules/qemu/runvirt-plugin-qemu/src/main/java/org/openslx/runvirt/plugin/qemu/configuration/TransformationGenericParallelDevices.java +++ b/core/modules/qemu/runvirt-plugin-qemu/src/main/java/org/openslx/runvirt/plugin/qemu/configuration/TransformationGenericParallelDevices.java @@ -10,16 +10,51 @@ import org.openslx.virtualization.configuration.VirtualizationConfigurationQemuU import org.openslx.virtualization.configuration.transformation.TransformationException; import org.openslx.virtualization.configuration.transformation.TransformationGeneric; +/** + * Generic parallel device transformation for Libvirt/QEMU virtualization configurations. + * + * @author Manuel Bentele + * @version 1.0 + */ public class TransformationGenericParallelDevices extends TransformationGeneric<Domain, CommandLineArgs> { - private static final String FILTER_NAME = "Parallel devices"; + /** + * Name of the configuration transformation. + */ + private static final String NAME = "Parallel devices"; + /** + * Creates a new parallel device transformation for Libvirt/QEMU virtualization configurations. + */ public TransformationGenericParallelDevices() { - super( TransformationGenericParallelDevices.FILTER_NAME ); + super( TransformationGenericParallelDevices.NAME ); } - private void filterParallelDevice( Domain config, String fileName, 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 parallel device in a virtualization configuration selected by its {@code index}. + * + * @param config virtualization configuration for the transformation. + * @param fileName path to the parallel device file on the host system. + * @param index number of the parallel device in the virtualization configuration that is + * selected. + * @throws TransformationException transformation has failed. + */ + private void transformParallelDevice( Domain config, String fileName, int index ) throws TransformationException { final ArrayList<Parallel> devices = config.getParallelDevices(); final Parallel device = VirtualizationConfigurationQemuUtils.getArrayIndex( devices, index ); @@ -47,7 +82,11 @@ public class TransformationGenericParallelDevices extends TransformationGeneric< @Override public void transform( Domain config, CommandLineArgs args ) throws TransformationException { - this.filterParallelDevice( config, args.getVmDeviceSerial0(), 0 ); + // validate configuration and input arguments + this.validateInputs( config, args ); + + // alter parallel device + this.transformParallelDevice( config, args.getVmDeviceParallel0(), 0 ); // remove all additional parallel devices final ArrayList<Parallel> devices = config.getParallelDevices(); |