From 4ee74c1bdcd21ad6f0152c5806a3eca0f0700b69 Mon Sep 17 00:00:00 2001
From: Manuel Bentele
Date: Fri, 14 May 2021 14:39:33 +0200
Subject: [qemu] Document configuration transformations and Libvirt QEMU
 hypervisor

---
 .../configuration/TransformationGenericMemory.java | 35 ++++++++++++++++++++--
 1 file changed, 33 insertions(+), 2 deletions(-)

(limited to 'core/modules/qemu/runvirt-plugin-qemu/src/main/java/org/openslx/runvirt/plugin/qemu/configuration/TransformationGenericMemory.java')

diff --git a/core/modules/qemu/runvirt-plugin-qemu/src/main/java/org/openslx/runvirt/plugin/qemu/configuration/TransformationGenericMemory.java b/core/modules/qemu/runvirt-plugin-qemu/src/main/java/org/openslx/runvirt/plugin/qemu/configuration/TransformationGenericMemory.java
index 341a5b7f..fce373f7 100644
--- a/core/modules/qemu/runvirt-plugin-qemu/src/main/java/org/openslx/runvirt/plugin/qemu/configuration/TransformationGenericMemory.java
+++ b/core/modules/qemu/runvirt-plugin-qemu/src/main/java/org/openslx/runvirt/plugin/qemu/configuration/TransformationGenericMemory.java
@@ -8,18 +8,49 @@ import org.openslx.runvirt.plugin.qemu.cmdln.CommandLineArgs;
 import org.openslx.virtualization.configuration.transformation.TransformationException;
 import org.openslx.virtualization.configuration.transformation.TransformationGeneric;
 
+/**
+ * Generic memory transformation for Libvirt/QEMU virtualization configurations.
+ * 
+ * @author Manuel Bentele
+ * @version 1.0
+ */
 public class TransformationGenericMemory extends TransformationGeneric<Domain, CommandLineArgs>
 {
-	private static final String FILTER_NAME = "Memory [normal, current (balloning)]";
+	/**
+	 * Name of the configuration transformation.
+	 */
+	private static final String NAME = "Memory [normal, current (balloning)]";
 
+	/**
+	 * Creates a new memory transformation for Libvirt/QEMU virtualization configurations.
+	 */
 	public TransformationGenericMemory()
 	{
-		super( TransformationGenericMemory.FILTER_NAME );
+		super( TransformationGenericMemory.NAME );
+	}
+
+	/**
+	 * 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!" );
+		} else if ( args.getVmMemory() == null || args.getVmMemory().isEmpty() ) {
+			throw new TransformationException( "Amount of memory in MiB is not specified!" );
+		}
 	}
 
 	@Override
 	public void transform( Domain config, CommandLineArgs args ) throws TransformationException
 	{
+		// validate configuration and input arguments
+		this.validateInputs( config, args );
+
 		BigInteger memory = DomainUtils.decodeMemory( args.getVmMemory(), "MiB" );
 
 		config.setMemory( memory );
-- 
cgit v1.2.3-55-g7522