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

com.feilong.lib.json.JSONArray Maven / Gradle / Ivy

Go to download

feilong is a suite of core and expanded libraries that include utility classes, http, excel,cvs, io classes, and much much more.

There is a newer version: 4.0.8
Show newest version
/*
 * Copyright (C) 2008 feilong
 *
 * 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 com.feilong.lib.json;

import java.util.ArrayList;
import java.util.List;

import com.feilong.lib.ezmorph.Morpher;
import com.feilong.lib.ezmorph.object.IdentityObjectMorpher;
import com.feilong.lib.json.util.JSONUtils;

/**
 * A JSONArray is an ordered sequence of values. Its external text form is a
 * string wrapped in square brackets with commas separating the values. The
 * internal form is an object having get and opt
 * methods for accessing the values by index, and element methods
 * for adding or replacing values. The values can be any of these types:
 * Boolean, JSONArray, JSONObject,
 * Number, String, or the
 * JSONNull object.
 * 

 * The constructor can convert a JSON text into a Java object. The
 * toString method converts to JSON text.
 * 

 * A get method returns a value if one can be found, and throws
 * an exception if one cannot be found. An opt method returns a
 * default value instead of throwing an exception, and so is useful for
 * obtaining optional values.
 * 

 * The generic get() and opt() methods return an
 * object which you can cast or query for type. There are also typed
 * get and opt methods that do type checking and
 * type coersion for you.
 * 

 * The texts produced by the toString methods strictly conform to
 * JSON syntax rules. The constructors are more forgiving in the texts they will
 * accept:
 * 
    
 * 
  • An extra , (comma) may appear just
 * before the closing bracket.
    • 
 * 
  • The null value will be inserted when there is
 * , (comma) elision.
    • 
 * 
  • Strings may be quoted with ' (single quote).
    • 
 * 
  • Strings do not need to be quoted at all if they do not begin with a
 * quote or single quote, and if they do not contain leading or trailing spaces,
 * and if they do not contain any of these characters:
 * { } [ ] / \ : , = ; # and if they do not look like numbers and
 * if they are not the reserved words true, false,
 * or null.
    • 
 * 
  • Values can be separated by ; (semicolon)
 * as well as by , (comma).
    • 
 * 
  • Numbers may have the 0- (octal) or
 * 0x- (hex) prefix.
    • 
 * 
  • Comments written in the slashshlash, slashstar, and hash conventions
 * will be ignored.
    • 
 * 

 *
 * @author JSON.org
 */
public final class JSONArray implements JSON{

    /** The Constant serialVersionUID. */
    private static final long serialVersionUID = -1663435868052425703L;

    //---------------------------------------------------------------

    /**
     * The List where the JSONArray's properties are kept.
     */
    final List        elementList;

    /**
     * Construct an empty JSONArray.
     */
    public JSONArray(){
        this.elementList = new ArrayList<>();
    }

    //---------------------------------------------------------------

    /**
     * Append an JSON value. This increases the array's length by one.
     *
     * @param value
     *            An JSON value.
     * @return this.
     */
    JSONArray addValue(JSONObject value){
        this.elementList.add(value);
        return this;
    }

    /**
     * Append an object value. This increases the array's length by one.
     *
     * @param value
     *            An object value. The value should be a Boolean, Double,
     *            Integer, JSONArray, JSONObject, JSONFunction, Long, String,
     *            JSONString or the JSONNull object.
     * @return this.
     */
    JSONArray addValue(Object value){
        return addValue(value, new JsonConfig());
    }

    //---------------------------------------------------------------

    /**
     * Get the object value associated with an index.
     *
     * @param index
     *            The index must be between 0 and size() - 1.
     * @return An object value.
     */
    public Object get(int index){
        return this.elementList.get(index);
    }

    /**
     * Get the JSONObject associated with an index.
     *
     * @param index
     *            subscript
     * @return A JSONObject value.
     * @throws JSONException
     *             If there is no value for the index or if the value
     *             is not a JSONObject
     */
    public JSONObject getJSONObject(int index){
        Object o = get(index);
        if (JSONNull.getInstance().equals(o)){
            return new JSONObject(true);
        }
        if (o instanceof JSONObject){
            return (JSONObject) o;
        }
        throw new JSONException("JSONArray[" + index + "] is not a JSONObject.");
    }

    /**
     * Checks if is empty.
     *
     * @return true, if is empty
     */
    public boolean isEmpty(){
        return this.elementList.isEmpty();
    }

    /**
     * Get the number of elements in the JSONArray, included nulls.
     *
     * @return The length (or size).
     */
    @Override
    public int size(){
        return this.elementList.size();
    }

    /**
     * Make a JSON text of this JSONArray. For compactness, no unnecessary
     * whitespace is added. If it is not possible to produce a syntactically
     * correct JSON text then null will be returned instead. This could occur if
     * the array contains an invalid number.
     * 

     * Warning: This method assumes that the data structure is acyclical.
     *
     * @return a printable, displayable, transmittable representation of the
     *         array.
     */
    @Override
    public String toString(){
        return ToStringUtil.toString(this.elementList);
    }

    /**
     * Make a prettyprinted JSON text of this JSONArray. Warning: This method
     * assumes that the data structure is acyclical.
     *
     * @param indentFactor
     *            The number of spaces to add to each level of
     *            indentation.
     * @param indent
     *            The indention of the top level.
     * @return a printable, displayable, transmittable representation of the
     *         array.
     * @throws JSONException
     *             the JSON exception
     */
    @Override
    public String toString(int indentFactor,int indent){
        int len = size();
        if (len == 0){
            return "[]";
        }
        if (indentFactor == 0){
            return this.toString();
        }

        return ToStringUtil.toString(this.elementList, indentFactor, indent);
    }

    //---------------------------------------------------------------

    /**
     * Adds a String without performing any conversion on it.
     *
     * @param str
     *            the str
     * @return the JSON array
     */
    protected JSONArray addString(String str){
        if (str != null){
            elementList.add(str);
        }
        return this;
    }

    //---------------------------------------------------------------

    /**
     * Append an object value. This increases the array's length by one.
     *
     * @param value
     *            An object value. The value should be a Boolean, Double,
     *            Integer, JSONArray, JSONObject, JSONFunction, Long, String,
     *            JSONString or the JSONNull object.
     * @param jsonConfig
     *            the json config
     * @return this.
     */
    JSONArray addValue(Object value,JsonConfig jsonConfig){
        this.elementList.add(ProcessValueUtil.processArrayValue(value, jsonConfig));
        return this;
    }

    //---------------------------------------------------------------

    /**
     * Hash code.
     *
     * @return the int
     */
    @Override
    public int hashCode(){
        int hashcode = 29;

        for (Object element : elementList){
            hashcode += JSONUtils.hashCode(element);
        }
        return hashcode;
    }

    /**
     * Equals.
     *
     * @param obj
     *            the obj
     * @return true, if successful
     * @deprecated 看看能不能删掉
     */
    @Deprecated
    @Override
    public boolean equals(Object obj){
        if (obj == this){
            return true;
        }
        if (obj == null){
            return false;
        }

        if (!(obj instanceof JSONArray)){
            return false;
        }

        //---------------------------------------------------------------
        JSONArray other = (JSONArray) obj;
        if (other.size() != size()){
            return false;
        }
        int max = size();
        for (int i = 0; i < max; i++){
            Object o1 = get(i);
            Object o2 = other.get(i);

            // handle nulls
            if (JSONNull.getInstance().equals(o1)){
                if (JSONNull.getInstance().equals(o2)){
                    continue;
                }
                return false;
            }
            if (JSONNull.getInstance().equals(o2)){
                return false;
            }

            if (o1 instanceof JSONArray && o2 instanceof JSONArray){
                JSONArray e = (JSONArray) o1;
                JSONArray a = (JSONArray) o2;
                if (!a.equals(e)){
                    return false;
                }
            }else{
                if (o1 instanceof JSONObject && o2 instanceof JSONObject){
                    if (!o1.equals(o2)){
                        return false;
                    }
                }else if (o1 instanceof JSONArray && o2 instanceof JSONArray){
                    if (!o1.equals(o2)){
                        return false;
                    }
                }else{
                    if (o1 instanceof String){
                        if (!o1.equals(String.valueOf(o2))){
                            return false;
                        }
                    }else if (o2 instanceof String){
                        if (!o2.equals(String.valueOf(o1))){
                            return false;
                        }
                    }else{
                        Morpher m1 = JSONUtils.getMorpherRegistry().getMorpherFor(o1.getClass());
                        Morpher m2 = JSONUtils.getMorpherRegistry().getMorpherFor(o2.getClass());
                        if (m1 != null && m1 != IdentityObjectMorpher.INSTANCE){
                            if (!o1.equals(JSONUtils.getMorpherRegistry().morph(o1.getClass(), o2))){
                                return false;
                            }
                        }else if (m2 != null && m2 != IdentityObjectMorpher.INSTANCE){
                            if (!JSONUtils.getMorpherRegistry().morph(o1.getClass(), o1).equals(o2)){
                                return false;
                            }
                        }else{
                            if (!o1.equals(o2)){
                                return false;
                            }
                        }
                    }
                }
            }
        }
        return true;
    }

}
 















© 2015 - 2024 Weber Informatics LLC | Privacy Policy