org.apache.hadoop.yarn.util.constraint

Class PlacementConstraintParser

java.lang.Object

org.apache.hadoop.yarn.util.constraint.PlacementConstraintParser

@InterfaceAudience.Public
 @InterfaceStability.Unstable
public final class PlacementConstraintParser
extends Object

Placement constraint expression parser.

Method Summary

Modifier and Type	Method and Description
static org.apache.hadoop.yarn.api.resource.PlacementConstraint.AbstractConstraint	parseExpression(String constraintStr) Parses a given constraint expression to a PlacementConstraint.AbstractConstraint, this expression can be any valid form of constraint expressions.
static Map<org.apache.hadoop.yarn.util.constraint.PlacementConstraintParser.SourceTags,PlacementConstraint>	parsePlacementSpec(String expression) Parses a placement constraint specification.

Methods inherited from class java.lang.Object

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

Method Detail

parseExpression

public static org.apache.hadoop.yarn.api.resource.PlacementConstraint.AbstractConstraint parseExpression(String constraintStr)
                                                                                                  throws org.apache.hadoop.yarn.util.constraint.PlacementConstraintParseException

Parses a given constraint expression to a PlacementConstraint.AbstractConstraint, this expression can be any valid form of constraint expressions.

Parameters:

constraintStr - expression string

Returns:

a parsed PlacementConstraint.AbstractConstraint

Throws:

org.apache.hadoop.yarn.util.constraint.PlacementConstraintParseException - when given expression is malformed

parsePlacementSpec

public static Map<org.apache.hadoop.yarn.util.constraint.PlacementConstraintParser.SourceTags,PlacementConstraint> parsePlacementSpec(String expression)
                                                                                                                               throws org.apache.hadoop.yarn.util.constraint.PlacementConstraintParseException

Parses a placement constraint specification. A placement constraint spec is a composite expression which is composed by multiple sub constraint expressions delimited by ":". With following syntax:

Tag1=N1,P1:Tag2=N2,P2:...:TagN=Nn,Pn

where TagN=Nn is a key value pair to determine the source allocation tag and the number of allocations, such as:

foo=3

and where Pn can be any form of a valid constraint expression, such as:

• in,node,foo,bar
• notin,node,foo,bar,1,2
• and(notin,node,foo:notin,node,bar)

Parameters:

expression - expression string.

Returns:

a map of source tags to placement constraint mapping.

Throws:

org.apache.hadoop.yarn.util.constraint.PlacementConstraintParseException