org.cloudbus.cloudsim.cloudlets.network

Class NetworkCloudlet

java.lang.Object

org.cloudbus.cloudsim.cloudlets.CloudletAbstract

org.cloudbus.cloudsim.cloudlets.CloudletSimple

org.cloudbus.cloudsim.cloudlets.network.NetworkCloudlet

All Implemented Interfaces:

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

public class NetworkCloudlet
extends CloudletSimple

NetworkCloudlet class extends Cloudlet to support simulation of complex applications. Each NetworkCloudlet represents a task of the application. Each task consists of several tasks.

Please refer to following publication for more details:

• Saurabh Kumar Garg and Rajkumar Buyya, NetworkCloudSim: Modelling Parallel Applications in Cloud Simulations, Proceedings of the 4th IEEE/ACM International Conference on Utility and Cloud Computing (UCC 2011, IEEE CS Press, USA), Melbourne, Australia, December 5-7, 2011.

Since:

CloudSim Toolkit 1.0

Author:

Saurabh Kumar Garg

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
NetworkCloudlet(int id, long cloudletLength, int pesNumber) Creates a NetworkCloudlet with no priority and file size and output size equal to 1.

Method Summary

Modifier and Type	Method and Description
NetworkCloudlet	addTask(CloudletTask task) Adds a task to the task list and links the task to the NetworkCloudlet.
CloudletTask	getCurrentTask() Gets the current task.
long	getLength() Gets the execution length of this Cloudlet (in Million Instructions (MI)) that will be executed in each defined PE.
long	getMemory() Gets the Cloudlet's RAM memory.
protected CloudletTask	getNextTaskIfCurrentIfFinished() Gets the next task in the list if the current task is finished.
double	getNumberOfTasks()
List<CloudletTask>	getTasks()
boolean	isFinished() Checks whether this Cloudlet has finished executing or not.
boolean	isTasksStarted() Checks if the some Cloudlet Task has started yet.
protected long	numberOfExecutionTasks()
boolean	setFinishedLengthSoFar(long length) Sets the length of this Cloudlet that has been executed so far (in MI), according to the Cloudlet.getLength().
NetworkCloudlet	setMemory(long memory) Sets the Cloudlet's RAM memory.
boolean	startNextTaskIfCurrentIsFinished(double nextTaskStartTime) Change the current task to the next one in order to start executing it, if the current task is finished.

Methods inherited from class org.cloudbus.cloudsim.cloudlets.CloudletSimple

compareTo, toString

Methods inherited from class org.cloudbus.cloudsim.cloudlets.CloudletAbstract

addOnFinishListener, addOnUpdateProcessingListener, addRequiredFile, addRequiredFiles, assignToDatacenter, deleteRequiredFile, equals, getAccumulatedBwCost, getActualCpuTime, getActualCpuTime, getArrivalTime, getBroker, getCostPerBw, getCostPerSec, getCostPerSec, getExecStartTime, getFileSize, getFinishedLengthSoFar, getFinishedLengthSoFar, getFinishTime, getHistory, getId, getLastDatacenter, getLastDatacenterArrivalTime, getLastExecutedDatacenterIdx, getNetServiceLevel, getNumberOfPes, getOutputSize, getPriority, getRequiredFiles, getSimulation, getStatus, getSubmissionDelay, getTotalCost, getTotalLength, getUid, getUtilizationModelBw, getUtilizationModelCpu, getUtilizationModelRam, getUtilizationOfBw, getUtilizationOfBw, getUtilizationOfCpu, getUtilizationOfCpu, getUtilizationOfRam, getUtilizationOfRam, getVm, getWaitingTime, getWallClockTime, getWallClockTimeInLastExecutedDatacenter, hashCode, isAssignedToDatacenter, isBindToVm, isRecordTransactionHistory, notifyOnUpdateProcessingListeners, registerArrivalInDatacenter, removeOnFinishListener, removeOnUpdateProcessingListener, requiresFiles, setAccumulatedBwCost, setBroker, setCostPerBw, setExecStartTime, setFileSize, setFinishTime, setId, setLastExecutedDatacenterIdx, setLength, setNetServiceLevel, setNumberOfPes, setOutputSize, setPriority, setRecordTransactionHistory, setRequiredFiles, setStatus, setSubmissionDelay, setUtilizationModel, setUtilizationModelBw, setUtilizationModelCpu, setUtilizationModelRam, setVm, setWallClockTime, write, write

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

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

getUid

Constructor Detail

NetworkCloudlet

public NetworkCloudlet(int id,
                       long cloudletLength,
                       int pesNumber)

Creates a NetworkCloudlet with no priority and file size and output size equal to 1.

Parameters:

id - the unique ID of this cloudlet

cloudletLength - the length or size (in MI) of this cloudlet to be executed in a VM

pesNumber - the pes number

Precondition:

id >= 0, cloudletLength >= 0.0

Postcondition:

$none

Method Detail

getNumberOfTasks

public double getNumberOfTasks()

getTasks

public List<CloudletTask> getTasks()

Returns:

a read-only list of cloudlet's tasks.

getMemory

public long getMemory()

Gets the Cloudlet's RAM memory.

setMemory

public NetworkCloudlet setMemory(long memory)

Sets the Cloudlet's RAM memory.

Parameters:

memory - amount of RAM to set

isTasksStarted

public boolean isTasksStarted()

Checks if the some Cloudlet Task has started yet.

Returns:

true if some task has started, false otherwise

startNextTaskIfCurrentIsFinished

public boolean startNextTaskIfCurrentIsFinished(double nextTaskStartTime)

Change the current task to the next one in order to start executing it, if the current task is finished.

Parameters:

nextTaskStartTime - the time that the next task will start

Returns:

true if the current task finished and the next one was started, false otherwise

getCurrentTask

public CloudletTask getCurrentTask()

Gets the current task.

Returns:

getNextTaskIfCurrentIfFinished

protected CloudletTask getNextTaskIfCurrentIfFinished()

Gets the next task in the list if the current task is finished.

Returns:

the next task or null if the current task is already the last one or it is not finished yet.

isFinished

public boolean isFinished()

Description copied from interface: Cloudlet

Checks whether this Cloudlet has finished executing or not.

Specified by:

isFinished in interface Cloudlet

Overrides:

isFinished in class CloudletAbstract

Returns:

true if this Cloudlet has finished execution, false otherwise

getLength

public long getLength()

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).

The length of a NetworkCloudlet is the length sum of all its CloudletExecutionTask's.

Specified by:

getLength in interface Cloudlet

Overrides:

getLength in class CloudletAbstract

Returns:

the length sum of all CloudletExecutionTask's

See Also:

Cloudlet.getTotalLength(), Cloudlet.getNumberOfPes()

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

Overrides:

setFinishedLengthSoFar in class CloudletAbstract

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

addTask

public NetworkCloudlet addTask(CloudletTask task)

Adds a task to the task list and links the task to the NetworkCloudlet.

Parameters:

task - Task to be added

Returns:

the NetworkCloudlet instance

numberOfExecutionTasks

protected long numberOfExecutionTasks()