Util (Geotools modules 21.0 API)

Object
- Util

```
public class Util
extends Object
```
Parsing utilities

Constructor Summary

Constructors
Constructor and Description

Util()

Constructors
Constructor and Description
`Util()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static AnchorPoint`	`anchor(Object value, Factory factory)` Parses an anchor tuple.
`static Expression`	`color(Object value, Factory factory)` Parses a color from string representation.
`static <T> T`	`defaultForNull(T... options)` Returns the first non-null parameter or null.
`static Displacement`	`displacement(Object value, Factory factory)` Parses an displacement tuple.
`static Expression`	`expression(String value, boolean safe, Factory factory)` Parses an expression from its string representation.
`static Expression`	`expression(String value, Factory factory)` Parses an expression from its string representation.
`static float[]`	`floatArray(String value)` Parses a float array from a space delimited list.
`static <T> T`	`forceDefaultForNull(T... options)` Returns the first non-null parameter or throws NullPointerException.
`static ZoomContext`	`getNamedZoomContext(String name, List<ZoomContextFinder> zCtxtFinders)` Finds an applicable `ZoomContext` based on a name
`static Object`	`makeNumberIfPossible(String str)`
`static String`	`removeExpressionBrackets(String s)` Removes up to one set of ${ } expression brackets from a YSLD string.
`static String`	`serializeColor(Color c)` Serializes a Java `Color` to a String representation of the format "#RRGGBB"
`static List<Expression>`	`splitConcatenates(Expression expr)` Splits an `Expression` into a list of expressions by removing `ConcatenateFunction` and `FilterFunction_strConcat` Functions, and listing the children of those functions.
`static String`	`stripQuotes(String str)`
`static Expression`	`unwrapConcatenates(Expression expr, Factory factory)` Simplifies an `Expression` which may contain multiple `ConcatenateFunction` into a single top-level `ConcatenateFunction` with a flat list of parameters.
`static Map<String,String>`	`vendorOptions(YamlMap sourceMap)` Parse all vendor options (keys starting with 'x-')

Methods inherited from class Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - Util
```
public Util()
```
- Method Detail
  - expression
```
public static Expression expression(String value,
                                    Factory factory)
```
    Parses an expression from its string representation.
  - unwrapConcatenates
```
public static Expression unwrapConcatenates(Expression expr,
                                            Factory factory)
```
    Simplifies an Expression which may contain multiple ConcatenateFunction into a single top-level ConcatenateFunction with a flat list of parameters.
    If the passed Expression performs no concatenation, it is returned as-is. If the passed Expression represents an empty value, a Literal expression with value null is returned.
    
    Parameters:
    
    expr -
    
    factory - Function factory
    
    Returns:
    
    Simplified expression
  - splitConcatenates
```
public static List<Expression> splitConcatenates(Expression expr)
```
    Splits an Expression into a list of expressions by removing ConcatenateFunction and FilterFunction_strConcat Functions, and listing the children of those functions. This is applied recursively, so nested Expressions are also handled. Null-valued or empty Literal Expressions are removed.
    
    Parameters:
    
    expr -
    
    Returns:
    
    List of expressions, containing no concatenate functions
  - expression
```
public static Expression expression(String value,
                                    boolean safe,
                                    Factory factory)
```
    Parses an expression from its string representation.
    The safe parameter when set to true will cause null to be returned when the string can not be parsed as a ECQL expression. When false it will result in an exception thrown back.
    
    Returns:
    
    The parsed expression, or null if the string value was empty.
  - anchor
```
public static AnchorPoint anchor(Object value,
                                 Factory factory)
```
    Parses an anchor tuple.
  - displacement
```
public static Displacement displacement(Object value,
                                        Factory factory)
```
    Parses an displacement tuple.
  - color
```
public static Expression color(Object value,
                               Factory factory)
```
    Parses a color from string representation.
  - floatArray
```
public static float[] floatArray(String value)
```
    Parses a float array from a space delimited list.
  - defaultForNull
```
@SafeVarargs
 @Nullable
public static <T> T defaultForNull(@Nullable
                                                           T... options)
```
    Returns the first non-null parameter or null.
  - forceDefaultForNull
```
@SafeVarargs
public static <T> T forceDefaultForNull(@Nullable
                                                     T... options)
```
    Returns the first non-null parameter or throws NullPointerException.
  - getNamedZoomContext
```
@Nullable
public static ZoomContext getNamedZoomContext(String name,
                                                        List<ZoomContextFinder> zCtxtFinders)
```
    Finds an applicable ZoomContext based on a name
    
    Parameters:
    
    name - Name of the ZoomContext.
    
    zCtxtFinders - List of finders for the ZoomContext
    
    Returns:
    
    ZoomContext matching the name.
    
    Throws:
    
    IllegalArgumentException - If name is "EPSG:4326", "EPSG:3857", or "EPSG:900913" (These names cause ambiguities).
  - removeExpressionBrackets
```
public static String removeExpressionBrackets(String s)
```
    Removes up to one set of ${ } expression brackets from a YSLD string. Escape sequences for the characters $}\ within the brackets are unescaped.
    
    Parameters:
    
    s -
    
    Returns:
    
    s with brackets and escape sequences removed.
  - makeNumberIfPossible
```
public static Object makeNumberIfPossible(String str)
```
    Returns:
    
    A number parsed from the provided string, or the string itself if parsing failed. Also returns null if the string was null.
  - serializeColor
```
public static String serializeColor(Color c)
```
    Serializes a Java Color to a String representation of the format "#RRGGBB"
    
    Parameters:
    
    c - Color
    
    Returns:
    
    String representation of c
  - stripQuotes
```
public static String stripQuotes(String str)
```
    Returns:
    
    The string with quotes (') stripped from the beginning and end, or null if the string was null.
  - vendorOptions
```
public static Map<String,String> vendorOptions(YamlMap sourceMap)
```
    Parse all vendor options (keys starting with 'x-')
    
    Parameters:
    
    sourceMap - YamlMap to parse
    
    Returns:
    
    A map of the vendor options

Class Util

Constructor Summary

Method Summary

Methods inherited from class Object

Constructor Detail

Util

Method Detail

expression

unwrapConcatenates

splitConcatenates

expression

anchor

displacement

color

floatArray

defaultForNull

forceDefaultForNull

getNamedZoomContext

removeExpressionBrackets

makeNumberIfPossible

serializeColor

stripQuotes

vendorOptions