CloudSim源代码学习——虚拟机（VM）

 package org.cloudbus.cloudsim;

 import java.util.ArrayList;//This class provides methods to manipulate the size of the array that is used internally to store the list.
 import java.util.List;

 /**【虚拟机】
  * Vm represents a VM: 【it runs inside a Host, sharing hostList
  * with other VMs. It processes cloudlets. 】This processing happens according
  * to a policy, defined by the CloudletScheduler. Each VM has a owner（每个虚拟机有一个所有者）, which can
  * submit cloudlets to the VM to be executed
  *
  * @author        Rodrigo N. Calheiros
  * @author        Anton Beloglazov
  * @since        CloudSim Toolkit 1.0
  */
 public class Vm {

     /** The id.  ID号*/
     private int id;

     /** The user id. 用户编号*/
     private int userId;

     private String uid;

     /** The size. 大小 */
     private long size;

     /** The MIPS.处理速度MIPS */
     private double mips;

     /** The PEs number. PE数*/
     private int pesNumber;

     /** The ram. 内存*/
     private int ram;

     /** The bw.带宽 */
     private long bw;

     /** The vmm. 虚拟机管理程序*/
     private String vmm;

     /** The Cloudlet scheduler. 云任务调度程序*/
     private CloudletScheduler cloudletScheduler;

     /** The host.主机 */
     private Host host;

     /** In migration flag. 迁移标志*/
     private boolean inMigration;

     /** The current allocated size.当前分配大小 */
     private long currentAllocatedSize;

     /** The current allocated ram. 当前分配内存*/
     private int currentAllocatedRam;

     /** The current allocated bw. 当前分配带宽*/
     private long currentAllocatedBw;

     /** The current allocated mips. 当前分配mips*/
     private List<Double> currentAllocatedMips;

     /** The recently created. 最近创建*/
     private boolean recentlyCreated;

     /**【虚拟机特征对象】
      * Creates a new VMCharacteristics object.
      *
      * @param id unique ID of the VM
      * @param userId ID of the VM's owner
      * @param size amount of storage
      * @param ram amount of ram
      * @param bw amount of bandwidth
      * @param pesNumber amount of CPUs  CPU总和
      * @param vmm virtual machine monitor 虚拟机监控器
      * @param cloudletScheduler cloudletScheduler policy for cloudlets云任务调度协议
      * @param priority the priority 优先权
      * @param mips the mips
      *
      * @pre id >= 0
      * @pre userId >= 0
      * @pre size > 0
      * @pre ram > 0
      * @pre bw > 0
      * @pre cpus > 0
      * @pre priority >= 0
      * @pre cloudletScheduler != null
      * @post $none
      */
     public Vm(int id, int userId, double mips, int pesNumber, int ram, long bw, long size, String vmm, CloudletScheduler cloudletScheduler) {
         setId(id);
         setUserId(userId);
         setUid(getUid(userId, id));
         setMips(mips);
         setPesNumber(pesNumber);
         setRam(ram);
         setBw(bw);
         setSize(size);
         setVmm(vmm);
         setCloudletScheduler(cloudletScheduler);

         setInMigration(false);
         setRecentlyCreated(true);

         setCurrentAllocatedBw(0);
         setCurrentAllocatedMips(null);//怎么是null
         setCurrentAllocatedRam(0);
         setCurrentAllocatedSize(0);
     }

     /**【更新运行在虚拟机上云任务】
      * Updates the processing of cloudlets running on this VM.
      *
      * @param currentTime current simulation time
      * @param mipsShare array with MIPS share of each Pe available to the scheduler
      *
      * @return time predicted completion time【预测完成时间】 of the earliest finishing cloudlet, or 0
      * if there is no next events
      *
      * @pre currentTime >= 0
      * @post $none
      */
     public double updateVmProcessing(double currentTime, List<Double> mipsShare) {
         if (mipsShare != null) {
             return getCloudletScheduler().updateVmProcessing(currentTime, mipsShare);
         }
         return 0.0;
     }

     /**当前请求的MIPS
      * Gets the current requested mips.
      *
      * @return the current requested mips
      */
     public List<Double> getCurrentRequestedMips() {
         List<Double> currentRequestedMips = getCloudletScheduler().getCurrentRequestedMips();

         if (isRecentlyCreated()) {//新创建虚拟机
             boolean mipsIsNull = true;
             for (double mips : currentRequestedMips) {
                 if (mips > 0.0) {
                     mipsIsNull = false;
                     setRecentlyCreated(false);
                     break;
                 }
             }

             //if (mipsIsNull && isRecentlyCreated()) {
             if (mipsIsNull) {
                 currentRequestedMips = new ArrayList<Double>();
                 for (int i = 0; i < getPesNumber(); i++) {
                     currentRequestedMips.add(getMips());
                 }
             }
         }

         return currentRequestedMips;
     }

     /**当前请求的MIPS总数
      * Gets the current requested total mips.
      *
      * @return the current requested total mips
      */
     public double getCurrentRequestedTotalMips() {
         double totalRequestedMips = 0;
         for (double mips : getCurrentRequestedMips()) {
             totalRequestedMips += mips;
         }
         return totalRequestedMips;
     }

     /**请求的带宽
      * Gets the current requested bw.
      *
      * @return the current requested bw
      */
     public long getCurrentRequestedBw() {
         return getBw();
     }

     /**请求的内存
      * Gets the current requested ram.
      *
      * @return the current requested ram
      */
     public int getCurrentRequestedRam() {
         return getRam();
     }

     /**CPU利用率
      * Get utilization created by all clouddlets running on this VM.
      *
      * @param time the time
      *
      * @return total utilization
      */
     public double getTotalUtilizationOfCpu(double time) {
         return getCloudletScheduler().getTotalUtilizationOfCpu(time);
     }

     /**MIPS利用率
      * Get utilization created by all cloudlets running on this VM in MIPS.
      *
      * @param time the time
      *
      * @return total utilization
      */
     public double getTotalUtilizationOfCpuMips(double time) {
         return getTotalUtilizationOfCpu(time) * getMips();
     }

     public void setUid(String uid) {
         this.uid = uid;
     }

     /**虚拟机的唯一标示
      * Get unique string identificator of the VM.
      *
      * @return string uid
      */
     public String getUid() {
         return uid;
     }

     /**生成虚拟机标示
      * Generate unique string identificator of the VM.
      *
      * @param userId the user id
      * @param vmId the vm id
      *
      * @return string uid
      */
     public static String getUid(int userId, int vmId) {
         return userId + "-" + vmId;
     }

     /**取ID
      * Gets the id.
      *
      * @return the id
      */
     public int getId() {
         return id;
     }

     /**设置ID
      * Sets the id.
      *
      * @param id the new id
      */
     protected void setId(int id) {
         this.id = id;
     }

     /**设置用户ID
      * Sets the user id.
      *
      * @param userId the new user id
      */
     protected void setUserId(int userId) {
         this.userId = userId;
     }

     /**虚拟机所有者ID
      * Gets the ID of the owner of the VM.
      *
      * @return VM's owner ID
      *
      * @pre $none
      * @post $none
      */
     public int getUserId() {
         return userId;
     }

     /**取MIPS
      * Gets the mips.
      *
      * @return the mips
      */
     public double getMips() {
         return mips;
     }

     /**设置MIPS
      * Sets the mips.
      *
      * @param mips the new mips
      */
     protected void setMips(double mips) {
         this.mips = mips;
     }

     /**取pe数
      * Gets the pes number.
      *
      * @return the pes number
      */
     public int getPesNumber() {
         return pesNumber;
     }

     /**设置
      * Sets the pes number.
      *
      * @param pesNumber the new pes number
      */
     protected void setPesNumber(int pesNumber) {
         this.pesNumber = pesNumber;
     }

     /**总内存
      * Gets the amount of ram.
      *
      * @return amount of ram
      *
      * @pre $none
      * @post $none
      */
     public int getRam() {
         return ram;
     }

     /**设置内存
      * Sets the amount of ram.
      *
      * @param ram new amount of ram
      *
      * @pre ram > 0
      * @post $none
      */
     public void setRam(int ram) {
         this.ram = ram;
     }

     /**总带宽
      * Gets the amount of bandwidth.
      *
      * @return amount of bandwidth
      *
      * @pre $none
      * @post $none
      */
     public long getBw() {
         return bw;
     }

     /**设置带宽
      * Sets the amount of bandwidth.
      *
      * @param bw new amount of bandwidth
      *
      * @pre bw > 0
      * @post $none
      */
     public void setBw(long bw) {
         this.bw = bw;
     }

     /**取存储
      * Gets the amount of storage.
      *
      * @return amount of storage
      *
      * @pre $none
      * @post $none
      */
     public long getSize() {
         return size;
     }

     /**设置存储
      * Sets the amount of storage.
      *
      * @param size new amount of storage
      *
      * @pre size > 0
      * @post $none
      */
     public void setSize(long size) {
         this.size = size;
     }

     /**取VMM
      * Gets the VMM.
      *
      * @return VMM
      *
      * @pre $none
      * @post $none
      */
     public String getVmm(){
         return vmm;
     }

     /**设置VMM
      * Sets the VMM.
      *
      * @param vmm the new VMM
      */
     protected void setVmm(String vmm) {
         this.vmm = vmm;
     }

     /**设置主机
      * Sets the host that runs this VM.
      *
      * @param host Host running the VM
      *
      * @pre host != $null
      * @post $none
      */
     public void setHost(Host host){
         this.host = host;
     }

     /**获取主机
      * Gets the host.
      *
      * @return the host
      */
     public Host getHost() {
         return host;
     }

     /**虚拟机调度程序
      * Gets the vm scheduler.
      *
      * @return the vm scheduler
      */
     public CloudletScheduler getCloudletScheduler() {
         return cloudletScheduler;
     }

     /**设置虚拟机调度程序
      * Sets the vm scheduler.
      *
      * @param cloudletScheduler the new vm scheduler
      */
     protected void setCloudletScheduler(CloudletScheduler cloudletScheduler) {
         this.cloudletScheduler = cloudletScheduler;
     }

     /**是否迁移
      * Checks if is in migration.
      *
      * @return true, if is in migration
      */
     public boolean isInMigration() {
         return inMigration;
     }

     /**
      * Sets the in migration.
      *
      * @param inMigration the new in migration
      */
     public void setInMigration(boolean inMigration) {
         this.inMigration = inMigration;
     }

     /**当前分配大小
      * Gets the current allocated size.
      *
      * @return the current allocated size
      */
     public long getCurrentAllocatedSize() {
         return currentAllocatedSize;
     }

     /**
      * Sets the current allocated size.
      *
      * @param currentAllocatedSize the new current allocated size
      */
     protected void setCurrentAllocatedSize(long currentAllocatedSize) {
         this.currentAllocatedSize = currentAllocatedSize;
     }

     /**取当前分配的内存
      * Gets the current allocated ram.
      *
      * @return the current allocated ram
      */
     public int getCurrentAllocatedRam() {
         return currentAllocatedRam;
     }

     /**设置当前分配的内存
      * Sets the current allocated ram.
      *
      * @param currentAllocatedRam the new current allocated ram
      */
     public void setCurrentAllocatedRam(int currentAllocatedRam) {
         this.currentAllocatedRam = currentAllocatedRam;
     }

     /**取当前分配的带宽
      * Gets the current allocated bw.
      *
      * @return the current allocated bw
      */
     public long getCurrentAllocatedBw() {
         return currentAllocatedBw;
     }

     /**设置当前分配的带宽
      * Sets the current allocated bw.
      *
      * @param currentAllocatedBw the new current allocated bw
      */
     public void setCurrentAllocatedBw(long currentAllocatedBw) {
         this.currentAllocatedBw = currentAllocatedBw;
     }

     /**取当前分配的MIPS
      * Gets the current allocated mips.
      *
      * @return the current allocated mips
      */
     public List<Double> getCurrentAllocatedMips() {
         return currentAllocatedMips;
     }

     /**设置当前分配的MIPS
      * Sets the current allocated mips.
      *
      * @param currentAllocatedMips the new current allocated mips
      */
     public void setCurrentAllocatedMips(List<Double> currentAllocatedMips) {
         this.currentAllocatedMips = currentAllocatedMips;
     }

     /**是否最近创建
      * Checks if is recently created.
      *
      * @return true, if is recently created
      */
     public boolean isRecentlyCreated() {
         return recentlyCreated;
     }

     /**
      * Sets the recently created.
      *
      * @param recentlyCreated the new recently created
      */
     public void setRecentlyCreated(boolean recentlyCreated) {
         this.recentlyCreated = recentlyCreated;
     }

 }