/*
* Title: CloudSim Toolkit
* Description: CloudSim (Cloud Simulation) Toolkit for Modeling and Simulation of Clouds
* Licence: GPL - http://www.gnu.org/copyleft/gpl.html
*
* Copyright (c) 2009-2010, The University of Melbourne, Australia
*/
package org.cloudbus.cloudsim;
import java.text.DecimalFormat;
import java.util.ArrayList;
import java.util.LinkedList;
import java.util.List;
import org.cloudbus.cloudsim.core.CloudSim;
/**
* Cloudlet is an extension to the cloudlet. It stores, despite all the information
* encapsulated in the Cloudlet, the ID of the VM running it.
*
* @author Rodrigo N. Calheiros
* @author Anton Beloglazov
* @since CloudSim Toolkit 1.0
*/
//Cloudlet类存储封装在cloudlet，运行的VM的ID的所有信息
public class Cloudlet {
// the User or Broker ID. It is advisable that broker set this ID
// with its own ID, so that CloudResource returns to it after the execution
//User或者Broker的ID。建议将broker的ID设置该ID为自己的ID，这样CloudResource在执行后返回到它。
/** The user id. */
private int userId;
// the size of this Cloudlet to be executed in a CloudResource (unit: in MI)
//一个CloudResorce中要运行的cloudlet的大小（单位：MI）
/** The cloudlet length. */
private long cloudletLength;
// the input file size of this Cloudlet before execution (unit: in byte)
//执行前cloudlet的输入文件大小（单位：字节）
/** The cloudlet file size. */
private final long cloudletFileSize; // in byte = program + input data size
// the output file size of this Cloudlet after execution (unit: in byte)
//执行后输出文件的大小（单位：字节）
/** The cloudlet output size. */
private final long cloudletOutputSize;
//运行这个任务的Pe数
/** The pes number. */
private int pesNumber; // num of Pe required to execute this job
//cloudlet的ID
/** The cloudlet id. */
private final int cloudletId; // this Cloudlet ID
//cloudlet的状态
/** The status. */
private int status; // status of this Cloudlet
//十进制格式数据
/** The num. */
private DecimalFormat num; // to format the decimal number
//cloudlet的完成时间
/** The finish time. */
private double finishTime; // the time where this Cloudlet completes
// start time of executing this Cloudlet.
// With new functionalities, such as CANCEL, PAUSED and RESUMED, this
// attribute only stores the latest execution time. Previous execution time
// are ignored.
//该cloudlet的执行开始时间
//由于有像CANCEL, PAUSED, RESUMED这样的新功能，该属性仅存储最近开始时间。先前的执行时间被忽略。
/** The exec start time. */
private double execStartTime; // in simulation time
//该cloudlet保留的ID
/** The reservation id. */
private int reservationId = -1; // the ID of a reservation made for this cloudlet
// records the transaction history for this Cloudlet
//是否保存该cloudlet的事务历史记录
/** The record. */
private final boolean record; // record a history or not
//换行符
/** The newline. */
private String newline;
//历史记录
/** The history. */
private StringBuffer history;
//资源列表
/** The res list. */
private final List<Resource> resList;
//索引号
/** The index. */
private int index;
// differentiated service
//资源调度方式
/** The class type. */
private int classType; // class type of Cloudlet for resource scheduling
/** The net to s. */
//通过network发送cloudlet的ToS
private int netToS; // ToS for sending Cloudlet over the network
// Below are CONSTANTS attributes
//cloudlet创建并加入到CloudletList对象
/** The Cloudlet has been created and added to the CloudletList object. */
public static final int CREATED = 0;
//cloudlet按计划分配给CloudResource对象
/** The Cloudlet has been assigned to a CloudResource object as planned. */
public static final int READY = 1;
//cloudlet移动到cloud节点
/** The Cloudlet has moved to a Cloud node. */
public static final int QUEUED = 2;
//cloudlet在cloud节点中执行
/** The Cloudlet is in execution in a Cloud node. */
public static final int INEXEC = 3;
//cloudlet运行成功
/** The Cloudlet has been executed successfully. */
public static final int SUCCESS = 4;
//cloudlet运行失败
/** The Cloudlet is failed. */
public static final int FAILED = 5;
//cloudlet被取消
/** The Cloudlet has been canceled. */
public static final int CANCELED = 6;
//cloudlet被暂停，可以通过改变状态为RESUMED来恢复运行
/** The Cloudlet has been paused. It can be resumed by changing the status into <tt>RESUMED</tt>. */
public static final int PAUSED = 7;
//从PAUSED状态恢复运行
/** The Cloudlet has been resumed from <tt>PAUSED</tt> state. */
public static final int RESUMED = 8;
//cloudlet由于资源问题而失败
/** The cloudlet has failed due to a resource failure. */
public static final int FAILED_RESOURCE_UNAVAILABLE = 9;
//vm的ID
/** The vm id. */
protected int vmId;
//单位带宽费用
/** The cost per bw. */
protected double costPerBw;
//累计带宽费用
/** The accumulated bw cost. */
protected double accumulatedBwCost;
// Utilization
//cpu模型的Utilization
/** The utilization of cpu model. */
private UtilizationModel utilizationModelCpu;
//memory模型的utilization模型
/** The utilization of memory model. */
private UtilizationModel utilizationModelRam;
//带宽模型的Utilization模型
/** The utilization of bw model. */
private UtilizationModel utilizationModelBw;
// Data cloudlet
//请求文件的文件名列表
/** The required files. */
private List<String> requiredFiles = null; // list of required filenames
/**
* Allocates a new Cloudlet object. The Cloudlet length, input and output
* file sizes should be greater than or equal to 1.
* By default this constructor sets the history of this object.
*
* @param cloudletId the unique ID of this Cloudlet
* @param cloudletLength the length or size (in MI) of this cloudlet
* to be executed in a PowerDatacenter
* @param cloudletFileSize the file size (in byte) of this cloudlet
* <tt>BEFORE</tt> submitting to a PowerDatacenter
* @param cloudletOutputSize the file size (in byte) of this cloudlet
* <tt>AFTER</tt> finish executing by
* a PowerDatacenter
* @param pesNumber the pes number
* @param utilizationModelCpu the utilization model cpu
* @param utilizationModelRam the utilization model ram
* @param utilizationModelBw the utilization model bw
*
* @pre cloudletID >= 0
* @pre cloudletLength >= 0.0
* @pre cloudletFileSize >= 1
* @pre cloudletOutputSize >= 1
* @post $none
*/
//构造函数。cloulet长度，输入输出文件大小需要大于等于1.
//默认设置历史记录
public Cloudlet(
final int cloudletId,
final long cloudletLength,
final int pesNumber,
final long cloudletFileSize,
final long cloudletOutputSize,
final UtilizationModel utilizationModelCpu,
final UtilizationModel utilizationModelRam,
final UtilizationModel utilizationModelBw) {
this(cloudletId, cloudletLength, pesNumber, cloudletFileSize, cloudletOutputSize, utilizationModelCpu, utilizationModelRam, utilizationModelBw, true);
this.vmId=-1;
this.accumulatedBwCost=0.0;
this.costPerBw=0.0;
this.requiredFiles = new LinkedList<String>();
}
/**
* Allocates a new Cloudlet object. The Cloudlet length, input and output
* file sizes should be greater than or equal to 1.
*
* @param cloudletId the unique ID of this cloudlet
* @param cloudletLength the length or size (in MI) of this cloudlet
* to be executed in a PowerDatacenter
* @param cloudletFileSize the file size (in byte) of this cloudlet
* <tt>BEFORE</tt> submitting to a PowerDatacenter
* @param cloudletOutputSize the file size (in byte) of this cloudlet
* <tt>AFTER</tt> finish executing by
* a PowerDatacenter
* @param record record the history of this object or not
* @param fileList list of files required by this cloudlet
* @param pesNumber the pes number
* @param utilizationModelCpu the utilization model cpu
* @param utilizationModelRam the utilization model ram
* @param utilizationModelBw the utilization model bw
*
* @pre cloudletID >= 0
* @pre cloudletLength >= 0.0
* @pre cloudletFileSize >= 1
* @pre cloudletOutputSize >= 1
* @post $none
*/
public Cloudlet(
final int cloudletId,
final long cloudletLength,
final int pesNumber,
final long cloudletFileSize,
final long cloudletOutputSize,
final UtilizationModel utilizationModelCpu,
final UtilizationModel utilizationModelRam,
final UtilizationModel utilizationModelBw,
final boolean record,
final List<String> fileList) {
this(cloudletId, cloudletLength, pesNumber, cloudletFileSize, cloudletOutputSize, utilizationModelCpu, utilizationModelRam, utilizationModelBw, record);
this.vmId=-1;
this.accumulatedBwCost=0.0;
this.costPerBw=0.0;
this.requiredFiles = fileList;
}
/**
* Allocates a new Cloudlet object. The Cloudlet length, input and output
* file sizes should be greater than or equal to 1.
* By default this constructor sets the history of this object.
*
* @param cloudletId the unique ID of this Cloudlet
* @param cloudletLength the length or size (in MI) of this cloudlet
* to be executed in a PowerDatacenter
* @param cloudletFileSize the file size (in byte) of this cloudlet
* <tt>BEFORE</tt> submitting to a PowerDatacenter
* @param cloudletOutputSize the file size (in byte) of this cloudlet
* <tt>AFTER</tt> finish executing by
* a PowerDatacenter
* @param fileList list of files required by this cloudlet
* @param pesNumber the pes number
* @param utilizationModelCpu the utilization model cpu
* @param utilizationModelRam the utilization model ram
* @param utilizationModelBw the utilization model bw
*
* @pre cloudletID >= 0
* @pre cloudletLength >= 0.0
* @pre cloudletFileSize >= 1
* @pre cloudletOutputSize >= 1
* @post $none
*/
public Cloudlet(
final int cloudletId,
final long cloudletLength,
final int pesNumber,
final long cloudletFileSize,
final long cloudletOutputSize,
final UtilizationModel utilizationModelCpu,
final UtilizationModel utilizationModelRam,
final UtilizationModel utilizationModelBw,
final List<String> fileList) {
this(cloudletId, cloudletLength, pesNumber, cloudletFileSize, cloudletOutputSize, utilizationModelCpu, utilizationModelRam, utilizationModelBw, true);
this.vmId=-1;
this.accumulatedBwCost=0.0;
this.costPerBw=0.0;
this.requiredFiles = fileList;
}
/**
* Allocates a new Cloudlet object. The Cloudlet length, input and output
* file sizes should be greater than or equal to 1.
*
* @param cloudletId the unique ID of this cloudlet
* @param cloudletLength the length or size (in MI) of this cloudlet
* to be executed in a PowerDatacenter
* @param cloudletFileSize the file size (in byte) of this cloudlet
* <tt>BEFORE</tt> submitting to a PowerDatacenter
* @param cloudletOutputSize the file size (in byte) of this cloudlet
* <tt>AFTER</tt> finish executing by
* a PowerDatacenter
* @param record record the history of this object or not
* @param pesNumber the pes number
* @param utilizationModelCpu the utilization model cpu
* @param utilizationModelRam the utilization model ram
* @param utilizationModelBw the utilization model bw
*
* @pre cloudletID >= 0
* @pre cloudletLength >= 0.0
* @pre cloudletFileSize >= 1
* @pre cloudletOutputSize >= 1
* @post $none
*/
public Cloudlet(
final int cloudletId,
final long cloudletLength,
final int pesNumber,
final long cloudletFileSize,
final long cloudletOutputSize,
final UtilizationModel utilizationModelCpu,
final UtilizationModel utilizationModelRam,
final UtilizationModel utilizationModelBw,
final boolean record) {
this.userId = -1; // to be set by a Broker or user
this.status = CREATED;
this.cloudletId = cloudletId;
this.pesNumber = pesNumber;
this.execStartTime = 0.0;
this.finishTime = -1.0; // meaning this Cloudlet hasn't finished yet
this.classType = 0;
this.netToS = 0;
// Cloudlet length, Input and Output size should be at least 1 byte.
this.cloudletLength = Math.max(1, cloudletLength);
this.cloudletFileSize = Math.max(1, cloudletFileSize);
this.cloudletOutputSize = Math.max(1, cloudletOutputSize);
// Normally, a Cloudlet is only executed on a resource without being
// migrated to others. Hence, to reduce memory consumption, set the
// size of this ArrayList to be less than the default one.
//通常，cloudlet仅在一个资源上执行，而不会迁移到另一个。因此，为了减少内存消耗，设置ArrayList的大小为//小于默认大小
this.resList = new ArrayList<Resource>(2);
this.index = -1;
this.record = record;
this.vmId = -1;
this.accumulatedBwCost = 0.0;
this.costPerBw = 0.0;
this.requiredFiles = new LinkedList<String>();
setUtilizationModelCpu(utilizationModelCpu);
setUtilizationModelRam(utilizationModelRam);
setUtilizationModelBw(utilizationModelBw);
}
INTERNAL CLASS ///
/**
* Internal class that keeps track Cloudlet's movement in different
* CloudResources.
*/
//追踪cloudlet在不同cloudResource中移动的轨迹
private static class Resource {
/** Cloudlet's submission time to a CloudResource. */
//cloudlet提交到某个CloudResource的时间
public double submissionTime = 0.0;
//cloudlet在某个CloudResource中驻留时间（从到达时间到离开时间）
/** The time of this Cloudlet resides in a CloudResource (from arrival time until departure time). */
public double wallClockTime = 0.0;
//cloudlet在某个CloudResource的总执行时间
/** The total execution time of this Cloudlet in a CloudResource. */
public double actualCPUTime = 0.0;
//执行该cloudlet的每秒费用
/** Cost per second a CloudResource charge to execute this Cloudlet. */
public double costPerSec = 0.0;
//目前为止，cloudlet的执行长度
/** Cloudlet's length finished so far. */
public long finishedSoFar = 0;
//cloudResource的ID
/** a CloudResource id. */
public int resourceId = -1;
//cloudResource的名字
/** a CloudResource name. */
public String resourceName = null;
} // end of internal class
End of Internal Class //
/**
* Sets the id of the reservation made for this cloudlet.
*
* @param resId the reservation ID
*
* @return <tt>true</tt> if the ID has successfully been set or
* <tt>false</tt> otherwise.
*/
//设置该cloudlet的保留ID
public boolean setReservationId(final int resId) {
if(resId <= 0) {
return false;
}
reservationId = resId;
return true;
}
/**
* Gets the reservation ID that owns this Cloudlet.
*
* @return a reservation ID
*
* @pre $none
* @post $none
*/
//获取保留ID
public int getReservationId() {
return reservationId;
}
/**
* Checks whether this Cloudlet is submitted by reserving or not.
*
* @return <tt>true</tt> if this Cloudlet has reserved before,
* <tt>false</tt> otherwise
*/
//检查该cloudlet是否被提交
public boolean hasReserved() {
if (reservationId == -1) {
return false;
}
return true;
}
/**
* Sets the length or size (in MI) of this Cloudlet
* to be executed in a CloudResource.
* This Cloudlet length is calculated for 1 Pe only <tt>not</tt> the total
* length.
*
* @param cloudletLength the length or size (in MI) of this Cloudlet
* to be executed in a CloudResource
*
* @return <tt>true</tt> if it is successful, <tt>false</tt> otherwise
*
* @pre cloudletLength > 0
* @post $none
*/
//设置cloudlet的长度（单位：MI）
public boolean setCloudletLength(final long cloudletLength) {
if (cloudletLength <= 0) {
return false;
}
this.cloudletLength = cloudletLength;
return true;
}
/**
* Sets the network service level for sending this cloudlet over a network.
*
* @param netServiceLevel determines the kind of service this cloudlet
* receives in the network (applicable to
* selected PacketScheduler class only)
*
* @return <code>true</code> if successful.
*
* @pre netServiceLevel >= 0
* @post $none
*/
//设置该cloudlet通过网络发送的网络服务层
public boolean setNetServiceLevel(final int netServiceLevel) {
boolean success = false;
if (netServiceLevel > 0) {
netToS = netServiceLevel;
success = true;
}
return success;
}
/**
* Gets the network service level for sending this cloudlet over a network.
*
* @return the network service level
*
* @pre $none
* @post $none
*/
//获取该cloudlet通过网络发送的网络服务层
public int getNetServiceLevel() {
return netToS;
}
/**
* Gets the waiting time of this cloudlet executed on a resource.
*
* @return the waiting time
*
* @pre $none
* @post $none
*/
//获取该cloudlet在某个资源上的等待时间
public double getWaitingTime() {
if (index == -1) {
return 0;
}
// use the latest resource submission time
final double subTime = resList.get(index).submissionTime;
return execStartTime - subTime;
}
/**
* Sets the classType or priority of this Cloudlet for scheduling on a
* resource.
*
* @param classType classType of this Cloudlet
*
* @return <tt>true</tt> if it is successful, <tt>false</tt> otherwise
*
* @pre classType > 0
* @post $none
*/
//设置调度模式
public boolean setClassType(final int classType) {
boolean success = false;
if (classType > 0) {
this.classType = classType;
success = true;
}
return success;
}
/**
* Gets the classtype or priority of this Cloudlet for scheduling on a
* resource.
*
* @return classtype of this cloudlet
*
* @pre $none
* @post $none
*/
//获取调度模式
public int getClassType() {
return classType;
}
/**
* Sets the number of PEs required to run this Cloudlet. <br>
* NOTE: The Cloudlet length is computed only for 1 Pe for simplicity. <br>
* For example, this Cloudlet has a length of 500 MI and requires 2 PEs.
* This means each Pe will execute 500 MI of this Cloudlet.
*
* @param pesNumber number of Pe
*
* @return <tt>true</tt> if it is successful, <tt>false</tt> otherwise
*
* @pre numPE > 0
* @post $none
*/
//设置运行需要的PE数量
public boolean setPesNumber(final int pesNumber) {
if (pesNumber > 0) {
this.pesNumber = pesNumber;
return true;
}
return false;
}
/**
* Gets the number of PEs required to run this Cloudlet.
*
* @return number of PEs
*
* @pre $none
* @post $none
*/
//获取运行需要的PE数量
public int getPesNumber() {
return pesNumber;
}
/**
* Gets the history of this Cloudlet. The layout of this history is in a
* readable table column with <tt>time</tt> and <tt>description</tt>
* as headers.
*
* @return a String containing the history of this Cloudlet object.
*
* @pre $none
* @post $result != null
*/
//获取cloudlet的历史记录
public String getCloudletHistory() {
String msg = null;
if (history == null) {
msg = "No history is recorded for Cloudlet #" + cloudletId;
} else {
msg = history.toString();
}
return msg;
}
/**
* Gets the length of this Cloudlet that has been executed so far
* from the latest CloudResource. This
* method is useful when trying to move this Cloudlet into different
* CloudResources or to cancel it.
*
* @return the length of a partially executed Cloudlet or the full Cloudlet
* length if it is completed
*
* @pre $none
* @post $result >= 0.0
*/
//获取cloudlet在最近的CloudResource上到目前为止的执行时间
public long getCloudletFinishedSoFar() {
if (index == -1) {
return cloudletLength;
}
final long finish = resList.get(index).finishedSoFar;
if (finish > cloudletLength) {
return cloudletLength;
}
return finish;
}
/**
* Checks whether this Cloudlet has finished execution or not.
*
* @return <tt>true</tt> if this Cloudlet has finished execution,
* <tt>false</tt> otherwise
*
* @pre $none
* @post $none
*/
//检查该cloudlet是否执行完成
public boolean isFinished() {
if (index == -1) {
return false;
}
boolean completed = false;
// if result is 0 or -ve then this Cloudlet has finished
final long finish = resList.get(index).finishedSoFar;
final long result = cloudletLength - finish;
if (result <= 0.0) {
completed = true;
}
return completed;
}
/**
* Sets the length of this Cloudlet that has been executed so far.
* This method is used by ResCloudlet class when an application
* is decided to cancel or to move this Cloudlet into different
* CloudResources.
*
* @param length length of this Cloudlet
*
* @see gridsim.AllocPolicy
* @see gridsim.ResCloudlet
* @pre length >= 0.0
* @post $none
*/
//设置目前为止执行长度
public void setCloudletFinishedSoFar(final long length) {
// if length is -ve then ignore
if (length < 0.0 || index < 0) {
return;
}
final Resource res = resList.get(index);
res.finishedSoFar = length;
if (record) {
write("Sets the length's finished so far to " + length);
}
}
/**
* Sets the user or owner ID of this Cloudlet. It is <tt>VERY</tt> important
* to set the user ID, otherwise this Cloudlet will not be executed in a
* CloudResource.
*
* @param id the user ID
*
* @pre id >= 0
* @post $none
*/
//设置cloudlet的用户或拥有者ID
public void setUserId(final int id) {
userId = id;
if (record) {
write("Assigns the Cloudlet to " + CloudSim.getEntityName(id) + " (ID #" + id + ")");
}
}
/**
* Gets the user or owner ID of this Cloudlet.
*
* @return the user ID or <tt>-1</tt> if the user ID has not been set before
*
* @pre $none
* @post $result >= -1
*/
//获取cloudlet的用户或拥有者ID
public int getUserId() {
return userId;
}
/**
* Gets the latest resource ID that processes this Cloudlet.
*
* @return the resource ID or <tt>-1</tt> if none
*
* @pre $none
* @post $result >= -1
*/
//获取最近执行该cloudlet的资源ID
public int getResourceId() {
if (index == -1) {
return -1;
}
return resList.get(index).resourceId;
}
/**
* Gets the input file size of this Cloudlet <tt>BEFORE</tt>
* submitting to a CloudResource.
*
* @return the input file size of this Cloudlet
*
* @pre $none
* @post $result >= 1
*/
//获取cloudlet的输入文件大小
public long getCloudletFileSize() {
return cloudletFileSize;
}
/**
* Gets the output size of this Cloudlet <tt>AFTER</tt> submitting and
* executing to a CloudResource.
*
* @return the Cloudlet output file size
*
* @pre $none
* @post $result >= 1
*/
//获取cloudlet的输出文件大小
public long getCloudletOutputSize() {
return cloudletOutputSize;
}
/**
* Sets the resource parameters for which this Cloudlet is going to be
* executed. <br>
* NOTE: This method <tt>should</tt> be called only by a resource entity,
* not the user or owner of this Cloudlet.
*
* @param resourceID the CloudResource ID
* @param cost the cost running this CloudResource per second
*
* @pre resourceID >= 0
* @pre cost > 0.0
* @post $none
*/
//设置该cloudlet将要执行的资源参数
public void setResourceParameter(final int resourceID, final double cost) {
final Resource res = new Resource();
res.resourceId = resourceID;
res.costPerSec = cost;
res.resourceName = CloudSim.getEntityName(resourceID);
// add into a list if moving to a new grid resource
resList.add(res);
if (index == -1 && record) {
write("Allocates this Cloudlet to " + res.resourceName + " (ID #" + resourceID + ") with cost = {1}quot; + cost + "/sec");
} else if (record) {
final int id = resList.get(index).resourceId;
final String name = resList.get(index).resourceName;
write("Moves Cloudlet from " + name + " (ID #" + id + ") to " +
res.resourceName + " (ID #" + resourceID +
") with cost = {1}quot; + cost + "/sec");
}
index++; // initially, index = -1
}
/**
* Sets the submission or arrival time of this Cloudlet into a CloudResource.
*
* @param clockTime the submission time
*
* @pre clockTime >= 0.0
* @post $none
*/
//设置该cloudlet提交到某个cloudResource的时间
public void setSubmissionTime(final double clockTime) {
if (clockTime < 0.0 || index < 0) {
return;
}
final Resource res = resList.get(index);
res.submissionTime = clockTime;
if (record) {
write( "Sets the submission time to " + num.format(clockTime) );
}
}
/**
* Gets the submission or arrival time of this Cloudlet from
* the latest CloudResource.
*
* @return the submission time or <tt>0.0</tt> if none
*
* @pre $none
* @post $result >= 0.0
*/
//获取cloudlet到达最近资源的提交时间
public double getSubmissionTime() {
if (index == -1) {
return 0.0;
}
return resList.get(index).submissionTime;
}
/**
* Sets the execution start time of this Cloudlet inside a CloudResource.
* <b>NOTE:</b> With new functionalities, such as being able to cancel /
* to pause / to resume this Cloudlet, the execution start time only holds
* the latest one. Meaning, all previous execution start time are ignored.
*
* @param clockTime the latest execution start time
*
* @pre clockTime >= 0.0
* @post $none
*/
//设置cloudlet在某个cloudResource资源的执行开始时间。
public void setExecStartTime(final double clockTime) {
execStartTime = clockTime;
if (record) {
write("Sets the execution start time to " + num.format(clockTime));
}
}
/**
* Gets the latest execution start time.
*
* @return the latest execution start time
*
* @pre $none
* @post $result >= 0.0
*/
//获取最近执行开始时间
public double getExecStartTime() {
return execStartTime;
}
/**
* Sets this Cloudlet's execution parameters. These parameters are set by
* the CloudResource before departure or sending back to the original
* Cloudlet's owner.
*
* @param wallTime the time of this Cloudlet resides in
* a CloudResource (from arrival time until
* departure time).
* @param actualTime the total execution time of this Cloudlet in a
* CloudResource.
*
* @pre wallTime >= 0.0
* @pre actualTime >= 0.0
* @post $none
*/
//设置执行参数，这些参数在离开cloudResource时由cloudResource设置。
public void setExecParam(final double wallTime, final double actualTime) {
if (wallTime < 0.0 || actualTime < 0.0 || index < 0) {
return;
}
final Resource res = resList.get(index);
res.wallClockTime = wallTime;
res.actualCPUTime = actualTime;
if (record) {
write("Sets the wall clock time to "+ num.format(wallTime)+
" and the actual CPU time to " + num.format(actualTime));
}
}
/**
* Sets the status code of this Cloudlet.
*
* @param newStatus the status code of this Cloudlet
*
* @throws Exception Invalid range of Cloudlet status
*
* @pre newStatus >= 0 && newStatus <= 8
* @post $none
*/
//设置该cloudlet的状态码
public void setCloudletStatus(final int newStatus) throws Exception {
// if the new status is same as current one, then ignore the rest
if (status == newStatus) {
return;
}
// throws an exception if the new status is outside the range
if (newStatus < Cloudlet.CREATED || newStatus > Cloudlet.FAILED_RESOURCE_UNAVAILABLE) {
throw new Exception("Cloudlet.setCloudletStatus() : Error - Invalid integer range for Cloudlet status.");
}
if (newStatus == Cloudlet.SUCCESS) {
finishTime = CloudSim.clock();
}
if (record) {
write("Sets Cloudlet status from " + getCloudletStatusString() + " to " + Cloudlet.getStatusString(newStatus));
}
this.status = newStatus;
}
/**
* Gets the status code of this Cloudlet.
*
* @return the status code of this Cloudlet
*
* @pre $none
* @post $result >= 0
*/
//获取状态码
public int getCloudletStatus() {
return status;
}
/**
* Gets the string representation of the current Cloudlet status code.
*
* @return the Cloudlet status code as a string or <tt>null</tt> if the
* status code is unknown
*
* @pre $none
* @post $none
*/
//获取状态码得字符串表示方式
public String getCloudletStatusString() {
return Cloudlet.getStatusString(status);
}
/**
* Gets the string representation of the given Cloudlet status code.
*
* @param status the Cloudlet status code
*
* @return the Cloudlet status code as a string or <tt>null</tt> if the
* status code is unknown
*
* @pre $none
* @post $none
*/
//获取状态码得字符串表示
public static String getStatusString(final int status) {
String statusString = null;
switch (status)
{
case Cloudlet.CREATED:
statusString = "Created";
break;
case Cloudlet.READY:
statusString = "Ready";
break;
case Cloudlet.INEXEC:
statusString = "InExec";
break;
case Cloudlet.SUCCESS:
statusString = "Success";
break;
case Cloudlet.QUEUED:
statusString = "Queued";
break;
case Cloudlet.FAILED:
statusString = "Failed";
break;
case Cloudlet.CANCELED:
statusString = "Canceled";
break;
case Cloudlet.PAUSED:
statusString = "Paused";
break;
case Cloudlet.RESUMED:
statusString = "Resumed";
break;
case Cloudlet.FAILED_RESOURCE_UNAVAILABLE :
statusString = "Failed_resource_unavailable";
break;
default:
break;
}
return statusString;
}
/**
* Gets the length of this Cloudlet.
*
* @return the length of this Cloudlet
*
* @pre $none
* @post $result >= 0.0
*/
//获取cloudlet的长度
public long getCloudletLength() {
return cloudletLength;
}
/**
* Gets the total length (across all PEs) of this Cloudlet.
*
* @return the total length of this Cloudlet
*
* @pre $none
* @post $result >= 0.0
*/
//获取cloudlet在所有PE上的总长度
public long getCloudletTotalLength() {
return getCloudletLength() * getPesNumber();
}
/**
* Gets the cost running this Cloudlet in the latest CloudResource.
*
* @return the cost associated with running this Cloudlet
* or <tt>0.0</tt> if none
*
* @pre $none
* @post $result >= 0.0
*/
//获取在最近资源上运行这个cloudlet的费用
public double getCostPerSec() {
if (index == -1) {
return 0.0;
}
return resList.get(index).costPerSec;
}
/**
* Gets the time of this Cloudlet resides in the latest CloudResource
* (from arrival time until departure time).
*
* @return the time of this Cloudlet resides in a CloudResource
*
* @pre $none
* @post $result >= 0.0
*/
//获取该cloudlet在最近cloudResource的驻留时间
public double getWallClockTime() {
if (index == -1) {
return 0.0;
}
return resList.get(index).wallClockTime;
}
/**
* Gets all the CloudResource names that executed this Cloudlet.
*
* @return an array of CloudResource names or <tt>null</tt> if it has none
*
* @pre $none
* @post $none
*/
//获取所有执行该cloudlet的cloudResource名称
public String[] getAllResourceName() {
final int size = resList.size();
String[] data = null;
if (size > 0) {
data = new String[size];
for (int i = 0; i < size; i++) {
data[i] = resList.get(i).resourceName;
}
}
return data;
}
/**
* Gets all the CloudResource IDs that executed this Cloudlet.
*
* @return an array of CloudResource IDs or <tt>null</tt> if it has none
*
* @pre $none
* @post $none
*/
//获取所有运行该cloudlet的cloudResource的ID
public int[] getAllResourceId() {
final int size = resList.size();
int[] data = null;
if (size > 0) {
data = new int[size];
for (int i = 0; i < size; i++) {
data[i] = resList.get(i).resourceId;
}
}
return data;
}
/**
* Gets the total execution time of this Cloudlet in a given CloudResource ID.
*
* @param resId a CloudResource entity ID
*
* @return the total execution time of this Cloudlet in a CloudResource
* or <tt>0.0</tt> if not found
*
* @pre resId >= 0
* @post $result >= 0.0
*/
//获取该cloudlet在某个给定CloudResource上的总运行时间
public double getActualCPUTime(final int resId) {
Resource resource = getResourceById(resId);
if (resource != null) {
return resource.actualCPUTime;
}
return 0.0;
}
/**
* Gets the cost running this Cloudlet in a given CloudResource ID.
*
* @param resId a CloudResource entity ID
*
* @return the cost associated with running this Cloudlet
* or <tt>0.0</tt> if not found
*
* @pre resId >= 0
* @post $result >= 0.0
*/
//获取在某个给定CloudResource上运行该cloudlet的费用
public double getCostPerSec(final int resId) {
Resource resource = getResourceById(resId);
if (resource != null) {
return resource.costPerSec;
}
return 0.0;
}
/**
* Gets the length of this Cloudlet that has been executed so far in a given
* CloudResource ID. This method is useful when trying to move this Cloudlet
* into different CloudResources or to cancel it.
*
* @param resId a CloudResource entity ID
*
* @return the length of a partially executed Cloudlet or the full Cloudlet
* length if it is completed or <tt>0.0</tt> if not found
*
* @pre resId >= 0
* @post $result >= 0.0
*/
//获取该cloudlet在某个CloudResource上目前以运行长度
public long getCloudletFinishedSoFar(final int resId) {
Resource resource = getResourceById(resId);
if (resource != null) {
return resource.finishedSoFar;
}
return 0;
}
/**
* Gets the submission or arrival time of this Cloudlet in the
* given CloudResource ID.
*
* @param resId a CloudResource entity ID
*
* @return the submission time or <tt>0.0</tt> if not found
*
* @pre resId >= 0
* @post $result >= 0.0
*/
//设置cloudlet在某个cloudResource的提交时间
public double getSubmissionTime(final int resId) {
Resource resource = getResourceById(resId);
if (resource != null) {
return resource.submissionTime;
}
return 0.0;
}
/**
* Gets the time of this Cloudlet resides in a given CloudResource ID
* (from arrival time until departure time).
*
* @param resId a CloudResource entity ID
*
* @return the time of this Cloudlet resides in the CloudResource
* or <tt>0.0</tt> if not found
*
* @pre resId >= 0
* @post $result >= 0.0
*/
//获取该cloudlet在某个给定cloudResource上的驻留时间
public double getWallClockTime(final int resId) {
Resource resource = getResourceById(resId);
if (resource != null) {
return resource.wallClockTime;
}
return 0.0;
}
/**
* Gets the CloudResource name based on its ID.
*
* @param resId a CloudResource entity ID
*
* @return the CloudResource name or <tt>null</tt> if not found
*
* @pre resId >= 0
* @post $none
*/
//根据ID获取CloudResource的名字
public String getResourceName(final int resId) {
Resource resource = getResourceById(resId);
if (resource != null) {
return resource.resourceName;
}
return null;
}
/**
* Gets the resource by id.
*
* @param resourceId the resource id
*
* @return the resource by id
*/
//根据资源ID获得资源
public Resource getResourceById(final int resourceId) {
for (Resource resource : resList) {
if (resource.resourceId == resourceId) {
return resource;
}
}
return null;
}
/**
* Gets the finish time of this Cloudlet in a CloudResource.
*
* @return the finish or completion time of this Cloudlet or <tt>-1</tt> if
* not finished yet.
*
* @pre $none
* @post $result >= -1
*/
//获取cloudlet在某个CloudResource的完成时间
public double getFinishTime() {
return finishTime;
}
// PROTECTED METHODS //
/**
* Writes this particular history transaction of this Cloudlet into a log.
*
* @param str a history transaction of this Cloudlet
*
* @pre str != null
* @post $none
*/
//写特定的历史事务到log日志
protected void write(final String str) {
if (!record) {
return;
}
if (num == null || history == null) { // Creates the history or transactions of this Cloudlet
newline = System.getProperty("line.separator");
num = new DecimalFormat("#0.00#"); // with 3 decimal spaces
history = new StringBuffer(1000);
history.append("Time below denotes the simulation time.");
history.append( System.getProperty("line.separator") );
history.append("Time (sec) Description Cloudlet #"+cloudletId);
history.append( System.getProperty("line.separator") );
history.append("------------------------------------------");
history.append( System.getProperty("line.separator") );
history.append( num.format(CloudSim.clock()) );
history.append(" Creates Cloudlet ID #" + cloudletId);
history.append( System.getProperty("line.separator") );
}
history.append(num.format(CloudSim.clock()));
history.append(" " + str + newline);
}
/**
* Get the status of the Cloudlet.
*
* @return status of the Cloudlet
*
* @pre $none
* @post $none
*/
//获取cloudlet状态
public int getStatus(){
return getCloudletStatus();
}
/**
* Gets the ID of this Cloudlet.
*
* @return Cloudlet Id
*
* @pre $none
* @post $none
*/
//获取cloudlet的ID
public int getCloudletId() {
return this.cloudletId;
}
/**
* Gets the ID of the VM that will run this Cloudlet.
*
* @return VM Id, -1 if the Cloudlet was not assigned to a VM
*
* @pre $none
* @post $none
*/
//获取将运行该cloudlet的VM的ID
public int getVmId() {
return vmId;
}
/**
* Sets the ID of the VM that will run this Cloudlet.
*
* @param vmId the vm id
*
* @pre id >= 0
* @post $none
*/
//设置将运行该cloudlet的VM的ID
public void setVmId(final int vmId) {
this.vmId = vmId;
}
/**
* Returns the time the Cloudlet actually run.
*
* @return time in which the Cloudlet was running
*
* @pre $none
* @post $none
*/
//获取该cloudlet的真正运行时间
public double getActualCPUTime(){
return getFinishTime() - getExecStartTime();
}
/**
* Sets the resource parameters for which this Cloudlet is going to be
* executed. <br>
* NOTE: This method <tt>should</tt> be called only by a resource entity,
* not the user or owner of this Cloudlet.
*
* @param resourceID the CloudResource ID
* @param costPerCPU the cost running this Cloudlet per second
* @param costPerBw the cost of data transfer to this PowerDatacenter
*
* @pre resourceID >= 0
* @pre cost > 0.0
* @post $none
*/
//设置该cloudlet将运行的资源参数
public void setResourceParameter(final int resourceID, final double costPerCPU, final double costPerBw) {
setResourceParameter(resourceID, costPerCPU);
this.costPerBw = costPerBw;
this.accumulatedBwCost = costPerBw * getCloudletFileSize();
}
/**
* Gets the total cost of processing or executing this Cloudlet
* <tt>Processing Cost = input data transfer + processing cost + output transfer cost</tt>.
*
* @return the total cost of processing Cloudlet
*
* @pre $none
* @post $result >= 0.0
*/
//获取运行该cloudlet的总费用
public double getProcessingCost() {
//cloudlet cost: execution cost...
//double cost = getProcessingCost();
double cost = 0;
//...plus input data transfer cost...
cost += this.accumulatedBwCost;
//...plus output cost
cost += this.costPerBw * getCloudletOutputSize();
return cost;
}
// Data cloudlet
/**
* Gets the required files.
*
* @return the required files
*/
//获取请求的文件
public List<String> getRequiredFiles() {
return requiredFiles;
}
/**
* Sets the required files.
*
* @param requiredFiles the new required files
*/
//设置请求的文件
protected void setRequiredFiles(final List<String> requiredFiles) {
this.requiredFiles = requiredFiles;
}
/**
* Adds the required filename to the list.
*
* @param fileName the required filename
*
* @return <tt>true</tt> if succesful, <tt>false</tt> otherwise
*/
//增减请求文件名
public boolean addRequiredFile(final String fileName) {
// if the list is empty
if (getRequiredFiles() == null) {
setRequiredFiles(new LinkedList<String>());
}
// then check whether filename already exists or not
boolean result = false;
for (int i = 0; i < getRequiredFiles().size(); i++) {
final String temp = getRequiredFiles().get(i);
if (temp.equals(fileName)) {
result = true;
break;
}
}
if (!result) {
getRequiredFiles().add(fileName);
}
return result;
}
/**
* Deletes the given filename from the list.
*
* @param filename the given filename to be deleted
*
* @return <tt>true</tt> if succesful, <tt>false</tt> otherwise
*/
//删除指定文件名
public boolean deleteRequiredFile(final String filename) {
boolean result = false;
if (getRequiredFiles() == null) {
return result;
}
for (int i = 0; i < getRequiredFiles().size(); i++) {
final String temp = getRequiredFiles().get(i);
if (temp.equals(filename)) {
getRequiredFiles().remove(i);
result = true;
break;
}
}
return result;
}
/**
* Checks whether this cloudlet requires any files or not.
*
* @return <tt>true</tt> if required, <tt>false</tt> otherwise
*/
//检查是否请求文件
public boolean requiresFiles() {
boolean result = false;
if (getRequiredFiles() != null && getRequiredFiles().size() > 0) {
result = true;
}
return result;
}
/**
* Gets the utilization model cpu.
*
* @return the utilization model cpu
*/
//获取CPU的utilization模型
public UtilizationModel getUtilizationModelCpu() {
return utilizationModelCpu;
}
/**
* Sets the utilization model cpu.
*
* @param utilizationModelCpu the new utilization model cpu
*/
//设置CPU的utilization模型
public void setUtilizationModelCpu(final UtilizationModel utilizationModelCpu) {
this.utilizationModelCpu = utilizationModelCpu;
}
/**
* Gets the utilization model ram.
*
* @return the utilization model ram
*/
//获取ram的utilization模型
public UtilizationModel getUtilizationModelRam() {
return utilizationModelRam;
}
/**
* Sets the utilization model ram.
*
* @param utilizationModelRam the new utilization model ram
*/
//设置ram的utilization模型
public void setUtilizationModelRam(final UtilizationModel utilizationModelRam) {
this.utilizationModelRam = utilizationModelRam;
}
/**
* Gets the utilization model bw.
*
* @return the utilization model bw
*/
//获取带宽的utilization模型
public UtilizationModel getUtilizationModelBw() {
return utilizationModelBw;
}
/**
* Sets the utilization model bw.
*
* @param utilizationModelBw the new utilization model bw
*/
//设置带宽的utilization模型
public void setUtilizationModelBw(final UtilizationModel utilizationModelBw) {
this.utilizationModelBw = utilizationModelBw;
}
/**
* Gets the total utilization of cpu.
*
* @param time the time
*
* @return the utilization of cpu
*/
//获取CPU的总的utilization
public double getUtilizationOfCpu(final double time) {
return getUtilizationModelCpu().getUtilization(time);
}
/**
* Gets the utilization of memory.
*
* @param time the time
*
* @return the utilization of memory
*/
//获取ram的总的utilization
public double getUtilizationOfRam(final double time) {
return getUtilizationModelRam().getUtilization(time);
}
/**
* Gets the utilization of bw.
*
* @param time the time
*
* @return the utilization of bw
*/
//获取BW的总的utilization
public double getUtilizationOfBw(final double time) {
return getUtilizationModelBw().getUtilization(time);
}
}
cloudsim源代码学习：cloudlet.java
最新推荐文章于 2021-07-25 17:20:33 发布
扫一扫
1321
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
