org.cloudbus.cloudsim.lists

Class HostList

java.lang.Object

org.cloudbus.cloudsim.lists.HostList

public final class HostList
extends Object

HostList is a collection of operations on lists of hosts (PMs).

Since:

CloudSim Toolkit 2.0

Author:

Anton Beloglazov

Method Summary

Modifier and Type	Method and Description
static <T extends Host> T	getById(List<T> hostList, int id) Gets a Host with a given id.
static <T extends Host> T	getHostWithFreePe(List<T> hostList) Gets the first host with free PEs.
static <T extends Host> T	getHostWithFreePe(List<T> hostList, int pesNumber) Gets the first Host with a specified number of free PEs.
static int	getNumberOfBusyPes(List<? extends Host> hostList) Gets the total number of BUSY PEs for all Hosts.
static int	getNumberOfFreePes(List<? extends Host> hostList) Gets the total number of FREE (non-busy) PEs for all Hosts.
static int	getNumberOfPes(List<? extends Host> hostList) Gets the total number of PEs for all Hosts.
static boolean	setPeStatus(List<? extends Host> hostList, Pe.Status status, int hostId, int peId) Sets the status of a particular PE on a given Host.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getById

public static <T extends Host> T getById(List<T> hostList,
                                         int id)

Gets a Host with a given id.

Type Parameters:

T - the generic type

Parameters:

hostList - the list of existing hosts

id - the host ID

Returns:

a Host with the given ID or $null if not found

Precondition:

id >= 0

Postcondition:

$none

getNumberOfPes

public static int getNumberOfPes(List<? extends Host> hostList)

Gets the total number of PEs for all Hosts.

Parameters:

hostList - the list of existing hosts

Returns:

total number of PEs for all PMs

Precondition:

$none

Postcondition:

$result >= 0

getNumberOfFreePes

public static int getNumberOfFreePes(List<? extends Host> hostList)

Gets the total number of FREE (non-busy) PEs for all Hosts.

Parameters:

hostList - the list of existing hosts

Returns:

total number of free PEs

Precondition:

$none

Postcondition:

$result >= 0

getNumberOfBusyPes

public static int getNumberOfBusyPes(List<? extends Host> hostList)

Gets the total number of BUSY PEs for all Hosts.

Parameters:

hostList - the list of existing hosts

Returns:

total number of busy PEs

Precondition:

$none

Postcondition:

$result >= 0

getHostWithFreePe

public static <T extends Host> T getHostWithFreePe(List<T> hostList)

Gets the first host with free PEs.

Type Parameters:

T - the class of Hosts inside the List

Parameters:

hostList - the list of existing hosts

Returns:

a Host object or null if not found

Precondition:

$none

Postcondition:

$none

getHostWithFreePe

public static <T extends Host> T getHostWithFreePe(List<T> hostList,
                                                   int pesNumber)

Gets the first Host with a specified number of free PEs.

Type Parameters:

T - the class of Hosts inside the List

Parameters:

hostList - the list of existing hosts

pesNumber - the pes number

Returns:

a Host object or null if not found

Precondition:

$none

Postcondition:

$none

setPeStatus

public static boolean setPeStatus(List<? extends Host> hostList,
                                  Pe.Status status,
                                  int hostId,
                                  int peId)

Sets the status of a particular PE on a given Host.

Parameters:

hostList - the list of existing hosts

status - the new PE status

hostId - the host id

peId - the id of the PE to set the status

Returns:

true if the PE status has changed, false otherwise (host id or PE id might not be exist)

Precondition:

hostId >= 0, peId >= 0

Postcondition:

$none