Constructor Detail

• StringEscapes.JavaStringEscapes

  public StringEscapes.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