• Home
• com.github.cliftonlabs
• json-simple
• 2.3.0
• source code
• Jsoner.java

×

Project download

Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance.
Project price only 1 $

You can buy this project and download/modify it how often you want.

org.json.simple.Jsoner Maven / Gradle / Ivy

/* Copyright 2016 Clifton Labs
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 * http://www.apache.org/licenses/LICENSE-2.0
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License. */
package org.json.simple;

import java.io.IOException;
import java.io.Reader;
import java.io.StringReader;
import java.io.StringWriter;
import java.io.Writer;
import java.util.Collection;
import java.util.EnumSet;
import java.util.Iterator;
import java.util.LinkedList;
import java.util.Map;
import java.util.Set;

/** Jsoner provides JSON utilities for escaping strings to be JSON compatible, thread safe parsing (RFC 4627) JSON
 * strings, and serializing data to strings in JSON format.
 * @since 2.0.0 */
public class Jsoner{
	/** Flags to tweak the behavior of the primary deserialization method. */
	private static enum DeserializationOptions{
		/** Whether multiple JSON values can be deserialized as a root element. */
		ALLOW_CONCATENATED_JSON_VALUES,
		/** Whether a JsonArray can be deserialized as a root element. */
		ALLOW_JSON_ARRAYS,
		/** Whether a boolean, null, Number, or String can be deserialized as a root element. */
		ALLOW_JSON_DATA,
		/** Whether a JsonObject can be deserialized as a root element. */
		ALLOW_JSON_OBJECTS;
	}

	/** Flags to tweak the behavior of the primary serialization method. */
	private static enum SerializationOptions{
		/** Instead of aborting serialization on non-JSON values that are Enums it will continue serialization with the
		 * Enums' "${PACKAGE}.${DECLARING_CLASS}.${NAME}".
		 * @see Enum
		 * @deprecated 2.3.0 the enum should implement Jsonable instead. */
		@Deprecated
		ALLOW_FULLY_QUALIFIED_ENUMERATIONS,
		/** Instead of aborting serialization on non-JSON values it will continue serialization by serializing the
		 * non-JSON value directly into the now invalid JSON. Be mindful that invalid JSON will not successfully
		 * deserialize. */
		ALLOW_INVALIDS,
		/** Instead of aborting serialization on non-JSON values that implement Jsonable it will continue serialization
		 * by deferring serialization to the Jsonable.
		 * @see Jsonable */
		ALLOW_JSONABLES,
		/** Instead of aborting serialization on non-JSON values it will continue serialization by using reflection to
		 * best describe the value as a JsonObject.
		 * @deprecated 2.3.0 there is no passive way to accomplish this contract and so will be abandoned. */
		@Deprecated
		ALLOW_UNDEFINEDS;
	}

	/** The possible States of a JSON deserializer. */
	private static enum States{
		/** Post-parsing state. */
		DONE,
		/** Pre-parsing state. */
		INITIAL,
		/** Parsing error, ParsingException should be thrown. */
		PARSED_ERROR,
		PARSING_ARRAY,
		/** Parsing a key-value pair inside of an object. */
		PARSING_ENTRY,
		PARSING_OBJECT;
	}

	private Jsoner(){
		/* Keeping it classy. */
	}

	/** Deserializes a readable stream according to the RFC 4627 JSON specification.
	 * @param readableDeserializable representing content to be deserialized as JSON.
	 * @return either a boolean, null, Number, String, JsonObject, or JsonArray that best represents the deserializable.
	 * @throws DeserializationException if an unexpected token is encountered in the deserializable. To recover from a
	 *         DeserializationException: fix the deserializable
	 *         to no longer have an unexpected token and try again. */
	public static Object deserialize(final Reader readableDeserializable) throws DeserializationException{
		return Jsoner.deserialize(readableDeserializable, EnumSet.of(DeserializationOptions.ALLOW_JSON_ARRAYS, DeserializationOptions.ALLOW_JSON_OBJECTS, DeserializationOptions.ALLOW_JSON_DATA)).get(0);
	}

	/** Deserialize a stream with all deserialized JSON values are wrapped in a JsonArray.
	 * @param deserializable representing content to be deserialized as JSON.
	 * @param flags representing the allowances and restrictions on deserialization.
	 * @return the allowable object best represented by the deserializable.
	 * @throws DeserializationException if a disallowed or unexpected token is encountered in the deserializable. To
	 *         recover from a DeserializationException: fix the
	 *         deserializable to no longer have a disallowed or unexpected token and try again. */
	private static JsonArray deserialize(final Reader deserializable, final Set flags) throws DeserializationException{
		final Yylex lexer = new Yylex(deserializable);
		Yytoken token;
		States currentState;
		int returnCount = 1;
		final LinkedList stateStack = new LinkedList<>();
		final LinkedList