Package com.google.common.escape
Class Escapers.Builder
-
- com.google.common.escape.Escapers.Builder
-
- Enclosing class:
- Escapers
@Beta public static final class Escapers.Builder extends
A builder for simple, fast escapers.Typically an escaper needs to deal with the escaping of high valued characters or code points. In these cases it is necessary to extend either
ArrayBasedCharEscaper
orArrayBasedUnicodeEscaper
to provide the desired behavior. However this builder is suitable for creating escapers that replace a relative small set of characters.- Since:
- 15.0
- Author:
- David Beaumont
-
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description Escapers.Builder
addEscape(char c, replacement)
Adds a replacement string for the given input character.Escaper
build()
Returns a new escaper based on the current state of the builder.Escapers.Builder
setSafeRange(char safeMin, char safeMax)
Sets the safe range of characters for the escaper.Escapers.Builder
unsafeReplacement)
Sets the replacement string for any characters outside the 'safe' range that have no explicit replacement.
-
-
-
Method Detail
-
setSafeRange
public Escapers.Builder setSafeRange(char safeMin, char safeMax)
Sets the safe range of characters for the escaper. Characters in this range that have no explicit replacement are considered 'safe' and remain unescaped in the output. IfsafeMax < safeMin
then the safe range is empty.- Parameters:
safeMin
- the lowest 'safe' charactersafeMax
- the highest 'safe' character- Returns:
- the builder instance
-
setUnsafeReplacement
public unsafeReplacement)
Sets the replacement string for any characters outside the 'safe' range that have no explicit replacement. IfunsafeReplacement
isnull
then no replacement will occur, if it is""
then the unsafe characters are removed from the output.- Parameters:
unsafeReplacement
- the string to replace unsafe characters- Returns:
- the builder instance
-
addEscape
public Escapers.Builder addEscape(char c, replacement)
Adds a replacement string for the given input character. The specified character will be replaced by the given string whenever it occurs in the input, irrespective of whether it lies inside or outside the 'safe' range.- Parameters:
c
- the character to be replacedreplacement
- the string to replace the given character- Returns:
- the builder instance
- Throws:
- if
replacement
is null
-
-