CloudletAbstract (CloudSim Plus API 2.2.0 API)

java.lang.Object
- org.cloudbus.cloudsim.cloudlets.CloudletAbstract

All Implemented Interfaces:

Comparable<Cloudlet>, Cloudlet, ChangeableId, CustomerEntity, Delayable, Identificable, UniquelyIdentificable

Direct Known Subclasses:

CloudletSimple
```
public abstract class CloudletAbstract
extends Object
implements Cloudlet
```
A base class for Cloudlet implementations.

Author:

Rodrigo N. Calheiros, Anton Beloglazov, Manoel Campos da Silva Filho

Nested Class Summary
- Nested classes/interfaces inherited from interface org.cloudbus.cloudsim.cloudlets.Cloudlet
  Cloudlet.Status

Field Summary
- Fields inherited from interface org.cloudbus.cloudsim.cloudlets.Cloudlet
  NO_HISTORY_IS_RECORDED_FOR_CLOUDLET, NOT_ASSIGNED, NULL

Constructor Summary

Constructors
Constructor and Description
`CloudletAbstract(int cloudletId, long length, long pesNumber)` Creates a Cloudlet with no priority and file size and output size equal to 1.
`CloudletAbstract(long length, int pesNumber)` Creates a Cloudlet with no priority or id.
`CloudletAbstract(long length, long pesNumber)` Creates a Cloudlet with no priority or id.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`Cloudlet`	`addOnFinishListener(EventListener<CloudletVmEventInfo> listener)` Adds a Listener object that will be notified when a cloudlet finishes its execution at a given `Vm`.
`Cloudlet`	`addOnUpdateProcessingListener(EventListener<CloudletVmEventInfo> listener)` Adds a Listener object that will be notified every time the processing of the Cloudlet is updated in its `Vm`.
`boolean`	`addRequiredFile(String fileName)` Adds a file to the list or required files.
`boolean`	`addRequiredFiles(List<String> fileNames)` Adds a list of files to the required files list.
`void`	`assignToDatacenter(Datacenter datacenter)` Sets the parameters of the Datacenter where the Cloudlet is going to be executed.
`boolean`	`deleteRequiredFile(String filename)` Deletes the given filename from the list.
`boolean`	`equals(Object o)`
`double`	`getAccumulatedBwCost()` The total bandwidth (bw) cost for transferring the cloudlet by the network, according to the `Cloudlet.getFileSize()`.
`double`	`getActualCpuTime()` Returns the total execution time of the Cloudlet in seconds.
`double`	`getActualCpuTime(Datacenter datacenter)` Gets the total execution time of this Cloudlet in a given Datacenter ID.
`double`	`getArrivalTime(Datacenter datacenter)` Gets the arrival time of this Cloudlet in the given Datacenter.
`DatacenterBroker`	`getBroker()` Gets the `DatacenterBroker` that represents the owner of this Cloudlet.
`double`	`getCostPerBw()` Gets the cost of each byte of bandwidth (bw) consumed.
`double`	`getCostPerSec()` Gets the cost/sec of running the Cloudlet in the latest Datacenter.
`double`	`getCostPerSec(Datacenter datacenter)` Gets the cost running this Cloudlet in a given Datacenter.
`double`	`getExecStartTime()` Gets the latest execution start time of this Cloudlet.
`long`	`getFileSize()` Gets the input file size of this Cloudlet before execution (in bytes).
`long`	`getFinishedLengthSoFar()` Gets the length of this Cloudlet that has been executed so far from the latest Datacenter (in MI).
`long`	`getFinishedLengthSoFar(Datacenter datacenter)` Gets the length of this Cloudlet that has been executed so far (in MI), according to the `Cloudlet.getLength()`.
`double`	`getFinishTime()` Gets the time when this Cloudlet has completed executing in the latest Datacenter.
`String`	`getHistory()` Gets the transaction history of this Cloudlet.
`int`	`getId()`
`Datacenter`	`getLastDatacenter()` Gets the latest `Datacenter` where the Cloudlet was processed.
`double`	`getLastDatacenterArrivalTime()` Gets the arrival time of this Cloudlet from the latest Datacenter where it has executed.
`protected int`	`getLastExecutedDatacenterIdx()`
`long`	`getLength()` Gets the execution length of this Cloudlet (in Million Instructions (MI)) that will be executed in each defined PE.
`int`	`getNetServiceLevel()` Gets the Type of Service (ToS) of IPv4 for sending Cloudlet over the network.
`long`	`getNumberOfPes()` Gets the number of Processing Elements (PEs) from the VM, that is required to execute this cloudlet.
`long`	`getOutputSize()` Gets the output file size of this Cloudlet after execution (in bytes).
`int`	`getPriority()` Gets the priority of this Cloudlet for scheduling inside a Vm.
`List<String>`	`getRequiredFiles()` Gets the list of required files to be used by the cloudlet (if any).
`Simulation`	`getSimulation()` Gets the CloudSim instance that represents the simulation the Entity is related to.
`Cloudlet.Status`	`getStatus()` Gets the execution status of this Cloudlet.
`double`	`getSubmissionDelay()` Gets the delay (in seconds) that a `DatacenterBroker` has to include when submitting the Cloudlet, in order that it will be assigned to a VM only after this delay has expired.
`double`	`getTotalCost()` Gets the total cost of executing this Cloudlet.
`long`	`getTotalLength()` Gets the total length (across all PEs) of this Cloudlet (in MI).
`String`	`getUid()` Gets the Unique Identifier (UID) for the VM, that is compounded by the id of a `DatacenterBroker` (representing the User) and the object id.
`UtilizationModel`	`getUtilizationModelBw()` Gets the utilization model that defines how the cloudlet will use the VM's bandwidth (bw).
`UtilizationModel`	`getUtilizationModelCpu()` Gets the utilization model that defines how the cloudlet will use the VM's CPU.
`UtilizationModel`	`getUtilizationModelRam()` Gets the utilization model that defines how the cloudlet will use the VM's RAM.
`double`	`getUtilizationOfBw()` Gets the utilization of Bandwidth at the current simulation time, that is defined in percentage or absolute values, depending of the `UtilizationModel.getUnit()` set for the `BW utilizaton model`.
`double`	`getUtilizationOfBw(double time)` Gets the utilization of Bandwidth at a given time, that is defined in percentage or absolute values, depending of the `UtilizationModel.getUnit()` defined for the `Cloudlet.getUtilizationModelBw()` ()}.
`double`	`getUtilizationOfCpu()` Gets the utilization of CPU at the current simulation time, that is defined in percentage or absolute values, depending of the `UtilizationModel.getUnit()` set for the `CPU utilizaton model`.
`double`	`getUtilizationOfCpu(double time)` Gets the utilization of CPU at a given time, that is defined in percentage or absolute values, depending of the `UtilizationModel.getUnit()` defined for the `Cloudlet.getUtilizationModelCpu()`.
`double`	`getUtilizationOfRam()` Gets the utilization of RAM at the current simulation time, that is defined in percentage or absolute values, depending of the `UtilizationModel.getUnit()` set for the `RAM utilizaton model`.
`double`	`getUtilizationOfRam(double time)` Gets the utilization of RAM at a given time, that is defined in percentage or absolute values, depending of the `UtilizationModel.getUnit()` defined for the `Cloudlet.getUtilizationModelRam()` ()}.
`Vm`	`getVm()` Gets the id of Vm that is planned to execute the cloudlet.
`double`	`getWaitingTime()` Gets the time the cloudlet had to wait before start executing on a resource.
`double`	`getWallClockTime(Datacenter datacenter)` Gets the time of this Cloudlet resides in a given Datacenter (from arrival time until departure time).
`double`	`getWallClockTimeInLastExecutedDatacenter()` Gets the time of this Cloudlet resides in the latest Datacenter (from arrival time until departure time).
`int`	`hashCode()`
`boolean`	`isAssignedToDatacenter()`
`boolean`	`isBindToVm()` Indicates if the Cloudlet is bounded to a specific Vm, meaning that the `DatacenterBroker` doesn't have to select a VM for it.
`boolean`	`isFinished()` Checks whether this Cloudlet has finished executing or not.
`boolean`	`isRecordTransactionHistory()` Indicates if Cloudlet transaction history is to be recorded or not.
`void`	`notifyOnUpdateProcessingListeners(double time)` Notifies all registered listeners about the update on Cloudlet processing.
`double`	`registerArrivalInDatacenter()` Register the arrival time of this Cloudlet into a Datacenter to the current simulation time and returns this time.
`boolean`	`removeOnFinishListener(EventListener<CloudletVmEventInfo> listener)` Removes a listener from the onCloudletFinishEventListener List
`boolean`	`removeOnUpdateProcessingListener(EventListener<CloudletVmEventInfo> listener)` Removes a listener from the onUpdateCloudletProcessingListener List.
`boolean`	`requiresFiles()` Checks whether this cloudlet requires any files or not.
`protected void`	`setAccumulatedBwCost(double accumulatedBwCost)` Sets the `accumulated bw cost`.
`Cloudlet`	`setBroker(DatacenterBroker broker)` Sets a `DatacenterBroker` that represents the owner of this Cloudlet.
`protected void`	`setCostPerBw(double costPerBw)` Sets `the cost of each byte of bandwidth (bw)` consumed.
`void`	`setExecStartTime(double clockTime)` Sets the `latest execution start time` of this Cloudlet.
`Cloudlet`	`setFileSize(long fileSize)` Sets the input file size of this Cloudlet before execution (in bytes).
`boolean`	`setFinishedLengthSoFar(long length)` Sets the length of this Cloudlet that has been executed so far (in MI), according to the `Cloudlet.getLength()`.
`protected void`	`setFinishTime(double finishTime)` Sets the `finish time` of this cloudlet in the latest Datacenter.
`void`	`setId(int id)`
`protected void`	`setLastExecutedDatacenterIdx(int lastExecutedDatacenterIdx)`
`Cloudlet`	`setLength(long length)` Sets the execution length of this Cloudlet (in Million Instructions (MI)) that will be executed in each defined PE.
`boolean`	`setNetServiceLevel(int netServiceLevel)` Sets the Type of Service (ToS) for sending this cloudlet over a network.
`Cloudlet`	`setNumberOfPes(long numberOfPes)` Sets the number of PEs required to run this Cloudlet.
`Cloudlet`	`setOutputSize(long outputSize)` Sets the output file size of this Cloudlet after execution (in bytes).
`void`	`setPriority(int priority)` Sets the `priority` of this Cloudlet for scheduling inside a Vm.
`void`	`setRecordTransactionHistory(boolean recordTransactionHistory)` Sets the Cloudlet transaction history writing.
`void`	`setRequiredFiles(List<String> requiredFiles)` Sets the list of `required files`.
`boolean`	`setStatus(Cloudlet.Status newStatus)` Sets the status of this Cloudlet.
`void`	`setSubmissionDelay(double submissionDelay)` Sets the delay (in seconds) that a `DatacenterBroker` has to include when submitting the Cloudlet, in order that it will be assigned to a VM only after this delay has expired.
`Cloudlet`	`setUtilizationModel(UtilizationModel utilizationModel)` Sets the same utilization model for defining the usage of Bandwidth, CPU and RAM.
`Cloudlet`	`setUtilizationModelBw(UtilizationModel utilizationModelBw)` Sets the `utilization model of bw`.
`Cloudlet`	`setUtilizationModelCpu(UtilizationModel utilizationModelCpu)` Sets the `utilization model of cpu`.
`Cloudlet`	`setUtilizationModelRam(UtilizationModel utilizationModelRam)` Sets the `utilization model of ram`.
`Cloudlet`	`setVm(Vm vm)` Sets the id of `Vm` that is planned to execute the cloudlet.
`boolean`	`setWallClockTime(double wallTime, double actualCpuTime)` Sets the wall clock time the cloudlet spent executing on the current Datacenter.
`protected void`	`write(String str)` Writes a particular history transaction of this Cloudlet into a log.
`protected void`	`write(String format, Object... args)` Writes a formatted particular history transaction of this Cloudlet into a log.

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.cloudbus.cloudsim.core.UniquelyIdentificable
getUid

Methods inherited from interface java.lang.Comparable
compareTo

- Constructor Detail
  - CloudletAbstract
```
public CloudletAbstract(int cloudletId,
                        long length,
                        long pesNumber)
```
    Creates a Cloudlet with no priority and file size and output size equal to 1.
    
    Parameters:
    
    cloudletId - id of the Cloudlet
    
    length - the length or size (in MI) of this cloudlet to be executed in a VM
    
    pesNumber - number of PEs that Cloudlet will require
  - CloudletAbstract
```
public CloudletAbstract(long length,
                        int pesNumber)
```
    Creates a Cloudlet with no priority or id. The id is defined when the Cloudlet is submitted to a DatacenterBroker. The file size and output size is defined as 1.
    
    Parameters:
    
    length - the length or size (in MI) of this cloudlet to be executed in a VM
    
    pesNumber - number of PEs that Cloudlet will require
  - CloudletAbstract
```
public CloudletAbstract(long length,
                        long pesNumber)
```
    Creates a Cloudlet with no priority or id. The id is defined when the Cloudlet is submitted to a DatacenterBroker. The file size and output size is defined as 1.
    
    Parameters:
    
    length - the length or size (in MI) of this cloudlet to be executed in a VM
    
    pesNumber - number of PEs that Cloudlet will require
- Method Detail
  - getLastExecutedDatacenterIdx
```
protected int getLastExecutedDatacenterIdx()
```
  - setLastExecutedDatacenterIdx
```
protected void setLastExecutedDatacenterIdx(int lastExecutedDatacenterIdx)
```
  - setUtilizationModel
```
public Cloudlet setUtilizationModel(UtilizationModel utilizationModel)
```
    Description copied from interface: Cloudlet
    
    Sets the same utilization model for defining the usage of Bandwidth, CPU and RAM. To set different utilization models for each one of these resources, use the respective setters.
    
    Specified by:
    
    setUtilizationModel in interface Cloudlet
    
    Parameters:
    
    utilizationModel - the new utilization model for BW, CPU and RAM
    
    Returns:
    
    See Also:
    
    Cloudlet.setUtilizationModelBw(UtilizationModel), Cloudlet.setUtilizationModelCpu(UtilizationModel), Cloudlet.setUtilizationModelRam(UtilizationModel)
  - addOnUpdateProcessingListener
```
public Cloudlet addOnUpdateProcessingListener(EventListener<CloudletVmEventInfo> listener)
```
    Description copied from interface: Cloudlet
    
    Adds a Listener object that will be notified every time the processing of the Cloudlet is updated in its Vm.
    
    Specified by:
    
    addOnUpdateProcessingListener in interface Cloudlet
    
    Parameters:
    
    listener - the listener to add
    
    See Also:
    
    Cloudlet.getFinishedLengthSoFar()
  - removeOnUpdateProcessingListener
```
public boolean removeOnUpdateProcessingListener(EventListener<CloudletVmEventInfo> listener)
```
    Description copied from interface: Cloudlet
    
    Removes a listener from the onUpdateCloudletProcessingListener List.
    
    Specified by:
    
    removeOnUpdateProcessingListener in interface Cloudlet
    
    Parameters:
    
    listener - the listener to remove
    
    Returns:
    
    true if the listener was found and removed, false otherwise
  - addOnFinishListener
```
public Cloudlet addOnFinishListener(EventListener<CloudletVmEventInfo> listener)
```
    Description copied from interface: Cloudlet
    
    Adds a Listener object that will be notified when a cloudlet finishes its execution at a given Vm.
    
    Specified by:
    
    addOnFinishListener in interface Cloudlet
    
    Parameters:
    
    listener - the listener to add
    
    Returns:
  - removeOnFinishListener
```
public boolean removeOnFinishListener(EventListener<CloudletVmEventInfo> listener)
```
    Description copied from interface: Cloudlet
    
    Removes a listener from the onCloudletFinishEventListener List
    
    Specified by:
    
    removeOnFinishListener in interface Cloudlet
    
    Parameters:
    
    listener - the listener to remove
    
    Returns:
    
    true if the listener was found and removed, false otherwise
    
    See Also:
    
    Cloudlet.addOnFinishListener(EventListener)
  - notifyOnUpdateProcessingListeners
```
public void notifyOnUpdateProcessingListeners(double time)
```
    Description copied from interface: Cloudlet
    
    Notifies all registered listeners about the update on Cloudlet processing.
    This method is used just internally and must not be called directly.
    
    Specified by:
    
    notifyOnUpdateProcessingListeners in interface Cloudlet
    
    Parameters:
    
    time - the time the event happened
  - setLength
```
public final Cloudlet setLength(long length)
```
    Description copied from interface: Cloudlet
    
    Sets the execution length of this Cloudlet (in Million Instructions (MI)) that will be executed in each defined PE.
    
    Specified by:
    
    setLength in interface Cloudlet
    
    Parameters:
    
    length - the length (in MI) of this Cloudlet to be executed in a Vm
    
    Returns:
    
    See Also:
    
    Cloudlet.getLength(), Cloudlet.getTotalLength()
  - setNetServiceLevel
```
public boolean setNetServiceLevel(int netServiceLevel)
```
    Description copied from interface: Cloudlet
    
    Sets the Type of Service (ToS) for sending this cloudlet over a network.
    
    Specified by:
    
    setNetServiceLevel in interface Cloudlet
    
    Parameters:
    
    netServiceLevel - the new type of service (ToS) of this cloudlet
    
    Returns:
    
    true if the netServiceLevel is valid, false otherwise.
  - getNetServiceLevel
```
public int getNetServiceLevel()
```
    Description copied from interface: Cloudlet
    
    Gets the Type of Service (ToS) of IPv4 for sending Cloudlet over the network. It is the ToS this cloudlet receives in the network (applicable to selected PacketScheduler class only).
    
    Specified by:
    
    getNetServiceLevel in interface Cloudlet
    
    Returns:
    
    the network service level
  - getWaitingTime
```
public double getWaitingTime()
```
    Description copied from interface: Cloudlet
    
    Gets the time the cloudlet had to wait before start executing on a resource.
    
    Specified by:
    
    getWaitingTime in interface Cloudlet
    
    Returns:
    
    the waiting time when the cloudlet waited to execute; or 0 if there wasn't any waiting time or the cloudlet hasn't started to execute.
  - getPriority
```
public int getPriority()
```
    Description copied from interface: Cloudlet
    
    Gets the priority of this Cloudlet for scheduling inside a Vm. Each CloudletScheduler implementation can define if it will use this attribute to impose execution priorities or not. How the priority is interpreted and what is the range of values it accepts depends on the CloudletScheduler that is being used by the Vm running the Cloudlet.
    
    Specified by:
    
    getPriority in interface Cloudlet
    
    Returns:
    
    priority of this cloudlet
  - setPriority
```
public void setPriority(int priority)
```
    Description copied from interface: Cloudlet
    
    Sets the priority of this Cloudlet for scheduling inside a Vm. Each CloudletScheduler implementation can define if it will use this attribute to impose execution priorities or not. How the priority is interpreted and what is the range of values it accepts depends on the CloudletScheduler that is being used by the Vm running the Cloudlet.
    
    Specified by:
    
    setPriority in interface Cloudlet
    
    Parameters:
    
    priority - priority of this Cloudlet
  - setNumberOfPes
```
public final Cloudlet setNumberOfPes(long numberOfPes)
```
    Description copied from interface: Cloudlet
    
    Sets the number of PEs required to run this Cloudlet.
    NOTE: The Cloudlet length is computed only for 1 PE for simplicity.
    For example, consider a Cloudlet that has a length of 500 MI and requires 2 PEs. This means each PE will execute 500 MI of this Cloudlet.
    
    Specified by:
    
    setNumberOfPes in interface Cloudlet
    
    Parameters:
    
    numberOfPes - number of PEs
    
    Returns:
  - getNumberOfPes
```
public long getNumberOfPes()
```
    Description copied from interface: Cloudlet
    
    Gets the number of Processing Elements (PEs) from the VM, that is required to execute this cloudlet.
    
    Specified by:
    
    getNumberOfPes in interface Cloudlet
    
    Returns:
    
    number of PEs
    
    See Also:
    
    Cloudlet.getTotalLength()
  - getHistory
```
public String getHistory()
```
    Description copied from interface: Cloudlet
    
    Gets the transaction history of this Cloudlet. The layout of this history is in a readable table column with time and description as headers.
    
    Specified by:
    
    getHistory in interface Cloudlet
    
    Returns:
    
    a String containing the history of this Cloudlet object.
  - getFinishedLengthSoFar
```
public long getFinishedLengthSoFar(Datacenter datacenter)
```
    Description copied from interface: Cloudlet
    
    Gets the length of this Cloudlet that has been executed so far (in MI), according to the Cloudlet.getLength(). This method is useful when trying to move this Cloudlet into different Datacenters or to cancel it.
    
    Specified by:
    
    getFinishedLengthSoFar in interface Cloudlet
    
    Parameters:
    
    datacenter - the Datacenter entity
    
    Returns:
    
    the length of a partially executed Cloudlet; the full Cloudlet length if it is completed; or 0 if the Cloudlet has never been executed in the given Datacenter
  - getFinishedLengthSoFar
```
public long getFinishedLengthSoFar()
```
    Description copied from interface: Cloudlet
    
    Gets the length of this Cloudlet that has been executed so far from the latest Datacenter (in MI). This method is useful when trying to move this Cloudlet into different Datacenter or to cancel it.
    
    Specified by:
    
    getFinishedLengthSoFar in interface Cloudlet
    
    Returns:
    
    the length of a partially executed Cloudlet, or the full Cloudlet length if it is completed
  - isFinished
```
public boolean isFinished()
```
    Description copied from interface: Cloudlet
    
    Checks whether this Cloudlet has finished executing or not.
    
    Specified by:
    
    isFinished in interface Cloudlet
    
    Returns:
    
    true if this Cloudlet has finished execution, false otherwise
  - setFinishedLengthSoFar
```
public boolean setFinishedLengthSoFar(long length)
```
    Description copied from interface: Cloudlet
    
    Sets the length of this Cloudlet that has been executed so far (in MI), according to the Cloudlet.getLength().
    
    Specified by:
    
    setFinishedLengthSoFar in interface Cloudlet
    
    Parameters:
    
    length - executed length of this Cloudlet (in MI)
    
    Returns:
    
    true if the length is valid and the cloudlet already has assigned to a Datacenter, false otherwise
    
    See Also:
    
    CloudletExecution
  - setBroker
```
public final Cloudlet setBroker(DatacenterBroker broker)
```
    Description copied from interface: Cloudlet
    
    Sets a DatacenterBroker that represents the owner of this Cloudlet.
    
    Specified by:
    
    setBroker in interface Cloudlet
    
    Specified by:
    
    setBroker in interface CustomerEntity
    
    Parameters:
    
    broker - the DatacenterBroker to set
    
    Returns:
  - getBroker
```
public DatacenterBroker getBroker()
```
    Description copied from interface: Cloudlet
    
    Gets the DatacenterBroker that represents the owner of this Cloudlet.
    
    Specified by:
    
    getBroker in interface Cloudlet
    
    Specified by:
    
    getBroker in interface CustomerEntity
    
    Returns:
    
    the broker or DatacenterBroker.NULL if a broker has not been set yet
  - getLastDatacenter
```
public Datacenter getLastDatacenter()
```
    Description copied from interface: Cloudlet
    
    Gets the latest Datacenter where the Cloudlet was processed.
    
    Specified by:
    
    getLastDatacenter in interface Cloudlet
    
    Returns:
    
    the Datacenter or Datacenter.NULL if the Cloudlet has not being processed yet.
  - getFileSize
```
public long getFileSize()
```
    Description copied from interface: Cloudlet
    
    Gets the input file size of this Cloudlet before execution (in bytes). This size has to be considered the program + input data sizes.
    
    Specified by:
    
    getFileSize in interface Cloudlet
    
    Returns:
    
    the input file size of this Cloudlet (in bytes)
  - getOutputSize
```
public long getOutputSize()
```
    Description copied from interface: Cloudlet
    
    Gets the output file size of this Cloudlet after execution (in bytes). It is the data produced as result of cloudlet execution that needs to be transferred thought the network to simulate sending response data to the user.
    
    Specified by:
    
    getOutputSize in interface Cloudlet
    
    Returns:
    
    the Cloudlet output file size (in bytes)
  - getExecStartTime
```
public double getExecStartTime()
```
    Description copied from interface: Cloudlet
    
    Gets the latest execution start time of this Cloudlet. With new functionalities, such as CANCEL, PAUSED and RESUMED, this attribute only stores the latest execution time. Previous execution time are ignored. This time represents the simulation second when the cloudlet started.
    
    Specified by:
    
    getExecStartTime in interface Cloudlet
    
    Returns:
    
    the latest execution start time
  - setExecStartTime
```
public void setExecStartTime(double clockTime)
```
    Description copied from interface: Cloudlet
    
    Sets the latest execution start time of this Cloudlet.
    NOTE: 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.
    
    Specified by:
    
    setExecStartTime in interface Cloudlet
    
    Parameters:
    
    clockTime - the latest execution start time
  - setWallClockTime
```
public boolean setWallClockTime(double wallTime,
                                double actualCpuTime)
```
    Description copied from interface: Cloudlet
    
    Sets the wall clock time the cloudlet spent executing on the current Datacenter. The wall clock time is the total time the Cloudlet resides in a Datacenter (from arrival time until departure time, that may include waiting time). This value is set by the Datacenter before departure or sending back to the original Cloudlet's owner.
    
    Specified by:
    
    setWallClockTime in interface Cloudlet
    
    Parameters:
    
    wallTime - the time of this Cloudlet resides in a Datacenter (from arrival time until departure time).
    
    actualCpuTime - the total execution time of this Cloudlet in a Datacenter.
    
    Returns:
    
    true if the submission time is valid and the cloudlet has already being assigned to a Datacenter for execution
  - setStatus
```
public boolean setStatus(Cloudlet.Status newStatus)
```
    Description copied from interface: Cloudlet
    
    Sets the status of this Cloudlet.
    WARNING: This method is just used internally by classes such as CloudletScheduler to update Cloudlet status. Calling it directly might not get the expected result. You have to use the CloudletScheduler that controls the execution of the Cloudlet to change the Cloudlets status. The method is public due to a design issue.
    
    Specified by:
    
    setStatus in interface Cloudlet
    
    Parameters:
    
    newStatus - the status of this Cloudlet
    
    Returns:
    
    true if the cloudlet status was changed, i.e, if the newStatus is different from the current status; false otherwise
  - getLength
```
public long getLength()
```
    Description copied from interface: Cloudlet
    
    Gets the execution length of this Cloudlet (in Million Instructions (MI)) that will be executed in each defined PE.
    According to this length and the power of the VM processor (in Million Instruction Per Second - MIPS) where the cloudlet will be run, the cloudlet will take a given time to finish processing. For instance, for a cloudlet of 10000 MI running on a processor of 2000 MIPS, the cloudlet will spend 5 seconds using the processor in order to be completed (that may be uninterrupted or not, depending on the scheduling policy).
    
    Specified by:
    
    getLength in interface Cloudlet
    
    Returns:
    
    the length of this Cloudlet
    
    See Also:
    
    Cloudlet.getTotalLength(), Cloudlet.getNumberOfPes()
  - getTotalLength
```
public long getTotalLength()
```
    Description copied from interface: Cloudlet
    
    Gets the total length (across all PEs) of this Cloudlet (in MI). It considers the Cloudlet.getLength() of the cloudlet will be executed in each Pe defined by Cloudlet.getNumberOfPes().
    For example, setting the cloudletLenght as 10000 MI and Cloudlet.getNumberOfPes() to 4, each Pe will execute 10000 MI. Thus, the entire Cloudlet has a total length of 40000 MI.
    
    Specified by:
    
    getTotalLength in interface Cloudlet
    
    Returns:
    
    the total length of this Cloudlet (in MI)
    
    See Also:
    
    Cloudlet.getNumberOfPes(), Cloudlet.getLength()
  - getCostPerSec
```
public double getCostPerSec()
```
    Description copied from interface: Cloudlet
    
    Gets the cost/sec of running the Cloudlet in the latest Datacenter.
    
    Specified by:
    
    getCostPerSec in interface Cloudlet
    
    Returns:
    
    the cost associated with running this Cloudlet or 0.0 if was not assigned to any Datacenter yet
  - getCostPerSec
```
public double getCostPerSec(Datacenter datacenter)
```
    Description copied from interface: Cloudlet
    
    Gets the cost running this Cloudlet in a given Datacenter.
    
    Specified by:
    
    getCostPerSec in interface Cloudlet
    
    Parameters:
    
    datacenter - the Datacenter entity
    
    Returns:
    
    the cost associated with running this Cloudlet in the given Datacenter or 0 if the Cloudlet was not executed there not found
  - getWallClockTimeInLastExecutedDatacenter
```
public double getWallClockTimeInLastExecutedDatacenter()
```
    Description copied from interface: Cloudlet
    
    Gets the time of this Cloudlet resides in the latest Datacenter (from arrival time until departure time).
    
    Specified by:
    
    getWallClockTimeInLastExecutedDatacenter in interface Cloudlet
    
    Returns:
    
    the time of this Cloudlet resides in the latest Datacenter
  - getActualCpuTime
```
public double getActualCpuTime(Datacenter datacenter)
```
    Description copied from interface: Cloudlet
    
    Gets the total execution time of this Cloudlet in a given Datacenter ID.
    
    Specified by:
    
    getActualCpuTime in interface Cloudlet
    
    Parameters:
    
    datacenter - the Datacenter entity
    
    Returns:
    
    the total execution time of this Cloudlet in the given Datacenter or 0 if the Cloudlet was not executed there
  - getActualCpuTime
```
public double getActualCpuTime()
```
    Description copied from interface: Cloudlet
    
    Returns the total execution time of the Cloudlet in seconds.
    
    Specified by:
    
    getActualCpuTime in interface Cloudlet
    
    Returns:
    
    time in which the Cloudlet was running or Cloudlet.NOT_ASSIGNED if it hasn't finished yet
  - getArrivalTime
```
public double getArrivalTime(Datacenter datacenter)
```
    Description copied from interface: Cloudlet
    
    Gets the arrival time of this Cloudlet in the given Datacenter.
    
    Specified by:
    
    getArrivalTime in interface Cloudlet
    
    Parameters:
    
    datacenter - the Datacenter entity
    
    Returns:
    
    the arrival time or Cloudlet.NOT_ASSIGNED if the cloudlet has never been assigned to a Datacenter
  - getWallClockTime
```
public double getWallClockTime(Datacenter datacenter)
```
    Description copied from interface: Cloudlet
    
    Gets the time of this Cloudlet resides in a given Datacenter (from arrival time until departure time).
    
    Specified by:
    
    getWallClockTime in interface Cloudlet
    
    Parameters:
    
    datacenter - a Datacenter entity
    
    Returns:
    
    the time of this Cloudlet resides in the Datacenter or 0 if the Cloudlet has never been executed there
  - getFinishTime
```
public double getFinishTime()
```
    Description copied from interface: Cloudlet
    
    Gets the time when this Cloudlet has completed executing in the latest Datacenter. This time represents the simulation second when the cloudlet finished.
    
    Specified by:
    
    getFinishTime in interface Cloudlet
    
    Returns:
    
    the finish or completion time of this Cloudlet; or Cloudlet.NOT_ASSIGNED if not finished yet.
  - setFinishTime
```
protected final void setFinishTime(double finishTime)
```
    Sets the finish time of this cloudlet in the latest Datacenter.
    
    Parameters:
    
    finishTime - the finish time
  - write
```
protected void write(String str)
```
    Writes a particular history transaction of this Cloudlet into a log.
    
    Parameters:
    
    str - a history transaction of this Cloudlet
    
    Precondition:
    
    str != null
    
    Postcondition:
    
    $none
  - write
```
protected void write(String format,
                     Object... args)
```
    Writes a formatted particular history transaction of this Cloudlet into a log.
    
    Parameters:
    
    format - the format of the Cloudlet's history transaction, according to the format parameter of String.format(String, Object...)
    
    args - The list of values to be shown in the history, that are referenced by the format.
    
    See Also:
    
    write(String)
    
    Precondition:
    
    format != null
    
    Postcondition:
    
    $none
  - getStatus
```
public Cloudlet.Status getStatus()
```
    Description copied from interface: Cloudlet
    
    Gets the execution status of this Cloudlet.
    
    Specified by:
    
    getStatus in interface Cloudlet
    
    Returns:
    
    the Cloudlet status
  - getId
```
public int getId()
```
    Specified by:
    
    getId in interface Identificable
  - setId
```
public void setId(int id)
```
    Specified by:
    
    setId in interface ChangeableId
  - getVm
```
public Vm getVm()
```
    Description copied from interface: Cloudlet
    
    Gets the id of Vm that is planned to execute the cloudlet.
    
    Specified by:
    
    getVm in interface Cloudlet
    
    Returns:
    
    the VM, or Cloudlet.NOT_ASSIGNED if the Cloudlet was not assigned to a VM yet
  - setVm
```
public final Cloudlet setVm(Vm vm)
```
    Description copied from interface: Cloudlet
    
    Sets the id of Vm that is planned to execute the cloudlet.
    
    Specified by:
    
    setVm in interface Cloudlet
    
    Parameters:
    
    vm - the id of vm to run the cloudlet
  - getTotalCost
```
public double getTotalCost()
```
    Description copied from interface: Cloudlet
    
    Gets the total cost of executing this Cloudlet. Total Cost = input data transfer + processing cost + output transfer cost .
    
    Specified by:
    
    getTotalCost in interface Cloudlet
    
    Returns:
    
    the total cost of executing the Cloudlet
  - getRequiredFiles
```
public List<String> getRequiredFiles()
```
    Description copied from interface: Cloudlet
    
    Gets the list of required files to be used by the cloudlet (if any). The time to transfer these files by the network is considered when placing the cloudlet inside a given VM
    
    Specified by:
    
    getRequiredFiles in interface Cloudlet
    
    Returns:
    
    the required files
  - setRequiredFiles
```
public final void setRequiredFiles(List<String> requiredFiles)
```
    Sets the list of required files.
    
    Parameters:
    
    requiredFiles - the new list of required files
  - addRequiredFile
```
public boolean addRequiredFile(String fileName)
```
    Description copied from interface: Cloudlet
    
    Adds a file to the list or required files.
    
    Specified by:
    
    addRequiredFile in interface Cloudlet
    
    Parameters:
    
    fileName - the name of the required file
    
    Returns:
    
    true if the file was added (it didn't exist in the list of required files), false otherwise (it did already exist)
  - addRequiredFiles
```
public boolean addRequiredFiles(List<String> fileNames)
```
    Description copied from interface: Cloudlet
    
    Adds a list of files to the required files list. Just the files that don't exist yet in the current required list will be added.
    
    Specified by:
    
    addRequiredFiles in interface Cloudlet
    
    Parameters:
    
    fileNames - the list of files to be added
    
    Returns:
    
    true if at leat one file was added, false if no file was added (in the case that all given files already exist in the current required list)
  - deleteRequiredFile
```
public boolean deleteRequiredFile(String filename)
```
    Description copied from interface: Cloudlet
    
    Deletes the given filename from the list.
    
    Specified by:
    
    deleteRequiredFile in interface Cloudlet
    
    Parameters:
    
    filename - the given filename to be deleted
    
    Returns:
    
    true if the file was found and removed, false if not found
  - requiresFiles
```
public boolean requiresFiles()
```
    Description copied from interface: Cloudlet
    
    Checks whether this cloudlet requires any files or not.
    
    Specified by:
    
    requiresFiles in interface Cloudlet
    
    Returns:
    
    true if required, false otherwise
  - getUtilizationModelCpu
```
public UtilizationModel getUtilizationModelCpu()
```
    Description copied from interface: Cloudlet
    
    Gets the utilization model that defines how the cloudlet will use the VM's CPU.
    
    Specified by:
    
    getUtilizationModelCpu in interface Cloudlet
    
    Returns:
    
    the utilization model of cpu
  - setUtilizationModelCpu
```
public final Cloudlet setUtilizationModelCpu(UtilizationModel utilizationModelCpu)
```
    Description copied from interface: Cloudlet
    
    Sets the utilization model of cpu.
    
    Specified by:
    
    setUtilizationModelCpu in interface Cloudlet
    
    Parameters:
    
    utilizationModelCpu - the new utilization model of cpu
  - getUtilizationModelRam
```
public UtilizationModel getUtilizationModelRam()
```
    Description copied from interface: Cloudlet
    
    Gets the utilization model that defines how the cloudlet will use the VM's RAM.
    
    Specified by:
    
    getUtilizationModelRam in interface Cloudlet
    
    Returns:
    
    the utilization model of ram
  - setUtilizationModelRam
```
public final Cloudlet setUtilizationModelRam(UtilizationModel utilizationModelRam)
```
    Description copied from interface: Cloudlet
    
    Sets the utilization model of ram.
    
    Specified by:
    
    setUtilizationModelRam in interface Cloudlet
    
    Parameters:
    
    utilizationModelRam - the new utilization model of ram
  - getUtilizationModelBw
```
public UtilizationModel getUtilizationModelBw()
```
    Description copied from interface: Cloudlet
    
    Gets the utilization model that defines how the cloudlet will use the VM's bandwidth (bw).
    
    Specified by:
    
    getUtilizationModelBw in interface Cloudlet
    
    Returns:
    
    the utilization model of bw
  - setUtilizationModelBw
```
public final Cloudlet setUtilizationModelBw(UtilizationModel utilizationModelBw)
```
    Description copied from interface: Cloudlet
    
    Sets the utilization model of bw.
    
    Specified by:
    
    setUtilizationModelBw in interface Cloudlet
    
    Parameters:
    
    utilizationModelBw - the new utilization model of bw
  - getUtilizationOfCpu
```
public double getUtilizationOfCpu()
```
    Description copied from interface: Cloudlet
    
    Gets the utilization of CPU at the current simulation time, that is defined in percentage or absolute values, depending of the UtilizationModel.getUnit() set for the CPU utilizaton model.
    
    Specified by:
    
    getUtilizationOfCpu in interface Cloudlet
    
    Returns:
    
    the utilization value
    
    See Also:
    
    Cloudlet.getUtilizationModelCpu()
  - getUtilizationOfCpu
```
public double getUtilizationOfCpu(double time)
```
    Description copied from interface: Cloudlet
    
    Gets the utilization of CPU at a given time, that is defined in percentage or absolute values, depending of the UtilizationModel.getUnit() defined for the Cloudlet.getUtilizationModelCpu().
    
    Specified by:
    
    getUtilizationOfCpu in interface Cloudlet
    
    Parameters:
    
    time - the time to get the utilization
    
    Returns:
    
    the utilization value
    
    See Also:
    
    Cloudlet.getUtilizationModelCpu()
  - getUtilizationOfBw
```
public double getUtilizationOfBw()
```
    Description copied from interface: Cloudlet
    
    Gets the utilization of Bandwidth at the current simulation time, that is defined in percentage or absolute values, depending of the UtilizationModel.getUnit() set for the BW utilizaton model.
    
    Specified by:
    
    getUtilizationOfBw in interface Cloudlet
    
    Returns:
    
    the utilization value
    
    See Also:
    
    Cloudlet.getUtilizationModelCpu()
  - getUtilizationOfBw
```
public double getUtilizationOfBw(double time)
```
    Description copied from interface: Cloudlet
    
    Gets the utilization of Bandwidth at a given time, that is defined in percentage or absolute values, depending of the UtilizationModel.getUnit() defined for the Cloudlet.getUtilizationModelBw() ()}.
    
    Specified by:
    
    getUtilizationOfBw in interface Cloudlet
    
    Parameters:
    
    time - the time to get the utilization
    
    Returns:
    
    the utilization value
    
    See Also:
    
    ()
  - getUtilizationOfRam
```
public double getUtilizationOfRam()
```
    Description copied from interface: Cloudlet
    
    Gets the utilization of RAM at the current simulation time, that is defined in percentage or absolute values, depending of the UtilizationModel.getUnit() set for the RAM utilizaton model.
    
    Specified by:
    
    getUtilizationOfRam in interface Cloudlet
    
    Returns:
    
    the utilization value
    
    See Also:
    
    Cloudlet.getUtilizationModelRam()
  - getUtilizationOfRam
```
public double getUtilizationOfRam(double time)
```
    Description copied from interface: Cloudlet
    
    Gets the utilization of RAM at a given time, that is defined in percentage or absolute values, depending of the UtilizationModel.getUnit() defined for the Cloudlet.getUtilizationModelRam() ()}.
    
    Specified by:
    
    getUtilizationOfRam in interface Cloudlet
    
    Parameters:
    
    time - the time to get the utilization
    
    Returns:
    
    the utilization value
    
    See Also:
    
    ()
  - getCostPerBw
```
public double getCostPerBw()
```
    Description copied from interface: Cloudlet
    
    Gets the cost of each byte of bandwidth (bw) consumed.
    
    Specified by:
    
    getCostPerBw in interface Cloudlet
    
    Returns:
    
    the cost per bw
  - setCostPerBw
```
protected final void setCostPerBw(double costPerBw)
```
    Sets the cost of each byte of bandwidth (bw) consumed.
    
    Parameters:
    
    costPerBw - the new cost per bw to set
  - getAccumulatedBwCost
```
public double getAccumulatedBwCost()
```
    Description copied from interface: Cloudlet
    
    The total bandwidth (bw) cost for transferring the cloudlet by the network, according to the Cloudlet.getFileSize().
    
    Specified by:
    
    getAccumulatedBwCost in interface Cloudlet
    
    Returns:
    
    the accumulated bw cost
  - setAccumulatedBwCost
```
protected final void setAccumulatedBwCost(double accumulatedBwCost)
```
    Sets the accumulated bw cost.
    
    Parameters:
    
    accumulatedBwCost - the accumulated bw cost to set
  - getSubmissionDelay
```
public double getSubmissionDelay()
```
    Description copied from interface: Delayable
    
    Gets the delay (in seconds) that a DatacenterBroker has to include when submitting the Cloudlet, in order that it will be assigned to a VM only after this delay has expired.
    
    Specified by:
    
    getSubmissionDelay in interface Delayable
    
    Returns:
    
    the submission delay
  - setSubmissionDelay
```
public final void setSubmissionDelay(double submissionDelay)
```
    Description copied from interface: Delayable
    
    Sets the delay (in seconds) that a DatacenterBroker has to include when submitting the Cloudlet, in order that it will be assigned to a VM only after this delay has expired. The delay should be greater or equal to zero.
    
    Specified by:
    
    setSubmissionDelay in interface Delayable
    
    Parameters:
    
    submissionDelay - the amount of seconds from the current simulation time that the cloudlet will wait to be submitted to be created and assigned to a VM
  - isBindToVm
```
public boolean isBindToVm()
```
    Description copied from interface: Cloudlet
    
    Indicates if the Cloudlet is bounded to a specific Vm, meaning that the DatacenterBroker doesn't have to select a VM for it. In this case, the Cloudlet was already bounded to a specific VM and must run on it.
    
    Specified by:
    
    isBindToVm in interface Cloudlet
    
    Returns:
    
    true if the Cloudlet is bounded to a specific VM, false otherwise
  - setFileSize
```
public final Cloudlet setFileSize(long fileSize)
```
    Description copied from interface: Cloudlet
    
    Sets the input file size of this Cloudlet before execution (in bytes). This size has to be considered the program + input data sizes.
    
    Specified by:
    
    setFileSize in interface Cloudlet
    
    Parameters:
    
    fileSize - the size to set (in bytes)
    
    Returns:
  - setOutputSize
```
public final Cloudlet setOutputSize(long outputSize)
```
    Description copied from interface: Cloudlet
    
    Sets the output file size of this Cloudlet after execution (in bytes). It is the data produced as result of cloudlet execution that needs to be transferred thought the network to simulate sending response data to the user.
    
    Specified by:
    
    setOutputSize in interface Cloudlet
    
    Parameters:
    
    outputSize - the output size to set (in bytes)
    
    Returns:
  - isRecordTransactionHistory
```
public boolean isRecordTransactionHistory()
```
    Indicates if Cloudlet transaction history is to be recorded or not.
    
    Returns:
    
    See Also:
    
    getHistory()
  - setRecordTransactionHistory
```
public void setRecordTransactionHistory(boolean recordTransactionHistory)
```
    Sets the Cloudlet transaction history writing.
    
    Parameters:
    
    recordTransactionHistory - true enables transaction history writing, false disables.
  - assignToDatacenter
```
public void assignToDatacenter(Datacenter datacenter)
```
    Description copied from interface: Cloudlet
    
    Sets the parameters of the Datacenter where the Cloudlet is going to be executed. From the second time this method is called, every call makes the cloudlet to be migrated to the indicated Datacenter.
    NOTE: This method should be called only by a Datacenter entity.
    
    Specified by:
    
    assignToDatacenter in interface Cloudlet
    
    Parameters:
    
    datacenter - the Datacenter where the cloudlet will be executed
  - registerArrivalInDatacenter
```
public double registerArrivalInDatacenter()
```
    Description copied from interface: Cloudlet
    
    Register the arrival time of this Cloudlet into a Datacenter to the current simulation time and returns this time.
    
    Specified by:
    
    registerArrivalInDatacenter in interface Cloudlet
    
    Returns:
    
    the arrived time set or Cloudlet.NOT_ASSIGNED if the cloudlet is not assigned to a Datacenter
  - isAssignedToDatacenter
```
public boolean isAssignedToDatacenter()
```
    Specified by:
    
    isAssignedToDatacenter in interface Cloudlet
    
    Returns:
    
    true if the cloudlet has even been assigned to a Datacenter in order to run, false otherwise.
  - getLastDatacenterArrivalTime
```
public double getLastDatacenterArrivalTime()
```
    Description copied from interface: Cloudlet
    
    Gets the arrival time of this Cloudlet from the latest Datacenter where it has executed.
    
    Specified by:
    
    getLastDatacenterArrivalTime in interface Cloudlet
    
    Returns:
    
    the arrival time or Cloudlet.NOT_ASSIGNED if the cloudlet has never been assigned to a Datacenter
  - getUid
```
public String getUid()
```
    Description copied from interface: UniquelyIdentificable
    
    Gets the Unique Identifier (UID) for the VM, that is compounded by the id of a DatacenterBroker (representing the User) and the object id.
    
    Specified by:
    
    getUid in interface UniquelyIdentificable
    
    Returns:
  - getSimulation
```
public Simulation getSimulation()
```
    Description copied from interface: Cloudlet
    
    Gets the CloudSim instance that represents the simulation the Entity is related to.
    
    Specified by:
    
    getSimulation in interface Cloudlet
    
    Returns:
  - equals
```
public boolean equals(Object o)
```
    Overrides:
    
    equals in class Object
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class Object

Class CloudletAbstract

Nested Class Summary

Nested classes/interfaces inherited from interface org.cloudbus.cloudsim.cloudlets.Cloudlet

Field Summary

Fields inherited from interface org.cloudbus.cloudsim.cloudlets.Cloudlet

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface org.cloudbus.cloudsim.core.UniquelyIdentificable

Methods inherited from interface java.lang.Comparable

Constructor Detail

CloudletAbstract

CloudletAbstract

CloudletAbstract

Method Detail

getLastExecutedDatacenterIdx

setLastExecutedDatacenterIdx

setUtilizationModel

addOnUpdateProcessingListener

removeOnUpdateProcessingListener

addOnFinishListener

removeOnFinishListener

notifyOnUpdateProcessingListeners

setLength

setNetServiceLevel

getNetServiceLevel

getWaitingTime

getPriority

setPriority

setNumberOfPes

getNumberOfPes

getHistory

getFinishedLengthSoFar

getFinishedLengthSoFar

isFinished

setFinishedLengthSoFar

setBroker

getBroker

getLastDatacenter

getFileSize

getOutputSize

getExecStartTime

setExecStartTime

setWallClockTime

setStatus

getLength

getTotalLength

getCostPerSec

getCostPerSec

getWallClockTimeInLastExecutedDatacenter

getActualCpuTime

getActualCpuTime

getArrivalTime

getWallClockTime

getFinishTime

setFinishTime

write

write

getStatus

getId

setId

getVm

setVm

getTotalCost

getRequiredFiles

setRequiredFiles

addRequiredFile

addRequiredFiles

deleteRequiredFile

requiresFiles

getUtilizationModelCpu

setUtilizationModelCpu

getUtilizationModelRam

setUtilizationModelRam

getUtilizationModelBw

setUtilizationModelBw

getUtilizationOfCpu

getUtilizationOfCpu

getUtilizationOfBw

getUtilizationOfBw