VmDynamicDao.java

package org.ovirt.engine.core.dao;

import java.util.List;

import org.ovirt.engine.core.common.businessentities.GuestAgentStatus;
import org.ovirt.engine.core.common.businessentities.VMStatus;
import org.ovirt.engine.core.common.businessentities.VmDynamic;
import org.ovirt.engine.core.common.utils.Pair;
import org.ovirt.engine.core.compat.Guid;

public interface VmDynamicDao extends GenericDao<VmDynamic, Guid>, StatusAwareDao<Guid, VMStatus>,
        MassOperationsDao<VmDynamic, Guid> {
    /**
     * Retrieves all running dynamic VMs for the given VDS instance.
     *
     * @param vds
     *            the VDS id
     * @return the list of dynamic vms
     */
    List<VmDynamic> getAllRunningForVds(Guid vds);

    /**
     * Check whether or not any VM runs on the given VDS instance.
     *
     * @param vdsId
     *            the VDS id
     * @return false if no VM runs on the host, true otherwise
     */
    boolean isAnyVmRunOnVds(Guid vdsId);

    /**
     * Returns the dynamic VM with the specified id.
     *
     * @param id
     *            the id
     * @return the dynamic vm
     */
    @Override
    VmDynamic get(Guid id);

    /**
     * Updates the specified dynamic vm.
     *
     * @param vm
     *            the vm
     */
    @Override
    void update(VmDynamic vm);

    /**
     * Removes the specified dynamic vm.
     *
     * @param vm
     *            the vm
     */
    @Override
    void remove(Guid vm);

    /**
     * Saves the specified dynamic vm.
     *
     * @param vm
     *            the vm
     */
    @Override
    void save(VmDynamic vm);

    /**
     * Update the console user name and id, but only if it was empty before. This
     * method is needed in order to implement optimistic locking for the functionality
     * that allows reconnection to the console without rebooting the virtual machine.
     *
     * @param vm the dynamic data of the virtual machine
     * @return {@code true} if at least one row was updated, {@code false} otherwise
     */
    boolean updateConsoleUserWithOptimisticLocking(VmDynamic vm);

    void clearMigratingToVds(Guid id);


    /**
     * Update vm dynamics guest_agent_status field
     *
     * @param the vm id
     * @param new status
     */
    void updateGuestAgentStatus(Guid vmId, GuestAgentStatus guestAgentStatus);

    /**
     * Get value of hash field for every VM in vm_dynamic table.
     */
    List<Pair<Guid, String>> getAllDevicesHashes();

    /**
     * Set value of hash field for every VM in the list in one batch.
     *
     * @param vmHashes list of (VM id, hash value) pairs
     */
    void updateDevicesHashes(List<Pair<Guid, String>> vmHashes);

    /**
     * Update the status of all the given VMs to unknown
     *
     * @param vmIds - IDs of VMs to update
     */
    void updateVmsToUnknown(List<Guid> vmIds);


    /**
     * Retrieves all that are migrating to a certain Host
     * @param vdsId
     *            The Host id
     */
    List<VmDynamic> getAllMigratingToHost(Guid vdsId);
}