-
Notifications
You must be signed in to change notification settings - Fork 2.6k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #729 from TamasPergerDWP/f-parserconfig
Refactor ParserConfiguration class hierarchy
- Loading branch information
Showing
4 changed files
with
162 additions
and
126 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,112 @@ | ||
| package org.json; | ||
| /* | ||
| Public Domain. | ||
| */ | ||
|
|
||
| /** | ||
| * Configuration base object for parsers. The configuration is immutable. | ||
| */ | ||
| @SuppressWarnings({""}) | ||
| public class ParserConfiguration { | ||
| /** | ||
| * Used to indicate there's no defined limit to the maximum nesting depth when parsing a document. | ||
| */ | ||
| public static final int UNDEFINED_MAXIMUM_NESTING_DEPTH = -1; | ||
|
|
||
| /** | ||
| * The default maximum nesting depth when parsing a document. | ||
| */ | ||
| public static final int DEFAULT_MAXIMUM_NESTING_DEPTH = 512; | ||
|
|
||
| /** | ||
| * Specifies if values should be kept as strings (<code>true</code>), or if | ||
| * they should try to be guessed into JSON values (numeric, boolean, string) | ||
| */ | ||
| protected boolean keepStrings; | ||
|
|
||
| /** | ||
| * The maximum nesting depth when parsing a document. | ||
| */ | ||
| protected int maxNestingDepth; | ||
|
|
||
| public ParserConfiguration() { | ||
| this.keepStrings = false; | ||
| this.maxNestingDepth = DEFAULT_MAXIMUM_NESTING_DEPTH; | ||
| } | ||
|
|
||
| protected ParserConfiguration(final boolean keepStrings, final int maxNestingDepth) { | ||
| this.keepStrings = keepStrings; | ||
| this.maxNestingDepth = maxNestingDepth; | ||
| } | ||
|
|
||
| /** | ||
| * Provides a new instance of the same configuration. | ||
| */ | ||
| @Override | ||
| protected ParserConfiguration clone() { | ||
| // future modifications to this method should always ensure a "deep" | ||
| // clone in the case of collections. i.e. if a Map is added as a configuration | ||
| // item, a new map instance should be created and if possible each value in the | ||
| // map should be cloned as well. If the values of the map are known to also | ||
| // be immutable, then a shallow clone of the map is acceptable. | ||
| return new ParserConfiguration( | ||
| this.keepStrings, | ||
| this.maxNestingDepth | ||
| ); | ||
| } | ||
|
|
||
| /** | ||
| * When parsing the XML into JSONML, specifies if values should be kept as strings (<code>true</code>), or if | ||
| * they should try to be guessed into JSON values (numeric, boolean, string) | ||
| * | ||
| * @return The <code>keepStrings</code> configuration value. | ||
| */ | ||
| public boolean isKeepStrings() { | ||
| return this.keepStrings; | ||
| } | ||
|
|
||
| /** | ||
| * When parsing the XML into JSONML, specifies if values should be kept as strings (<code>true</code>), or if | ||
| * they should try to be guessed into JSON values (numeric, boolean, string) | ||
| * | ||
| * @param newVal | ||
| * new value to use for the <code>keepStrings</code> configuration option. | ||
| * | ||
| * @return The existing configuration will not be modified. A new configuration is returned. | ||
| */ | ||
| public <T extends ParserConfiguration> T withKeepStrings(final boolean newVal) { | ||
| T newConfig = (T)this.clone(); | ||
| newConfig.keepStrings = newVal; | ||
| return newConfig; | ||
| } | ||
|
|
||
| /** | ||
| * The maximum nesting depth that the parser will descend before throwing an exception | ||
| * when parsing the XML into JSONML. | ||
| * @return the maximum nesting depth set for this configuration | ||
| */ | ||
| public int getMaxNestingDepth() { | ||
| return 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. | ||
| * @param maxNestingDepth the maximum nesting depth allowed to the XML parser | ||
| * @return The existing configuration will not be modified. A new configuration is returned. | ||
| */ | ||
| public <T extends ParserConfiguration> T withMaxNestingDepth(int maxNestingDepth) { | ||
| T newConfig = (T)this.clone(); | ||
|
|
||
| if (maxNestingDepth > UNDEFINED_MAXIMUM_NESTING_DEPTH) { | ||
| newConfig.maxNestingDepth = maxNestingDepth; | ||
| } else { | ||
| newConfig.maxNestingDepth = UNDEFINED_MAXIMUM_NESTING_DEPTH; | ||
| } | ||
|
|
||
| return newConfig; | ||
| } | ||
| } |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.