JsonFactoryBuilder.java
package tools.jackson.core.json;
import tools.jackson.core.*;
import tools.jackson.core.base.DecorableTSFactory.DecorableTSFBuilder;
import tools.jackson.core.io.CharacterEscapes;
import tools.jackson.core.io.SerializedString;
import tools.jackson.core.util.JsonRecyclerPools;
/**
* {@link tools.jackson.core.TSFBuilder}
* implementation for constructing {@link JsonFactory}
* instances for reading/writing JSON encoded content.
*/
public class JsonFactoryBuilder extends DecorableTSFBuilder<JsonFactory, JsonFactoryBuilder>
{
protected CharacterEscapes _characterEscapes;
protected SerializableString _rootValueSeparator;
protected int _maximumNonEscapedChar;
/**
* Character used for quoting Object Property names (if name quoting has not
* been disabled with {@link JsonWriteFeature#QUOTE_PROPERTY_NAMES})
* and JSON String values.
*/
protected char _quoteChar = JsonFactory.DEFAULT_QUOTE_CHAR;
public JsonFactoryBuilder() {
super(StreamReadConstraints.defaults(),
StreamWriteConstraints.defaults(),
ErrorReportConfiguration.defaults(),
JsonFactory.DEFAULT_JSON_PARSER_FEATURE_FLAGS,
JsonFactory.DEFAULT_JSON_GENERATOR_FEATURE_FLAGS);
_rootValueSeparator = JsonFactory.DEFAULT_ROOT_VALUE_SEPARATOR;
_maximumNonEscapedChar = 0;
_quoteChar = JsonFactory.DEFAULT_QUOTE_CHAR;
}
public JsonFactoryBuilder(JsonFactory base) {
super(base);
_characterEscapes = base._characterEscapes;
_rootValueSeparator = base._rootValueSeparator;
_maximumNonEscapedChar = base._maximumNonEscapedChar;
_quoteChar = base._quoteChar;
}
/*
/**********************************************************
/* Mutators
/**********************************************************
*/
// // // JSON-parsing features
// // // Parser features
public JsonFactoryBuilder enable(JsonReadFeature f) {
_formatReadFeatures |= f.getMask();
return this;
}
public JsonFactoryBuilder enable(JsonReadFeature first, JsonReadFeature... other) {
_formatReadFeatures |= first.getMask();
for (JsonReadFeature f : other) {
_formatReadFeatures |= f.getMask();
}
return this;
}
public JsonFactoryBuilder disable(JsonReadFeature f) {
_formatReadFeatures &= ~f.getMask();
return this;
}
public JsonFactoryBuilder disable(JsonReadFeature first, JsonReadFeature... other) {
_formatReadFeatures &= ~first.getMask();
for (JsonReadFeature f : other) {
_formatReadFeatures &= ~f.getMask();
}
return this;
}
public JsonFactoryBuilder configure(JsonReadFeature f, boolean state) {
return state ? enable(f) : disable(f);
}
// // // Generator features
public JsonFactoryBuilder enable(JsonWriteFeature f) {
_formatWriteFeatures |= f.getMask();
return this;
}
public JsonFactoryBuilder enable(JsonWriteFeature first, JsonWriteFeature... other) {
_formatWriteFeatures |= first.getMask();
for (JsonWriteFeature f : other) {
_formatWriteFeatures |= f.getMask();
}
return this;
}
public JsonFactoryBuilder disable(JsonWriteFeature f) {
_formatWriteFeatures &= ~f.getMask();
return this;
}
public JsonFactoryBuilder disable(JsonWriteFeature first, JsonWriteFeature... other) {
_formatWriteFeatures &= ~first.getMask();
for (JsonWriteFeature f : other) {
_formatWriteFeatures &= ~f.getMask();
}
return this;
}
public JsonFactoryBuilder configure(JsonWriteFeature f, boolean state) {
return state ? enable(f) : disable(f);
}
@Override
public JsonFactoryBuilder configureForJackson2() {
return super.configureForJackson2()
.disable(JsonWriteFeature.ESCAPE_FORWARD_SLASHES)
.disable(JsonWriteFeature.COMBINE_UNICODE_SURROGATES_IN_UTF8)
.recyclerPool(JsonRecyclerPools.threadLocalPool());
}
// // // Other JSON-specific configuration
/**
* Method for defining custom escapes factory uses for {@link JsonGenerator}s
* it creates.
*
* @param esc CharacterEscapes to configure, if any; {@code null} if none
*
* @return This builder instance (to allow call chaining)
*/
public JsonFactoryBuilder characterEscapes(CharacterEscapes esc) {
_characterEscapes = esc;
return this;
}
/**
* Method that allows overriding String used for separating root-level
* JSON values (default is single space character)
*
* @param sep Separator to use, if any; null means that no separator is
* automatically added
*
* @return This builder instance (to allow call chaining)
*/
public JsonFactoryBuilder rootValueSeparator(String sep) {
_rootValueSeparator = (sep == null) ? null : new SerializedString(sep);
return this;
}
/**
* Method that allows overriding String used for separating root-level
* JSON values (default is single space character)
*
* @param sep Separator to use, if any; null means that no separator is
* automatically added
*
* @return This builder instance (to allow call chaining)
*/
public JsonFactoryBuilder rootValueSeparator(SerializableString sep) {
_rootValueSeparator = sep;
return this;
}
/**
* Method that allows specifying threshold beyond which all characters are
* automatically escaped (without checking possible custom escaping settings
* a la {@link #characterEscapes}: for example, to force escaping of all non-ASCII
* characters (set to 127), or all non-Latin-1 character (set to 255).
* Default setting is "disabled", specified by passing value of {@code 0} (or
* negative numbers).
*<p>
* NOTE! Lowest legal value (aside from marker 0) is 127: for ASCII range, other checks apply
* and this threshold is ignored. If value between [1, 126] is specified, 127 will be
* used instead.
*
* @param maxNonEscaped Highest character code that is NOT automatically escaped; if
* positive value above 0, or 0 to indicate that no automatic escaping is applied
* beside from what JSON specification requires (and possible custom escape settings).
* Values between 1 and 127 are all taken to behave as if 127 is specified: that is,
* no automatic escaping is applied in ASCII range.
*
* @return This builder instance (to allow call chaining)
*/
public JsonFactoryBuilder highestNonEscapedChar(int maxNonEscaped) {
_maximumNonEscapedChar = (maxNonEscaped <= 0) ? 0 : Math.max(127, maxNonEscaped);
return this;
}
/**
* Method that allows specifying an alternate
* character used for quoting Object Property names (if name quoting has not
* been disabled with {@link JsonWriteFeature#QUOTE_PROPERTY_NAMES})
* and JSON String values.
*<p>
* Default value is double-quote ({@code "}); typical alternative is
* single-quote/apostrophe ({@code '}).
*
* @param ch Character to use for quoting Object Property names and JSON String values.
*
* @return This builder instance (to allow call chaining)
*/
public JsonFactoryBuilder quoteChar(char ch) {
// 12-Aug-2019, tatu: Due to implementation details, escaping characters beyond
// 7-bit ASCII set has deep overhead so let's limit set. If we absolutely
// must it is possible of course, but leads to problems combining with
// custom escaping aspects.
if (ch > 0x7F) {
throw new IllegalArgumentException("Can only use Unicode characters up to 0x7F as quote characters");
}
_quoteChar = ch;
return this;
}
// // // Accessors for JSON-specific settings
public CharacterEscapes characterEscapes() { return _characterEscapes; }
public SerializableString rootValueSeparator() { return _rootValueSeparator; }
public int highestNonEscapedChar() { return _maximumNonEscapedChar; }
public char quoteChar() { return _quoteChar; }
@Override
public JsonFactory build() {
// 28-Dec-2017, tatu: No special settings beyond base class ones, so:
return new JsonFactory(this);
}
}