• Home
• com.github.cliftonlabs
• json-simple
• 2.0.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 a 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 */
        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. */
        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.
     * @throws IOException if the underlying reader encounters an I/O error. Ensure the reader is properly instantiated,
     *         isn't closed, or that it is ready before trying again. */
    public static Object deserialize(final Reader readableDeserializable) throws DeserializationException, IOException{
        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.
     * @throws IOException if the underlying reader encounters an I/O error. Ensure the reader is properly instantiated,
     *         isn't closed, or that it is ready before trying again. */
    private static JsonArray deserialize(final Reader deserializable, final Set flags) throws DeserializationException, IOException{
        final Yylex lexer = new Yylex(deserializable);
        Yytoken token;
        States currentState;
        int returnCount = 1;
        final LinkedList stateStack = new LinkedList();
        final LinkedList