org.graalvm.shadowed.org.json

Class JSONMLParserConfiguration

java.lang.Object

org.graalvm.shadowed.org.json.JSONMLParserConfiguration

public class JSONMLParserConfiguration
extends Object

Configuration object for the XML to JSONML parser. The configuration is immutable.

Field Summary

Fields

Modifier and Type	Field and Description
static int	DEFAULT_MAXIMUM_NESTING_DEPTH The default maximum nesting depth when parsing a XML document to JSONML.
static JSONMLParserConfiguration	KEEP_STRINGS Original configuration of the XML to JSONML Parser except that values are kept as strings.
static JSONMLParserConfiguration	ORIGINAL Original Configuration of the XML to JSONML Parser.
static int	UNDEFINED_MAXIMUM_NESTING_DEPTH Used to indicate there's no defined limit to the maximum nesting depth when parsing a XML document to JSONML.

Constructor Summary

Constructors

Constructor and Description
JSONMLParserConfiguration() Default parser configuration.

Method Summary

Modifier and Type	Method and Description
protected JSONMLParserConfiguration	clone() Provides a new instance of the same configuration.
int	getMaxNestingDepth() The maximum nesting depth that the parser will descend before throwing an exception when parsing the XML into JSONML.
boolean	isKeepStrings() When parsing the XML into JSONML, specifies if values should be kept as strings (true), or if they should try to be guessed into JSON values (numeric, boolean, string)
JSONMLParserConfiguration	withKeepStrings(boolean newVal) When parsing the XML into JSONML, specifies if values should be kept as strings (true), or if they should try to be guessed into JSON values (numeric, boolean, string)
JSONMLParserConfiguration	withMaxNestingDepth(int maxNestingDepth) Defines the maximum nesting depth that the parser will descend before throwing an exception when parsing the XML into JSONML.

Methods inherited from class java.lang.Object

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

Field Detail

UNDEFINED_MAXIMUM_NESTING_DEPTH

public static final int UNDEFINED_MAXIMUM_NESTING_DEPTH

Used to indicate there's no defined limit to the maximum nesting depth when parsing a XML document to JSONML.

See Also:

Constant Field Values

DEFAULT_MAXIMUM_NESTING_DEPTH

public static final int DEFAULT_MAXIMUM_NESTING_DEPTH

The default maximum nesting depth when parsing a XML document to JSONML.

See Also:

Constant Field Values

ORIGINAL

public static final JSONMLParserConfiguration ORIGINAL

Original Configuration of the XML to JSONML Parser.

KEEP_STRINGS

public static final JSONMLParserConfiguration KEEP_STRINGS

Original configuration of the XML to JSONML Parser except that values are kept as strings.

Constructor Detail

JSONMLParserConfiguration

public JSONMLParserConfiguration()

Default parser configuration. Does not keep strings (tries to implicitly convert values).

Method Detail

clone

protected JSONMLParserConfiguration clone()

Provides a new instance of the same configuration.

Overrides:

clone in class Object

isKeepStrings

public boolean isKeepStrings()

When parsing the XML into JSONML, specifies if values should be kept as strings (true), or if they should try to be guessed into JSON values (numeric, boolean, string)

Returns:

The keepStrings configuration value.

withKeepStrings

public JSONMLParserConfiguration withKeepStrings(boolean newVal)

When parsing the XML into JSONML, specifies if values should be kept as strings (true), or if they should try to be guessed into JSON values (numeric, boolean, string)

Parameters:

newVal - new value to use for the keepStrings configuration option.

Returns:

The existing configuration will not be modified. A new configuration is returned.

getMaxNestingDepth

public int getMaxNestingDepth()

The maximum nesting depth that the parser will descend before throwing an exception when parsing the XML into JSONML.

Returns:

the maximum nesting depth set for this configuration

withMaxNestingDepth

public JSONMLParserConfiguration withMaxNestingDepth(int maxNestingDepth)

Defines the maximum nesting depth that the parser will descend before throwing an exception when parsing the XML into JSONML. The default max nesting depth is 512, which means the parser will throw a JsonException if the maximum depth is reached. Using any negative value as a parameter is equivalent to setting no limit to the nesting depth, which means the parses will go as deep as the maximum call stack size allows.

Parameters:

maxNestingDepth - the maximum nesting depth allowed to the XML parser

Returns:

The existing configuration will not be modified. A new configuration is returned.