JSONSettings.java

/*******************************************************************************
 * Copyright (c) 2018 Eclipse RDF4J contributors.
 *
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Distribution License v1.0
 * which accompanies this distribution, and is available at
 * http://www.eclipse.org/org/documents/edl-v10.php.
 *
 * SPDX-License-Identifier: BSD-3-Clause
 *******************************************************************************/
package org.eclipse.rdf4j.rio.helpers;

import org.eclipse.rdf4j.rio.RioSetting;

/**
 * Generic JSON settings, mostly related to Jackson Features.
 * <p>
 * Several of these settings can be overridden by means of a system property, but only if specified at JVM startup time.
 *
 * @author Peter Ansell
 */
public class JSONSettings {

	/**
	 * Boolean setting for JSON parsers to determine if any character is allowed to be backslash escaped.
	 * <p>
	 * Defaults to false.
	 * <p>
	 * Can be overridden by setting system property
	 * {@code org.eclipse.rdf4j.rio.json.allow_backslash_escaping_any_character}.
	 */
	public static final BooleanRioSetting ALLOW_BACKSLASH_ESCAPING_ANY_CHARACTER = new BooleanRioSetting(
			"org.eclipse.rdf4j.rio.json.allow_backslash_escaping_any_character",
			"Allow backslash escaping any character", Boolean.FALSE);

	/**
	 * Boolean setting for JSON parsers to determine if Java/C++ style comments are allowed.
	 * <p>
	 * Defaults to false.
	 * <p>
	 * Can be overridden by setting system property {@code org.eclipse.rdf4j.rio.json.allow_comments}.
	 */
	public static final BooleanRioSetting ALLOW_COMMENTS = new BooleanRioSetting(
			"org.eclipse.rdf4j.rio.json.allow_comments", "Allow comments", Boolean.FALSE);

	/**
	 * Boolean setting for JSON parsers to determine if non-numeric numbers (INF/-INF/NaN) are allowed.
	 * <p>
	 * Defaults to false.
	 * <p>
	 * Can be overridden by setting system property {@code org.eclipse.rdf4j.rio.json.allow_non_numeric_numbers}.
	 */
	public static final BooleanRioSetting ALLOW_NON_NUMERIC_NUMBERS = new BooleanRioSetting(
			"org.eclipse.rdf4j.rio.json.allow_non_numeric_numbers", "Allow non-numeric numbers", Boolean.FALSE);

	/**
	 * Boolean setting for JSON parsers to determine if numeric leading zeroes are allowed.
	 * <p>
	 * Defaults to false.
	 * <p>
	 * Can be overridden by setting system property {@code org.eclipse.rdf4j.rio.json.allow_numeric_leading_zeros}.
	 */
	public static final BooleanRioSetting ALLOW_NUMERIC_LEADING_ZEROS = new BooleanRioSetting(
			"org.eclipse.rdf4j.rio.json.allow_numeric_leading_zeros", "Allow numeric leading zeros", Boolean.FALSE);

	/**
	 * Boolean setting for JSON parsers to determine if single quotes are allowed.
	 * <p>
	 * Defaults to false.
	 * <p>
	 * Can be overridden by setting system property {@code org.eclipse.rdf4j.rio.json.allow_single_quotes}.
	 */
	public static final BooleanRioSetting ALLOW_SINGLE_QUOTES = new BooleanRioSetting(
			"org.eclipse.rdf4j.rio.json.allow_single_quotes", "Allow single quotes", Boolean.FALSE);

	/**
	 * Boolean setting for JSON parsers to determine if unquoted control characters are allowed.
	 * <p>
	 * Defaults to false.
	 * <p>
	 * Can be overridden by setting system property {@code org.eclipse.rdf4j.rio.json.allow_unquoted_control_chars}.
	 */
	public static final BooleanRioSetting ALLOW_UNQUOTED_CONTROL_CHARS = new BooleanRioSetting(
			"org.eclipse.rdf4j.rio.json.allow_unquoted_control_chars", "Allow unquoted control chars", Boolean.FALSE);

	/**
	 * Boolean setting for JSON parsers to determine if unquoted field names are allowed.
	 * <p>
	 * Defaults to false.
	 * <p>
	 * Can be overridden by setting system property {@code org.eclipse.rdf4j.rio.json.allow_unquoted_field_names}.
	 */
	public static final BooleanRioSetting ALLOW_UNQUOTED_FIELD_NAMES = new BooleanRioSetting(
			"org.eclipse.rdf4j.rio.json.allow_unquoted_field_names", "Allow unquoted field names", Boolean.FALSE);

	/**
	 * Boolean setting for JSON parsers to determine if YAML comments (starting with '#') are allowed.
	 * <p>
	 * Defaults to false.
	 * <p>
	 * Can be overridden by setting system property {@code org.eclipse.rdf4j.rio.json.allow_yaml_comments}.
	 */
	public static final BooleanRioSetting ALLOW_YAML_COMMENTS = new BooleanRioSetting(
			"org.eclipse.rdf4j.rio.json.allow_yaml_comments", "Allow YAML comments", Boolean.FALSE);

	/**
	 * Boolean setting for JSON parsers to determine if trailing commas are allowed.
	 * <p>
	 * Defaults to false.
	 * <p>
	 * Can be overridden by setting system property {@code org.eclipse.rdf4j.rio.json.allow_trailing_comma}.
	 */
	public static final BooleanRioSetting ALLOW_TRAILING_COMMA = new BooleanRioSetting(
			"org.eclipse.rdf4j.rio.json.allow_trailing_comma", "Allow trailing comma", Boolean.FALSE);

	/**
	 * Boolean setting for JSON parsers to determine if errors should include a reference to the source or not.
	 * <p>
	 * Defaults to true.
	 * <p>
	 * Can be overridden by setting system property {@code org.eclipse.rdf4j.rio.json.include_source_in_location}.
	 */
	public static final BooleanRioSetting INCLUDE_SOURCE_IN_LOCATION = new BooleanRioSetting(
			"org.eclipse.rdf4j.rio.json.include_source_in_location", "Include Source in Location", Boolean.TRUE);

	/**
	 * Boolean setting for JSON parsers to determine if strict duplicate detection is allowed for JSON Object field
	 * names.
	 * <p>
	 * Defaults to false.
	 * <p>
	 * Can be overridden by setting system property {@code org.eclipse.rdf4j.rio.json.strict_duplicate_detection}.
	 */
	public static final BooleanRioSetting STRICT_DUPLICATE_DETECTION = new BooleanRioSetting(
			"org.eclipse.rdf4j.rio.json.strict_duplicate_detection", "Strict duplicate detection", Boolean.FALSE);

	/**
	 * Private default constructor.
	 */
	private JSONSettings() {
	}

}