Package org.apache.hadoop.yarn.server.resourcemanager.scheduler.capacity

Class QueueCapacityVector

java.lang.Object

org.apache.hadoop.yarn.server.resourcemanager.scheduler.capacity.QueueCapacityVector

All Implemented Interfaces:

java.lang.Iterable<QueueCapacityVector.QueueCapacityVectorEntry>

public class QueueCapacityVector
extends java.lang.Object
implements java.lang.Iterable<QueueCapacityVector.QueueCapacityVectorEntry>

Contains capacity values with calculation types associated for each resource.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	QueueCapacityVector.QueueCapacityVectorEntry
static class	QueueCapacityVector.ResourceUnitCapacityType	Represents a capacity type associated with its syntax postfix.

Constructor Summary

Constructors

Constructor	Description
QueueCapacityVector()

Method Summary

Modifier and Type	Method	Description
java.util.Set<QueueCapacityVector.ResourceUnitCapacityType>	getDefinedCapacityTypes()	Returns a set of all capacity types defined for this vector.
double	getMemory()	A shorthand to retrieve the value stored for the memory resource.
QueueCapacityVector.QueueCapacityVectorEntry	getResource(java.lang.String resourceName)
int	getResourceCount()	Returns the number of resources defined for this vector.
java.util.Set<java.lang.String>	getResourceNames()
java.util.Set<java.lang.String>	getResourceNamesByCapacityType(QueueCapacityVector.ResourceUnitCapacityType capacityType)	Returns the name of all resources that are defined in the given capacity type.
boolean	isEmpty()
boolean	isMixedCapacityVector()	Checks whether the vector is a mixed capacity vector (more than one capacity type is used, therefore it is not uniform).
boolean	isResourceOfType(java.lang.String resourceName, QueueCapacityVector.ResourceUnitCapacityType capacityType)	Checks whether a resource unit is defined as a specific type.
java.util.Iterator<QueueCapacityVector.QueueCapacityVectorEntry>	iterator()
static QueueCapacityVector	newInstance()	Creates a zero QueueCapacityVector.
static QueueCapacityVector	of(double value, QueueCapacityVector.ResourceUnitCapacityType capacityType)	Creates a uniform and homogeneous QueueCapacityVector.
void	setResource(java.lang.String resourceName, double value, QueueCapacityVector.ResourceUnitCapacityType capacityType)	Set the value and capacity type of a resource.
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Constructor Detail

QueueCapacityVector

public QueueCapacityVector()

Method Detail

newInstance

public static QueueCapacityVector newInstance()

Creates a zero QueueCapacityVector. The resources are defined in absolute capacity type by default.

Returns:

zero capacity vector

of

public static QueueCapacityVector of(double value,
                                     QueueCapacityVector.ResourceUnitCapacityType capacityType)

Creates a uniform and homogeneous QueueCapacityVector. The resources are defined in absolute capacity type by default.

Parameters:

value - value to be set for each resource

capacityType - capacity type to be set for each resource

Returns:

uniform capacity vector

getResource

public QueueCapacityVector.QueueCapacityVectorEntry getResource(java.lang.String resourceName)

getResourceCount

public int getResourceCount()

Returns the number of resources defined for this vector.

Returns:

number of resources

setResource

public void setResource(java.lang.String resourceName,
                        double value,
                        QueueCapacityVector.ResourceUnitCapacityType capacityType)

Set the value and capacity type of a resource.

Parameters:

resourceName - name of the resource

value - value of the resource

capacityType - type of the resource

getMemory

public double getMemory()

A shorthand to retrieve the value stored for the memory resource.

Returns:

value of memory resource

isEmpty

public boolean isEmpty()

getResourceNamesByCapacityType

public java.util.Set<java.lang.String> getResourceNamesByCapacityType(QueueCapacityVector.ResourceUnitCapacityType capacityType)

Returns the name of all resources that are defined in the given capacity type.

Parameters:

capacityType - the capacity type of the resources

Returns:

all resource names for the given capacity type

isResourceOfType

public boolean isResourceOfType(java.lang.String resourceName,
                                QueueCapacityVector.ResourceUnitCapacityType capacityType)

Checks whether a resource unit is defined as a specific type.

Parameters:

resourceName - resource unit name

capacityType - capacity type

Returns:

true, if resource unit is defined as the given type

iterator

public java.util.Iterator<QueueCapacityVector.QueueCapacityVectorEntry> iterator()

Specified by:

iterator in interface java.lang.Iterable<QueueCapacityVector.QueueCapacityVectorEntry>

getDefinedCapacityTypes

public java.util.Set<QueueCapacityVector.ResourceUnitCapacityType> getDefinedCapacityTypes()

Returns a set of all capacity types defined for this vector.

Returns:

capacity types

isMixedCapacityVector

public boolean isMixedCapacityVector()

Checks whether the vector is a mixed capacity vector (more than one capacity type is used, therefore it is not uniform).

Returns:

true, if the vector is mixed

getResourceNames

public java.util.Set<java.lang.String> getResourceNames()

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object