diff options
author | Manuel Bentele | 2021-05-14 14:39:33 +0200 |
---|---|---|
committer | Manuel Bentele | 2021-05-14 14:39:33 +0200 |
commit | 4ee74c1bdcd21ad6f0152c5806a3eca0f0700b69 (patch) | |
tree | 966ad53135c02ee4f27429cec96e7026750f80e3 /core/modules/qemu/runvirt-plugin-qemu/src/main/java/org/openslx/runvirt/plugin/qemu/configuration/TransformationGenericParallelDevices.java | |
parent | [qemu] Rename VmMetaData classes (diff) | |
download | mltk-4ee74c1bdcd21ad6f0152c5806a3eca0f0700b69.tar.gz mltk-4ee74c1bdcd21ad6f0152c5806a3eca0f0700b69.tar.xz mltk-4ee74c1bdcd21ad6f0152c5806a3eca0f0700b69.zip |
[qemu] Document configuration transformations and Libvirt QEMU hypervisor
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(); |