org.apache.brooklyn.util.text

Class StringEscapes.JavaStringEscapes

java.lang.Object

org.apache.brooklyn.util.text.StringEscapes.JavaStringEscapes

Enclosing class:

StringEscapes

public static class StringEscapes.JavaStringEscapes
extends java.lang.Object

Constructor Summary

Constructors

Constructor and Description
JavaStringEscapes()

Method Summary

Modifier and Type	Method and Description
static java.lang.String	escapeJavaString(java.lang.String value) converts normal string to java escaped for double-quotes (but not wrapped in double quotes)
static void	escapeJavaString(java.lang.String value, java.lang.Appendable out) converts normal string to java escaped for double-quotes (but not wrapped in double quotes)
static java.lang.String	unwrapJavaString(java.lang.String s) given a string in java syntax, e.g.
static java.lang.String	unwrapJavaStringIfWrapped(java.lang.String s) as unwrapJavaString(String) if the given string is wrapped in double quotes; otherwise just returns the given string
static java.util.List<java.lang.String>	unwrapJsonishListIfPossible(java.lang.String input) converts a comma separated list in a single string to a list of strings, doing what would be expected if given java or json style string as input, and falling back to returning the input.
static java.util.List<java.lang.String>	unwrapOptionallyQuotedJavaStringList(java.lang.String input) as unwrapJsonishListIfPossible(String) but throwing errors if something which looks like a string or set of brackets is not well-formed (this does the work for that method)
static java.util.List<java.lang.String>	unwrapQuotedJavaStringList(java.lang.String s, java.lang.String separator) Unwraps a sequence of quoted java strings, that are each separated by the given separator.
static java.lang.String	wrapJavaString(java.lang.String value) converts normal string to java escaped for double-quotes and wrapped in those double quotes
static void	wrapJavaString(java.lang.String value, java.lang.Appendable out) converts normal string to java escaped for double-quotes and wrapped in those double quotes
static java.util.List<java.lang.String>	wrapJavaStrings(java.lang.Iterable<java.lang.String> values)

Methods inherited from class java.lang.Object

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

Constructor Detail

JavaStringEscapes

public JavaStringEscapes()

Method Detail

escapeJavaString

public static java.lang.String escapeJavaString(java.lang.String value)

converts normal string to java escaped for double-quotes (but not wrapped in double quotes)

wrapJavaString

public static java.lang.String wrapJavaString(java.lang.String value)

converts normal string to java escaped for double-quotes and wrapped in those double quotes

wrapJavaStrings

public static java.util.List<java.lang.String> wrapJavaStrings(java.lang.Iterable<java.lang.String> values)

unwrapJavaStringIfWrapped

public static java.lang.String unwrapJavaStringIfWrapped(java.lang.String s)

as unwrapJavaString(String) if the given string is wrapped in double quotes; otherwise just returns the given string

wrapJavaString

public static void wrapJavaString(java.lang.String value,
                                  java.lang.Appendable out)
                           throws java.io.IOException

converts normal string to java escaped for double-quotes and wrapped in those double quotes

Throws:

java.io.IOException

escapeJavaString

public static void escapeJavaString(@Nonnull
                                    java.lang.String value,
                                    java.lang.Appendable out)
                             throws java.io.IOException

converts normal string to java escaped for double-quotes (but not wrapped in double quotes)

Throws:

java.io.IOException

unwrapJavaString

public static java.lang.String unwrapJavaString(java.lang.String s)

given a string in java syntax, e.g. wrapped in quotes and with backslash escapes, returns the literal value, without the surrounding quotes and unescaped; throws IllegalArgumentException if not a valid java string

unwrapQuotedJavaStringList

public static java.util.List<java.lang.String> unwrapQuotedJavaStringList(java.lang.String s,
                                                                          java.lang.String separator)

Unwraps a sequence of quoted java strings, that are each separated by the given separator.

Parameters:

trimmedArg -

Returns:

unwrapJsonishListIfPossible

public static java.util.List<java.lang.String> unwrapJsonishListIfPossible(java.lang.String input)

converts a comma separated list in a single string to a list of strings, doing what would be expected if given java or json style string as input, and falling back to returning the input.

this method does not throw exceptions on invalid input, but just returns that input

specifically, uses the following rules (executed once in sequence:

1) if of form [ X ] (in brackets after trim), then removes brackets and applies following rules to X (for any X including quoted or with commas) 2) if of form "X" (in double quotes after trim, where X contains no internal double quotes unless escaped with backslash) then returns list containing X unescaped (\x replaced by x) 3) if of form X or X, Y, ... (where X, Y, ... each satisfy the constraint given in 2, or have no double quotes or commas in them) then returns the concatenation of rule 2 applied to non-empty X, Y, ... (if you want an empty string in a list, you must double quote it) 4) for any other form X returns [ X ], including empty list for empty string

See Also:

unwrapOptionallyQuotedJavaStringList(String)

unwrapOptionallyQuotedJavaStringList

public static java.util.List<java.lang.String> unwrapOptionallyQuotedJavaStringList(java.lang.String input)

as unwrapJsonishListIfPossible(String) but throwing errors if something which looks like a string or set of brackets is not well-formed (this does the work for that method)

Throws:

java.lang.IllegalArgumentException - if looks to have quoted list or surrounding brackets but they are not syntactically valid