org.apache.brooklyn.util.text

Class WildcardGlobs.SpecialistGlobExpander

java.lang.Object

org.apache.brooklyn.util.text.WildcardGlobs.SpecialistGlobExpander

Enclosing class:

WildcardGlobs

public static class WildcardGlobs.SpecialistGlobExpander
extends java.lang.Object

expands globs as per #getGlobsAfterBraceExpansion, but also handles numeric ranges, and optionally allows customized treatment of quoted regions and/or parentheses.

simple example: machine-{0-3}-{a,b} returns 8 values, machine-0-a machine-0-b machine-1-a ... machine-3-b; NB leading zeroes are meaningful, so {00-03} expands as 00, 01, 02, 03

quote INTERIOR_NOT_EXPANDABLE example: a{b,"c,d"} return ab ac,d

for more detail on special treatment of quote and parentheses see PhraseTreatment and WildcardGlobsTest

Constructor Summary

Constructors

Constructor and Description
SpecialistGlobExpander(boolean expandNumericRanges, WildcardGlobs.PhraseTreatment quoteTreatment, WildcardGlobs.PhraseTreatment parenthesesTreatment)

Method Summary

Modifier and Type	Method and Description
java.util.List<java.lang.String>	expand(java.lang.String glob) expands glob, including custom syntax for numeric part
java.lang.String[]	expandToArrayUnchecked(java.lang.String glob) expands glob, including custom syntax for numeric part, but to an array, and re-throwing the checked exception as a runtime exception
boolean	isGlobMatchedNumeric(java.lang.String globPattern, java.lang.String targetText) returns true iff the target matches the given pattern, under simplified bash rules -- viz permitting * and ? and comma delimited patterns inside curly braces, as well as things like {1,2,5-10} (and also {01,02,05-10} to keep leading 0)

Methods inherited from class java.lang.Object

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

Constructor Detail

SpecialistGlobExpander

public SpecialistGlobExpander(boolean expandNumericRanges,
                              WildcardGlobs.PhraseTreatment quoteTreatment,
                              WildcardGlobs.PhraseTreatment parenthesesTreatment)

Method Detail

expand

public java.util.List<java.lang.String> expand(java.lang.String glob)
                                        throws WildcardGlobs.InvalidPatternException

expands glob, including custom syntax for numeric part

Throws:

WildcardGlobs.InvalidPatternException

isGlobMatchedNumeric

public boolean isGlobMatchedNumeric(java.lang.String globPattern,
                                    java.lang.String targetText)
                             throws WildcardGlobs.InvalidPatternException

returns true iff the target matches the given pattern, under simplified bash rules -- viz permitting * and ? and comma delimited patterns inside curly braces, as well as things like {1,2,5-10} (and also {01,02,05-10} to keep leading 0)

Throws:

WildcardGlobs.InvalidPatternException

expandToArrayUnchecked

public java.lang.String[] expandToArrayUnchecked(java.lang.String glob)

expands glob, including custom syntax for numeric part, but to an array, and re-throwing the checked exception as a runtime exception