/*
 * Copyright 2011, 2012 Odysseus Software GmbH
 *
 * 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.apache.synapse.commons.staxon.core.json.stream;

import java.io.Closeable;
import java.io.IOException;

import javax.xml.stream.Location;

/**
 * JSON stream source.
 */
public interface JsonStreamSource extends Closeable, Location {
    /**
     * Represents a simple value.
     */
    public static class Value {
        public final String text;
        public final Object data;

        private Value(String text, Object data) {
            this.text = text;
            this.data = data;
        }

        /**
         * Create number value
         *
         * @param text
         * @param number
         */
        public Value(String text, Number number) {
            this(text, (Object) number);
        }

        /**
         * Create string value
         *
         * @param text
         */
        public Value(String text) {
            this(text, text);
        }

        @Override
        public String toString() {
            return text == null ? "null" : text;
        }
    }

    /**
     * "true" value
     */
    public static final Value TRUE = new Value("true", Boolean.TRUE);

    /**
     * "false" value
     */
    public static final Value FALSE = new Value("false", Boolean.FALSE);

    /**
     * "null" value
     */
    public static final Value NULL = new Value(null, null);

    /**
     * Consume {@link JsonStreamToken#NAME} token.
     *
     * @return name
     * @throws IOException
     */
    public String name() throws IOException;

    /**
     * Consume {@link JsonStreamToken#VALUE} token.
     *
     * @return value
     * @throws IOException
     */
    public Value value() throws IOException;

    /**
     * Consume {@link JsonStreamToken#START_OBJECT} token.
     *
     * @throws IOException
     */
    public void startObject() throws IOException;

    /**
     * Consume {@link JsonStreamToken#END_OBJECT} token.
     *
     * @throws IOException
     */
    public void endObject() throws IOException;

    /**
     * Consume {@link JsonStreamToken#START_ARRAY} token.
     *
     * @throws IOException
     */
    public void startArray() throws IOException;

    /**
     * Consume {@link JsonStreamToken#END_ARRAY} token.
     *
     * @throws IOException
     */
    public void endArray() throws IOException;

    /**
     * Peek next token.
     *
     * @return token
     * @throws IOException
     */
    public JsonStreamToken peek() throws IOException;
}