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.
com.xiaoleilu.hutool.json.JSONArray Maven / Gradle / Ivy
package com.xiaoleilu.hutool.json;
import java.io.IOException;
import java.io.StringWriter;
import java.io.Writer;
import java.util.ArrayList;
import java.util.Collection;
import java.util.Iterator;
import java.util.List;
import java.util.ListIterator;
import com.xiaoleilu.hutool.bean.BeanResolver;
import com.xiaoleilu.hutool.collection.ArrayIterator;
import com.xiaoleilu.hutool.convert.impl.CollectionConverter;
/**
* JSON数组
* ["a", "b", "c", 12]
*
*
* @author looly
*/
public class JSONArray extends JSONGetter implements JSON, List {
/** 默认初始大小 */
private static final int DEFAULT_CAPACITY = 10;
/** 持有原始数据的List */
private final List rawList;
/** 是否忽略空值 */
private boolean ignoreNullValue;
// -------------------------------------------------------------------------------------------------------------------- Constructor start
/**
* 构造(initialCapacity);
this.ignoreNullValue = true;
}
/**
* 构造 list) {
this();
for (Object o : list) {
this.add(o);
}
}
/**
* 构造 list) {
this(list.size());
for (Object o : list) {
this.add(o);
}
}
/**
* 使用 {@link JSONTokener} 做为参数构造
*
* @param x A {@link JSONTokener}
* @throws JSONException If there is a syntax error.
*/
public JSONArray(JSONTokener x) throws JSONException {
this();
init(x);
}
/**
* 从String构造（JSONArray字符串）
*
* @param source JSON数组字符串
* @throws JSONException If there is a syntax error.
*/
public JSONArray(CharSequence source) throws JSONException {
this();
init(source);
}
/**
* 从对象构造，忽略{@code null}的值
* 1. 数组
* 2. {@link Iterable}对象
* 3. JSON数组字符串
*
*
* @param object 数组或集合或JSON数组字符串
* @throws JSONException 非数组或集合
*/
public JSONArray(Object object) throws JSONException {
this(object, true);
}
/**
* 从对象构造
* 1. 数组
* 2. {@link Iterable}对象
* 3. JSON数组字符串
*
*
* @param object 数组或集合或JSON数组字符串
* @param ignoreNullValue 是否忽略空值
* @throws JSONException 非数组或集合
*/
public JSONArray(Object object, boolean ignoreNullValue) throws JSONException {
this();
this.ignoreNullValue = ignoreNullValue;
if (object instanceof CharSequence) {
//JSON字符串
init((CharSequence) object);
}else {
Iterator iter;
if (object.getClass().isArray()) {// 数组
iter = new ArrayIterator<>(object);
}else if (object instanceof Iterator) {// Iterator
iter = ((Iterator) object);
} else if (object instanceof Iterable) {// Iterable
iter = ((Iterable) object).iterator();
} else {
throw new JSONException("JSONArray initial value should be a string or collection or array.");
}
while(iter.hasNext()) {
this.add(iter.next());
}
}
}
// -------------------------------------------------------------------------------------------------------------------- Constructor start
/**
* 值是否为null
*
* @param index 值所在序列
* @return true if the value at the index is null, or if there is no value.
*/
public boolean isNull(int index) {
return JSONNull.NULL.equals(this.getObj(index));
}
/**
* JSONArray转为以separator为分界符的字符串
*
* @param separator 分界符
* @return a string.
* @throws JSONException If the array contains an invalid number.
*/
public String join(String separator) throws JSONException {
int len = this.rawList.size();
StringBuilder sb = new StringBuilder();
for (int i = 0; i < len; i += 1) {
if (i > 0) {
sb.append(separator);
}
sb.append(InternalJSONUtil.valueToString(this.rawList.get(i)));
}
return sb.toString();
}
@Override
public Object get(int index) {
return this.rawList.get(index);
}
@Override
public Object getObj(Integer index, Object defaultValue) {
return (index < 0 || index >= this.size()) ? defaultValue : this.rawList.get(index);
}
@Override
public Object getByExp(String expression) {
return BeanResolver.resolveBean(this, expression);
}
@Override
@SuppressWarnings("unchecked")
public T getByExp(String expression, Class resultType) {
// return Convert.convert(resultType, getByExp(expression));
return (T) InternalJSONUtil.jsonConvert(resultType, getByExp(expression), true);
}
/**
* Append an object value. This increases the array's length by one. iterator() {
return rawList.iterator();
}
@Override
public int size() {
return rawList.size();
}
@Override
public boolean isEmpty() {
return rawList.isEmpty();
}
@Override
public boolean contains(Object o) {
return rawList.contains(o);
}
@Override
public Object[] toArray() {
return rawList.toArray();
}
@Override
public T[] toArray(T[] a) {
return rawList.toArray(a);
}
@Override
public boolean add(Object e) {
return this.rawList.add(JSONUtil.wrap(e, ignoreNullValue));
}
@Override
public Object remove(int index) {
return index >= 0 && index < this.size() ? this.rawList.remove(index) : null;
}
@Override
public boolean remove(Object o) {
return rawList.remove(o);
}
@Override
public boolean containsAll(Collection c) {
return rawList.containsAll(c);
}
@Override
public boolean addAll(Collection c) {
for (Object obj : c) {
this.add(obj);
}
return rawList.addAll(c);
}
@Override
public boolean addAll(int index, Collection c) {
return rawList.addAll(index, c);
}
@Override
public boolean removeAll(Collection c) {
return this.rawList.removeAll(c);
}
@Override
public boolean retainAll(Collection c) {
return this.rawList.retainAll(c);
}
@Override
public void clear() {
this.rawList.clear();
}
@Override
public Object set(int index, Object element) {
return this.rawList.set(index, JSONUtil.wrap(element, this.ignoreNullValue));
}
@Override
public void add(int index, Object element) {
if (index < 0) {
throw new JSONException("JSONArray[" + index + "] not found.");
}
if (index < this.size()) {
InternalJSONUtil.testValidity(element);
this.rawList.set(index, JSONUtil.wrap(element, this.ignoreNullValue));
} else {
while (index != this.size()) {
this.add(JSONNull.NULL);
}
this.put(element);
}
}
@Override
public int indexOf(Object o) {
return this.rawList.indexOf(o);
}
@Override
public int lastIndexOf(Object o) {
return this.rawList.lastIndexOf(o);
}
@Override
public ListIterator listIterator() {
return this.rawList.listIterator();
}
@Override
public ListIterator listIterator(int index) {
return this.rawList.listIterator(index);
}
@Override
public List subList(int fromIndex, int toIndex) {
return this.rawList.subList(fromIndex, toIndex);
}
/**
* 转为Bean数组，转换异常将被抛出
*
* @param clazz 数组元素类型
* @return 实体类对象
*/
public Object toArray(Class clazz) {
return toArray(clazz, false);
}
/**
* 转为Bean数组
*
* @param arrayClass 数组元素类型
* @param ignoreError 是否忽略转换错误
* @return 实体类对象
*/
public Object[] toArray(Class arrayClass, boolean ignoreError) {
return InternalJSONUtil.toArray(this, arrayClass, ignoreError);
}
/**
* 转为{@link ArrayList}
*
* @param 元素类型
* @param elementType 元素类型
* @return {@link ArrayList}
* @since 3.0.8
*/
@SuppressWarnings("unchecked")
public ArrayList toList(Class elementType) {
final CollectionConverter converter = new CollectionConverter(ArrayList.class, elementType);
return (ArrayList) converter.convert(this, null);
}
// ------------------------------------------------------------------------------------------------- Private method start
/**
* 初始化
*
* @param source JSON字符串
*/
private void init(CharSequence source) {
if (null != source) {
init(new JSONTokener(source.toString()));
}
}
/**
* 初始化
*
* @param x {@link JSONTokener}
*/
private void init(JSONTokener x) {
if (x.nextClean() != '[') {
throw x.syntaxError("A JSONArray text must start with '['");
}
if (x.nextClean() != ']') {
x.back();
for (;;) {
if (x.nextClean() == ',') {
x.back();
this.rawList.add(JSONNull.NULL);
} else {
x.back();
this.rawList.add(x.nextValue());
}
switch (x.nextClean()) {
case ',':
if (x.nextClean() == ']') {
return;
}
x.back();
break;
case ']':
return;
default:
throw x.syntaxError("Expected a ',' or ']'");
}
}
}
}
// ------------------------------------------------------------------------------------------------- Private method end
}
