• Home
• com.github.cliftonlabs
• json-simple
• 2.1.2
• 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