com.mesosphere.sdk.offer.evaluate.placement

Class MarathonConstraintParser

java.lang.Object

com.mesosphere.sdk.offer.evaluate.placement.MarathonConstraintParser

public class MarathonConstraintParser
extends java.lang.Object

Implements support for generating PlacementRules from Marathon-style constraint strings.

See Also:

Marathon Constraints

Method Summary

Modifier and Type	Method and Description
(package private) static java.util.Collection<java.lang.String>	escapedSplit(java.lang.String str, char split) Tokenizes the provided string using the provided split character.
static PlacementRule	parse(java.lang.String podName, java.lang.String marathonConstraints) Creates and returns a new PlacementRule against the provided marathon-style constraint string.
static PlacementRule	parseWith(java.lang.String podName, PlacementRule rule, java.lang.String marathonConstraints) ANDs the provided marathon-style constraint string onto the provided hard-coded PlacementRule, or returns the provided PlacementRule as-is if the marathon-style constraint is null or empty.
(package private) static java.util.List<java.util.List<java.lang.String>>	splitConstraints(java.lang.String marathonConstraints) Splits the provided marathon constraint statement into elements.

Methods inherited from class java.lang.Object

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

Method Detail

parseWith

public static PlacementRule parseWith(java.lang.String podName,
                                      PlacementRule rule,
                                      java.lang.String marathonConstraints)
                               throws java.io.IOException

ANDs the provided marathon-style constraint string onto the provided hard-coded PlacementRule, or returns the provided PlacementRule as-is if the marathon-style constraint is null or empty.

Parameters:

podName - The task type these constraints apply to (e.g. "hello"). Applying a constraint to all tasks in a service is not supported.

rule - The hard-coded PlacementRule

marathonConstraints - the marathon-style constraint string, containing one or more nested json list entries of the form [["multi","list","value"],["hello","hi"]], or one or more colon-separated entries of the form multi:list:value,hello:hi, or a null or empty value if no constraint is defined

Throws:

java.io.IOException - if marathonConstraints couldn't be parsed, or if the parsed content isn't valid or supported

parse

public static PlacementRule parse(java.lang.String podName,
                                  java.lang.String marathonConstraints)
                           throws java.io.IOException

Creates and returns a new PlacementRule against the provided marathon-style constraint string. Returns a PassthroughRule if the provided constraint string is null or empty.

Parameters:

podName - The task type these constraints apply to (e.g. "hello"). Applying a constraint to all tasks in a service is not supported.

marathonConstraints - the marathon-style constraint string, containing one or more nested json list entries of the form [["multi","list","value"],["hello","hi"]], or one or more colon-separated entries of the form multi:list:value,hello:hi, or a null or empty value if no constraint is defined

Throws:

java.io.IOException - if marathonConstraints couldn't be parsed, or if the parsed content isn't valid or supported

splitConstraints

static java.util.List<java.util.List<java.lang.String>> splitConstraints(java.lang.String marathonConstraints)
                                                                  throws java.io.IOException

Splits the provided marathon constraint statement into elements. Doesn't do any validation on the element contents.

Throws:

java.io.IOException

escapedSplit

static java.util.Collection<java.lang.String> escapedSplit(java.lang.String str,
                                                           char split)

Tokenizes the provided string using the provided split character. Honors any backslash escaping within the provided string. Tokens in the returned list are automatically trimmed. This is equivalent to calling Splitter.on(split).trimResults().split(str), except with the addition of support for escaping the 'split' value with backslashes.