public class CloudSim extends Object implements Simulation
| Modifier and Type | Field and Description |
|---|---|
static String |
VERSION
CloudSim Plus current version.
|
ANY_EVT, NULL| Constructor and Description |
|---|
CloudSim()
Creates a CloudSim simulation.
|
CloudSim(double minTimeBetweenEvents)
Creates a CloudSim simulation that tracks events happening in a time interval
as little as the minTimeBetweenEvents parameter.
|
| Modifier and Type | Method and Description |
|---|---|
void |
abort()
Aborts the simulation without finishing the processing
of entities in the
entities list, what may give
unexpected results. |
void |
addEntity(CloudSimEntity e)
Adds a new entity to the simulation.
|
Simulation |
addOnClockTickListener(EventListener<EventInfo> listener)
Adds a
EventListener object that will be notified every time when the
simulation clock advances. |
Simulation |
addOnEventProcessingListener(EventListener<SimEvent> listener)
Adds a
EventListener object that will be notified when any event
is processed by CloudSim. |
Simulation |
addOnSimulationPausedListener(EventListener<EventInfo> listener)
Adds an
EventListener object that will be notified when the simulation is paused. |
SimEvent |
cancel(SimEntity src,
Predicate<SimEvent> p)
Cancels the first event from the future event queue that matches a given predicate
and was sent by a given entity, then removes it from the queue.
|
boolean |
cancelAll(SimEntity src,
Predicate<SimEvent> p)
Cancels all events from the future event queue that matches a given predicate
and were sent by a given entity, then removes those ones from the queue.
|
double |
clock()
Gets the current simulation time in seconds.
|
double |
clockInHours()
Gets the current simulation time in hours.
|
double |
clockInMinutes()
Gets the current simulation time in minutes.
|
SimEvent |
findFirstDeferred(SimEntity dest,
Predicate<SimEvent> p)
Find first deferred event matching a predicate.
|
Calendar |
getCalendar()
Gets a new copy of initial simulation Calendar.
|
CloudInformationService |
getCloudInfoService()
Gets the
CloudInformationService. |
Set<Datacenter> |
getDatacenterList()
Sends a request to Cloud Information Service (CIS) entity to get the list
of all Cloud Datacenter IDs.
|
List<SimEntity> |
getEntityList()
Returns a read-only list of entities created for the simulation.
|
double |
getMinTimeBetweenEvents()
Returns the minimum time between events (in seconds).
|
NetworkTopology |
getNetworkTopology()
Gets the network topology used for Network simulations.
|
long |
getNumberOfFutureEvents(Predicate<SimEvent> predicate)
Gets the number of events in the future queue
which match a given predicate.
|
int |
getNumEntities()
Get the current number of entities in the simulation.
|
void |
holdEntity(SimEntity src,
long delay)
Holds an entity for some time.
|
boolean |
isPaused()
Checks if the simulation is paused.
|
boolean |
isRunning()
Check if the simulation is still running.
|
boolean |
isTerminationTimeSet() |
boolean |
isTimeToTerminateSimulationUnderRequest() |
boolean |
pause()
Requests the simulation to be paused as soon as possible.
|
boolean |
pause(double time)
Requests the simulation to be paused at a given time.
|
void |
pauseEntity(SimEntity src,
double delay)
Pauses an entity for some time.
|
boolean |
removeOnClockTickListener(EventListener<? extends EventInfo> listener)
Removes a listener from the onClockTickListener List.
|
boolean |
removeOnEventProcessingListener(EventListener<SimEvent> listener)
Removes a listener from the onEventProcessingListener List.
|
boolean |
removeOnSimulationPausedListener(EventListener<EventInfo> listener)
Removes a listener from the onSimulationPausedListener List.
|
boolean |
resume()
This method is called if one wants to resume the simulation that has
previously been paused.
|
SimEvent |
select(SimEntity dest,
Predicate<SimEvent> p)
Selects the first deferred event that matches a given predicate
and removes it from the queue.
|
void |
send(SimEntity src,
SimEntity dest,
double delay,
int tag,
Object data)
Sends an event from one entity to another.
|
void |
sendFirst(SimEntity src,
SimEntity dest,
double delay,
int tag,
Object data)
Sends an event from one entity to another, adding it to the beginning of the queue in order to give priority to it.
|
void |
sendNow(SimEntity src,
SimEntity dest,
int tag,
Object data)
Sends an event from one entity to another without delaying
the message.
|
void |
setNetworkTopology(NetworkTopology networkTopology)
Sets the network topology used for Network simulations.
|
double |
start()
Starts simulation execution and waits for
all entities to finish, i.e.
|
boolean |
terminate()
Forces the termination of the simulation before it ends.
|
boolean |
terminateAt(double time)
Schedules the termination of the simulation for a given time (in seconds).
|
void |
wait(CloudSimEntity src,
Predicate<SimEvent> p)
Sets the state of an entity to
SimEntity.State.WAITING,
making it to wait for events that satisfy a given predicate. |
long |
waiting(SimEntity dest,
Predicate<SimEvent> p)
Gets the number of events in the deferred event queue that are targeted to a given entity and
match a given predicate.
|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitsetIdForEntitiesWithoutOne, setIdForEntitiesWithoutOnepublic static final String VERSION
public CloudSim()
CloudInformationService,
CloudSim(double)public CloudSim(double minTimeBetweenEvents)
CloudInformationService.minTimeBetweenEvents - the minimal period between events. Events
within shorter periods after the last event are discarded.CloudInformationServicepublic double start()
SimulationNote: This method should be called just after all the entities have been setup and added. The method blocks until the simulation is ended.
start in interface Simulationpublic boolean isTimeToTerminateSimulationUnderRequest()
isTimeToTerminateSimulationUnderRequest in interface Simulationpublic boolean terminate()
Simulationterminate in interface Simulationpublic boolean terminateAt(double time)
SimulationIf a termination time is set, the simulation stays running even
if there is no event to process.
It keeps waiting for new dynamic events, such as the creation
of Cloudlets and VMs at runtime.
If no event happens, the clock is increased to simulate time passing.
The clock increment is defined according to: (i) the lower Datacenter.getSchedulingInterval()
between existing Datacenters; or (ii) Simulation.getMinTimeBetweenEvents() in case
no Datacenter has its schedulingInterval set.
terminateAt in interface Simulationtime - the time at which the simulation has to be terminated (in seconds)public double getMinTimeBetweenEvents()
SimulationgetMinTimeBetweenEvents in interface Simulationpublic Calendar getCalendar()
SimulationgetCalendar in interface Simulationpublic CloudInformationService getCloudInfoService()
SimulationCloudInformationService.getCloudInfoService in interface Simulationpublic Set<Datacenter> getDatacenterList()
SimulationgetDatacenterList in interface Simulationpublic double clock()
Simulationclock in interface SimulationSimulation.isRunning()public double clockInMinutes()
SimulationclockInMinutes in interface SimulationSimulation.isRunning()public double clockInHours()
SimulationclockInHours in interface SimulationSimulation.isRunning()public int getNumEntities()
SimulationgetNumEntities in interface Simulationpublic List<SimEntity> getEntityList()
SimulationgetEntityList in interface Simulationpublic void addEntity(CloudSimEntity e)
SimulationCloudSimEntity object
register itself when it is instantiated.addEntity in interface Simulatione - The new entitypublic void sendNow(SimEntity src, SimEntity dest, int tag, Object data)
SimulationsendNow in interface Simulationsrc - entity that scheduled the eventdest - entity that the event will be sent totag - the tag that classifies the eventdata - the data to be sent inside the eventpublic void send(SimEntity src, SimEntity dest, double delay, int tag, Object data)
Simulationsend in interface Simulationsrc - entity that scheduled the eventdest - entity that the event will be sent todelay - How many seconds after the current simulation time the event should be senttag - the tag that classifies the eventdata - the data to be sent inside the eventpublic void sendFirst(SimEntity src, SimEntity dest, double delay, int tag, Object data)
SimulationsendFirst in interface Simulationsrc - entity that scheduled the eventdest - entity that the event will be sent todelay - How many seconds after the current simulation time the event should be senttag - the tag that classifies the eventdata - the data to be sent inside the eventpublic void wait(CloudSimEntity src, Predicate<SimEvent> p)
SimulationSimEntity.State.WAITING,
making it to wait for events that satisfy a given predicate.
Only such events will be passed to the entity.
This is done to avoid unnecessary context Datacenter.wait in interface Simulationsrc - entity that scheduled the eventp - the event selection predicatepublic long waiting(SimEntity dest, Predicate<SimEvent> p)
Simulationwaiting in interface Simulationdest - Id of entity that the event has to be sent top - the event selection predicatepublic SimEvent select(SimEntity dest, Predicate<SimEvent> p)
Simulationselect in interface Simulationdest - entity that the event has to be sent top - the event selection predicateSimEvent.NULL if not foundpublic SimEvent findFirstDeferred(SimEntity dest, Predicate<SimEvent> p)
SimulationfindFirstDeferred in interface Simulationdest - Id of entity that the event has to be sent top - the event selection predicateSimEvent.NULL if not foundpublic SimEvent cancel(SimEntity src, Predicate<SimEvent> p)
Simulationcancel in interface Simulationsrc - Id of entity that scheduled the eventp - the event selection predicateSimEvent.NULL if not foundpublic boolean cancelAll(SimEntity src, Predicate<SimEvent> p)
SimulationcancelAll in interface Simulationsrc - Id of entity that scheduled the eventp - the event selection predicatepublic boolean isRunning()
Simulationis paused,
the method returns true to indicate that the simulation is
in fact active yet.
This method should be used by entities to check if they should continue executing.
isRunning in interface Simulationpublic boolean pause()
Simulationpause in interface Simulationpublic boolean pause(double time)
Simulationpause in interface Simulationtime - the time at which the simulation has to be pausedpublic boolean resume()
Simulationresume in interface Simulationpublic void pauseEntity(SimEntity src, double delay)
SimulationpauseEntity in interface Simulationsrc - id of entity to be pauseddelay - the time period for which the entity will be inactivepublic void holdEntity(SimEntity src, long delay)
SimulationholdEntity in interface Simulationsrc - id of entity to be helddelay - How many seconds after the current time the entity has to be heldpublic long getNumberOfFutureEvents(Predicate<SimEvent> predicate)
SimulationgetNumberOfFutureEvents in interface Simulationpredicate - the predicate to filter the list of future events.public boolean isTerminationTimeSet()
isTerminationTimeSet in interface Simulationpublic void abort()
Simulationentities list, what may give
unexpected results.
Use this method just if you want to abandon the simulation an usually ignore the results.
abort in interface Simulationpublic boolean isPaused()
SimulationisPaused in interface Simulationpublic final Simulation addOnSimulationPausedListener(EventListener<EventInfo> listener)
SimulationEventListener object that will be notified when the simulation is paused.
When this Listener is notified, it will receive an EventInfo informing
the time the pause occurred.
This object is just information about the event that happened. In fact, it isn't generated an actual for a pause event because there is not need for that.
addOnSimulationPausedListener in interface Simulationlistener - the event listener to addpublic boolean removeOnSimulationPausedListener(EventListener<EventInfo> listener)
SimulationremoveOnSimulationPausedListener in interface Simulationlistener - the listener to removepublic final Simulation addOnEventProcessingListener(EventListener<SimEvent> listener)
SimulationEventListener object that will be notified when any event
is processed by CloudSim. When this Listener is notified, it will receive
the SimEvent that was processed.addOnEventProcessingListener in interface Simulationlistener - the event listener to addpublic boolean removeOnEventProcessingListener(EventListener<SimEvent> listener)
SimulationremoveOnEventProcessingListener in interface Simulationlistener - the listener to removepublic Simulation addOnClockTickListener(EventListener<EventInfo> listener)
SimulationEventListener object that will be notified every time when the
simulation clock advances. Notifications are sent in a second interval to avoid notification flood.
Thus, if the clock changes, for instance, from 1.0, to 1.1, 2.0, 2.1, 2.2, 2.5 and then 3.2,
notifications will just be sent for the times 1, 2 and 3 that represent the integer
part of the simulation time.addOnClockTickListener in interface Simulationlistener - the event listener to addpublic boolean removeOnClockTickListener(EventListener<? extends EventInfo> listener)
SimulationremoveOnClockTickListener in interface Simulationlistener - the listener to removepublic NetworkTopology getNetworkTopology()
SimulationgetNetworkTopology in interface Simulationpublic void setNetworkTopology(NetworkTopology networkTopology)
SimulationsetNetworkTopology in interface SimulationnetworkTopology - the network topology to setCopyright © 2015–2018 Systems, Security and Image Communication Lab - Instituto de Telecomunicações (IT) - Universidade da Beira Interior (UBI) - Instituto Federal de Educação Ciência e Tecnologia do Tocantins (IFTO). All rights reserved.