All Downloads are FREE. Search and download functionalities are using the official Maven repository.

com.github.jlangch.venice.nanojson.JsonArray Maven / Gradle / Ivy

There is a newer version: 1.12.34
Show newest version
/*
 * Copyright 2011 The nanojson Authors
 *
 * 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.
 */

/*
 * Modified by Venice 12.05.2019
 *  - changed package to com.github.jlangch.venice.nanojson
 */
package com.github.jlangch.venice.nanojson;

import java.util.ArrayList;
import java.util.Arrays;
import java.util.Collection;

/**
 * Extends an {@link ArrayList} with helper methods to determine the underlying JSON type of the list element.
 */
public class JsonArray extends ArrayList {
    private static final long serialVersionUID = 1L;

    /**
     * Creates an empty {@link JsonArray} with the default capacity.
     */
    public JsonArray() {
    }

    /**
     * Creates an empty {@link JsonArray} with the default initial capacity.
     */
    public JsonArray(int initialCapacity) {
        super(initialCapacity);
    }

    /**
     * Creates an empty {@link JsonArray} from the given collection of objects.
     */
    public JsonArray(Collection collection) {
        super(collection);
    }

    /**
     * Creates a {@link JsonArray} from an array of contents.
     */
    public static JsonArray from(Object... contents) {
        return new JsonArray(Arrays.asList(contents));
    }

    /**
     * Creates a {@link JsonBuilder} for a {@link JsonArray}.
     */
    public static JsonBuilder builder() {
        return new JsonBuilder<>(new JsonArray());
    }

    /**
     * Returns the underlying object at the given index, or null if it does not exist.
     */
    @Override
    public Object get(int key) {
        return key < size() ? super.get(key) : null;
    }

    /**
     * Returns the {@link JsonArray} at the given index, or null if it does not exist or is the wrong type.
     */
    public JsonArray getArray(int key) {
        return getArray(key, null);
    }

    /**
     * Returns the {@link JsonArray} at the given index, or the default if it does not exist or is the wrong type.
     */
    public JsonArray getArray(int key, JsonArray default_) {
        Object o = get(key);
        if (o instanceof JsonArray)
            return (JsonArray) o;
        return default_;
    }

    /**
     * Returns the {@link Boolean} at the given index, or false if it does not exist or is the wrong type.
     */
    public boolean getBoolean(int key) {
        return getBoolean(key, false);
    }

    /**
     * Returns the {@link Boolean} at the given index, or the default if it does not exist or is the wrong type.
     */
    public boolean getBoolean(int key, Boolean default_) {
        Object o = get(key);
        if (o instanceof Boolean)
            return (Boolean) o;
        return default_;
    }

    /**
     * Returns the {@link Double} at the given index, or 0.0 if it does not exist or is the wrong type.
     */
    public double getDouble(int key) {
        return getDouble(key, 0);
    }

    /**
     * Returns the {@link Double} at the given index, or the default if it does not exist or is the wrong type.
     */
    public double getDouble(int key, double default_) {
        Object o = get(key);
        if (o instanceof Number)
            return ((Number)o).doubleValue();
        return default_;
    }

    /**
     * Returns the {@link Float} at the given index, or 0.0f if it does not exist or is the wrong type.
     */
    public float getFloat(int key) {
        return getFloat(key, 0);
    }

    /**
     * Returns the {@link Float} at the given index, or the default if it does not exist or is the wrong type.
     */
    public float getFloat(int key, float default_) {
        Object o = get(key);
        if (o instanceof Number)
            return ((Number)o).floatValue();
        return default_;
    }

    /**
     * Returns the {@link Integer} at the given index, or 0 if it does not exist or is the wrong type.
     */
    public int getInt(int key) {
        return getInt(key, 0);
    }

    /**
     * Returns the {@link Integer} at the given index, or the default if it does not exist or is the wrong type.
     */
    public int getInt(int key, int default_) {
        Object o = get(key);
        if (o instanceof Number)
            return ((Number)o).intValue();
        return default_;
    }

    /**
     * Returns the {@link Long} at the given index, or 0 if it does not exist or is the wrong type.
     */
    public long getLong(int key) {
        return getLong(key, 0);
    }

    /**
     * Returns the {@link Long} at the given index, or the default if it does not exist or is the wrong type.
     */
    public long getLong(int key, long default_) {
        Object o = get(key);
        if (o instanceof Number)
            return ((Number)o).longValue();
        return default_;
    }

    /**
     * Returns the {@link Number} at the given index, or null if it does not exist or is the wrong type.
     */
    public Number getNumber(int key) {
        return getNumber(key, null);
    }

    /**
     * Returns the {@link Number} at the given index, or the default if it does not exist or is the wrong type.
     */
    public Number getNumber(int key, Number default_) {
        Object o = get(key);
        if (o instanceof Number)
            return (Number)o;
        return default_;
    }

    /**
     * Returns the {@link JsonObject} at the given index, or null if it does not exist or is the wrong type.
     */
    public JsonObject getObject(int key) {
        return getObject(key, null);
    }

    /**
     * Returns the {@link JsonObject} at the given index, or the default if it does not exist or is the wrong type.
     */
    public JsonObject getObject(int key, JsonObject default_) {
        Object o = get(key);
        if (o instanceof JsonObject)
            return (JsonObject) o;
        return default_;
    }

    /**
     * Returns the {@link String} at the given index, or null if it does not exist or is the wrong type.
     */
    public String getString(int key) {
        return getString(key, null);
    }

    /**
     * Returns the {@link String} at the given index, or the default if it does not exist or is the wrong type.
     */
    public String getString(int key, String default_) {
        Object o = get(key);
        if (o instanceof String)
            return (String) o;
        return default_;
    }

    /**
     * Returns true if the array has an element at that index (even if that element is null).
     */
    public boolean has(int key) {
        return key < size();
    }

    /**
     * Returns true if the array has a boolean element at that index.
     */
    public boolean isBoolean(int key) {
        return get(key) instanceof Boolean;
    }

    /**
     * Returns true if the array has a null element at that index.
     */
    public boolean isNull(int key) {
        return key < size() && get(key) == null;
    }

    /**
     * Returns true if the array has a number element at that index.
     */
    public boolean isNumber(int key) {
        return get(key) instanceof Number;
    }

    /**
     * Returns true if the array has a string element at that index.
     */
    public boolean isString(int key) {
        return get(key) instanceof String;
    }
}