/* * Copyright (c) 2006-2010 Citrix Systems, Inc. * * This library is free software; you can redistribute it and/or modify it * under the terms of version 2 of the GNU General Public License as published * by the Free Software Foundation, with the additional linking exception as * follows: * * Linking this library statically or dynamically with other modules is * making a combined work based on this library. Thus, the terms and * conditions of the GNU General Public License cover the whole combination. * * As a special exception, the copyright holders of this library give you * permission to link this library with independent modules to produce an * executable, regardless of the license terms of these independent modules, * and to copy and distribute the resulting executable under terms of your * choice, provided that you also meet, for each linked independent module, * the terms and conditions of the license of that module. An independent * module is a module which is not derived from or based on this library. If * you modify this library, you may extend this exception to your version of * the library, but you are not obligated to do so. If you do not wish to do * so, delete this exception statement from your version. * * This program is distributed in the hope that it will be useful, but WITHOUT * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for * more details. * * You should have received a copy of the GNU General Public License along * with this program; if not, write to the Free Software Foundation, Inc., 51 * Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. */ package com.xensource.xenapi; import com.xensource.xenapi.Types.BadServerResponse; import com.xensource.xenapi.Types.VersionException; import com.xensource.xenapi.Types.XenAPIException; import java.io.PrintWriter; import java.io.StringWriter; import java.util.Date; import java.util.HashMap; import java.util.LinkedHashSet; import java.util.Map; import java.util.Set; import org.apache.xmlrpc.XmlRpcException; /** * The metrics reported by the guest (as opposed to inferred from outside) * * @author Citrix Systems, Inc. */ public class VMGuestMetrics extends XenAPIObject { /** * The XenAPI reference to this object. */ protected final String ref; /** * For internal use only. */ VMGuestMetrics(String ref) { this.ref = ref; } public String toWireString() { return this.ref; } /** * If obj is a VMGuestMetrics, compares XenAPI references for equality. */ @Override public boolean equals(Object obj) { if (obj != null && obj instanceof VMGuestMetrics) { VMGuestMetrics other = (VMGuestMetrics) obj; return other.ref.equals(this.ref); } else { return false; } } @Override public int hashCode() { return ref.hashCode(); } /** * Represents all the fields in a VMGuestMetrics */ public static class Record implements Types.Record { public String toString() { StringWriter writer = new StringWriter(); PrintWriter print = new PrintWriter(writer); print.printf("%1$20s: %2$s\n", "uuid", this.uuid); print.printf("%1$20s: %2$s\n", "osVersion", this.osVersion); print.printf("%1$20s: %2$s\n", "PVDriversVersion", this.PVDriversVersion); print.printf("%1$20s: %2$s\n", "PVDriversUpToDate", this.PVDriversUpToDate); print.printf("%1$20s: %2$s\n", "memory", this.memory); print.printf("%1$20s: %2$s\n", "disks", this.disks); print.printf("%1$20s: %2$s\n", "networks", this.networks); print.printf("%1$20s: %2$s\n", "other", this.other); print.printf("%1$20s: %2$s\n", "lastUpdated", this.lastUpdated); print.printf("%1$20s: %2$s\n", "otherConfig", this.otherConfig); print.printf("%1$20s: %2$s\n", "live", this.live); return writer.toString(); } /** * Convert a VM_guest_metrics.Record to a Map */ public Map toMap() { Map map = new HashMap(); map.put("uuid", this.uuid == null ? "" : this.uuid); map.put("os_version", this.osVersion == null ? new HashMap() : this.osVersion); map.put("PV_drivers_version", this.PVDriversVersion == null ? new HashMap() : this.PVDriversVersion); map.put("PV_drivers_up_to_date", this.PVDriversUpToDate == null ? false : this.PVDriversUpToDate); map.put("memory", this.memory == null ? new HashMap() : this.memory); map.put("disks", this.disks == null ? new HashMap() : this.disks); map.put("networks", this.networks == null ? new HashMap() : this.networks); map.put("other", this.other == null ? new HashMap() : this.other); map.put("last_updated", this.lastUpdated == null ? new Date(0) : this.lastUpdated); map.put("other_config", this.otherConfig == null ? new HashMap() : this.otherConfig); map.put("live", this.live == null ? false : this.live); return map; } /** * Unique identifier/object reference */ public String uuid; /** * version of the OS */ public Map osVersion; /** * version of the PV drivers */ public Map PVDriversVersion; /** * true if the PV drivers appear to be up to date */ public Boolean PVDriversUpToDate; /** * free/used/total memory */ public Map memory; /** * disk configuration/free space */ public Map disks; /** * network configuration */ public Map networks; /** * anything else */ public Map other; /** * Time at which this information was last updated */ public Date lastUpdated; /** * additional configuration */ public Map otherConfig; /** * True if the guest is sending heartbeat messages via the guest agent */ public Boolean live; } /** * Get a record containing the current state of the given VM_guest_metrics. * * @return all fields from the object */ public VMGuestMetrics.Record getRecord(Connection c) throws BadServerResponse, XenAPIException, XmlRpcException { String method_call = "VM_guest_metrics.get_record"; String session = c.getSessionReference(); Object[] method_params = {Marshalling.toXMLRPC(session), Marshalling.toXMLRPC(this.ref)}; Map response = c.dispatch(method_call, method_params); Object result = response.get("Value"); return Types.toVMGuestMetricsRecord(result); } /** * Get a reference to the VM_guest_metrics instance with the specified UUID. * * @param uuid UUID of object to return * @return reference to the object */ public static VMGuestMetrics getByUuid(Connection c, String uuid) throws BadServerResponse, XenAPIException, XmlRpcException { String method_call = "VM_guest_metrics.get_by_uuid"; String session = c.getSessionReference(); Object[] method_params = {Marshalling.toXMLRPC(session), Marshalling.toXMLRPC(uuid)}; Map response = c.dispatch(method_call, method_params); Object result = response.get("Value"); return Types.toVMGuestMetrics(result); } /** * Get the uuid field of the given VM_guest_metrics. * * @return value of the field */ public String getUuid(Connection c) throws BadServerResponse, XenAPIException, XmlRpcException { String method_call = "VM_guest_metrics.get_uuid"; String session = c.getSessionReference(); Object[] method_params = {Marshalling.toXMLRPC(session), Marshalling.toXMLRPC(this.ref)}; Map response = c.dispatch(method_call, method_params); Object result = response.get("Value"); return Types.toString(result); } /** * Get the os_version field of the given VM_guest_metrics. * * @return value of the field */ public Map getOsVersion(Connection c) throws BadServerResponse, XenAPIException, XmlRpcException { String method_call = "VM_guest_metrics.get_os_version"; String session = c.getSessionReference(); Object[] method_params = {Marshalling.toXMLRPC(session), Marshalling.toXMLRPC(this.ref)}; Map response = c.dispatch(method_call, method_params); Object result = response.get("Value"); return Types.toMapOfStringString(result); } /** * Get the PV_drivers_version field of the given VM_guest_metrics. * * @return value of the field */ public Map getPVDriversVersion(Connection c) throws BadServerResponse, XenAPIException, XmlRpcException { String method_call = "VM_guest_metrics.get_PV_drivers_version"; String session = c.getSessionReference(); Object[] method_params = {Marshalling.toXMLRPC(session), Marshalling.toXMLRPC(this.ref)}; Map response = c.dispatch(method_call, method_params); Object result = response.get("Value"); return Types.toMapOfStringString(result); } /** * Get the PV_drivers_up_to_date field of the given VM_guest_metrics. * * @return value of the field */ public Boolean getPVDriversUpToDate(Connection c) throws BadServerResponse, XenAPIException, XmlRpcException { String method_call = "VM_guest_metrics.get_PV_drivers_up_to_date"; String session = c.getSessionReference(); Object[] method_params = {Marshalling.toXMLRPC(session), Marshalling.toXMLRPC(this.ref)}; Map response = c.dispatch(method_call, method_params); Object result = response.get("Value"); return Types.toBoolean(result); } /** * Get the memory field of the given VM_guest_metrics. * * @return value of the field */ public Map getMemory(Connection c) throws BadServerResponse, XenAPIException, XmlRpcException { String method_call = "VM_guest_metrics.get_memory"; String session = c.getSessionReference(); Object[] method_params = {Marshalling.toXMLRPC(session), Marshalling.toXMLRPC(this.ref)}; Map response = c.dispatch(method_call, method_params); Object result = response.get("Value"); return Types.toMapOfStringString(result); } /** * Get the disks field of the given VM_guest_metrics. * * @return value of the field */ public Map getDisks(Connection c) throws BadServerResponse, XenAPIException, XmlRpcException { String method_call = "VM_guest_metrics.get_disks"; String session = c.getSessionReference(); Object[] method_params = {Marshalling.toXMLRPC(session), Marshalling.toXMLRPC(this.ref)}; Map response = c.dispatch(method_call, method_params); Object result = response.get("Value"); return Types.toMapOfStringString(result); } /** * Get the networks field of the given VM_guest_metrics. * * @return value of the field */ public Map getNetworks(Connection c) throws BadServerResponse, XenAPIException, XmlRpcException { String method_call = "VM_guest_metrics.get_networks"; String session = c.getSessionReference(); Object[] method_params = {Marshalling.toXMLRPC(session), Marshalling.toXMLRPC(this.ref)}; Map response = c.dispatch(method_call, method_params); Object result = response.get("Value"); return Types.toMapOfStringString(result); } /** * Get the other field of the given VM_guest_metrics. * * @return value of the field */ public Map getOther(Connection c) throws BadServerResponse, XenAPIException, XmlRpcException { String method_call = "VM_guest_metrics.get_other"; String session = c.getSessionReference(); Object[] method_params = {Marshalling.toXMLRPC(session), Marshalling.toXMLRPC(this.ref)}; Map response = c.dispatch(method_call, method_params); Object result = response.get("Value"); return Types.toMapOfStringString(result); } /** * Get the last_updated field of the given VM_guest_metrics. * * @return value of the field */ public Date getLastUpdated(Connection c) throws BadServerResponse, XenAPIException, XmlRpcException { String method_call = "VM_guest_metrics.get_last_updated"; String session = c.getSessionReference(); Object[] method_params = {Marshalling.toXMLRPC(session), Marshalling.toXMLRPC(this.ref)}; Map response = c.dispatch(method_call, method_params); Object result = response.get("Value"); return Types.toDate(result); } /** * Get the other_config field of the given VM_guest_metrics. * * @return value of the field */ public Map getOtherConfig(Connection c) throws BadServerResponse, XenAPIException, XmlRpcException { String method_call = "VM_guest_metrics.get_other_config"; String session = c.getSessionReference(); Object[] method_params = {Marshalling.toXMLRPC(session), Marshalling.toXMLRPC(this.ref)}; Map response = c.dispatch(method_call, method_params); Object result = response.get("Value"); return Types.toMapOfStringString(result); } /** * Get the live field of the given VM_guest_metrics. * * @return value of the field */ public Boolean getLive(Connection c) throws BadServerResponse, XenAPIException, XmlRpcException { String method_call = "VM_guest_metrics.get_live"; String session = c.getSessionReference(); Object[] method_params = {Marshalling.toXMLRPC(session), Marshalling.toXMLRPC(this.ref)}; Map response = c.dispatch(method_call, method_params); Object result = response.get("Value"); return Types.toBoolean(result); } /** * Set the other_config field of the given VM_guest_metrics. * * @param otherConfig New value to set */ public void setOtherConfig(Connection c, Map otherConfig) throws BadServerResponse, XenAPIException, XmlRpcException { String method_call = "VM_guest_metrics.set_other_config"; String session = c.getSessionReference(); Object[] method_params = {Marshalling.toXMLRPC(session), Marshalling.toXMLRPC(this.ref), Marshalling.toXMLRPC(otherConfig)}; Map response = c.dispatch(method_call, method_params); return; } /** * Add the given key-value pair to the other_config field of the given VM_guest_metrics. * * @param key Key to add * @param value Value to add */ public void addToOtherConfig(Connection c, String key, String value) throws BadServerResponse, XenAPIException, XmlRpcException { String method_call = "VM_guest_metrics.add_to_other_config"; String session = c.getSessionReference(); Object[] method_params = {Marshalling.toXMLRPC(session), Marshalling.toXMLRPC(this.ref), Marshalling.toXMLRPC(key), Marshalling.toXMLRPC(value)}; Map response = c.dispatch(method_call, method_params); return; } /** * Remove the given key and its corresponding value from the other_config field of the given VM_guest_metrics. If the key is not in that Map, then do nothing. * * @param key Key to remove */ public void removeFromOtherConfig(Connection c, String key) throws BadServerResponse, XenAPIException, XmlRpcException { String method_call = "VM_guest_metrics.remove_from_other_config"; String session = c.getSessionReference(); Object[] method_params = {Marshalling.toXMLRPC(session), Marshalling.toXMLRPC(this.ref), Marshalling.toXMLRPC(key)}; Map response = c.dispatch(method_call, method_params); return; } /** * Return a list of all the VM_guest_metrics instances known to the system. * * @return references to all objects */ public static Set getAll(Connection c) throws BadServerResponse, XenAPIException, XmlRpcException { String method_call = "VM_guest_metrics.get_all"; String session = c.getSessionReference(); Object[] method_params = {Marshalling.toXMLRPC(session)}; Map response = c.dispatch(method_call, method_params); Object result = response.get("Value"); return Types.toSetOfVMGuestMetrics(result); } /** * Return a map of VM_guest_metrics references to VM_guest_metrics records for all VM_guest_metrics instances known to the system. * * @return records of all objects */ public static Map getAllRecords(Connection c) throws BadServerResponse, XenAPIException, XmlRpcException { String method_call = "VM_guest_metrics.get_all_records"; String session = c.getSessionReference(); Object[] method_params = {Marshalling.toXMLRPC(session)}; Map response = c.dispatch(method_call, method_params); Object result = response.get("Value"); return Types.toMapOfVMGuestMetricsVMGuestMetricsRecord(result); } }