abk.json
Class AJsonArray

java.lang.Object
  abk.json.AJsonElement
      abk.json.AJsonArray

All Implemented Interfaces:

Iterable<AJsonElement>, Collection<AJsonElement>, List<AJsonElement>

public class AJsonArray
extends AJsonElement
implements List<AJsonElement>

Implementa la operación de creación de la representación de un Array como objeto JSON.

Field Summary

(package private) static char	ENDS Carácter de cierre de un array: (]).
private List<AJsonElement>	iItems Lista con todos los objetos del array.
(package private) static char	STARTS Carácter de inicio de un array: ([).

Fields inherited from class abk.json.AJsonElement

DOT, FALSE, NULL, SEP, TRUE, UNDEFINED

Constructor Summary

	AJsonArray() Constructor por defecto, crea un AJsonArray vacío.
private	AJsonArray(List<AJsonElement> items)

Method Summary

boolean	add(AJsonElement je) Añade un nuevo elemento JSON al final del array.
void	add(int index, AJsonElement element)
boolean	addAll(Collection<? extends AJsonElement> c)
boolean	addAll(int index, Collection<? extends AJsonElement> c)
void	addProperty(int index, boolean value)
void	addProperty(int index, Boolean value)
void	addProperty(int index, byte value)
void	addProperty(int index, CharSequence value)
void	addProperty(int index, double value)
void	addProperty(int index, float value)
void	addProperty(int index, int value)
void	addProperty(int index, long value)
void	addProperty(int index, Number value)
void	addProperty(int index, short value)
void	clear()
boolean	contains(Object o)
boolean	containsAll(Collection<?> c)
AJsonElement	get(int k) Devuelve el elemento JSON en la k-ésima posición.
AJsonArray	getArray(int k) Devuelve el elemento en la posición k-ésima como un AJsonArray.
AJsonBean	getBean(int k) Devuelve el elemento en la posición k-ésima como un AJsonBean.
boolean	getBoolean(int index)
byte	getByte(int index)
double	getDouble(int index)
float	getFloat(int index)
int	getInt(int index)
long	getLong(int index)
Number	getNumber(int index)
short	getShort(int index)
String	getString(int index)
int	indexOf(Object o)
boolean	isEmpty()
Iterator<AJsonElement>	iterator() Devuelve un iterador para recorrer el vector de AJsonElement que contiene.
(package private) static AJsonArray	jsonifyAll(Iterable<?> all, Map<Object,String> map, CharSequence owner) Crea un objeto JsonArray a partir de un objeto iterable, que forma parte de otro objeto que está serializando a JSON.
int	lastIndexOf(Object o)
ListIterator<AJsonElement>	listIterator()
ListIterator<AJsonElement>	listIterator(int index)
AJsonElement	remove(int index)
boolean	remove(Object o)
boolean	removeAll(Collection<?> c)
boolean	retainAll(Collection<?> c)
AJsonElement	set(int index, AJsonElement je)
int	size() Devuelve la cantidad de elementos que contiene el array.
void	stringify(Appendable sb) Se invoca para que escriba el objeto en el stream que se le pasa.
AJsonArray	subList(int fromIndex, int toIndex)
Object[]	toArray()
<T> T[]	toArray(T[] a)
static AJsonArray	valueOf(Iterable<?> all) Crea un objeto JsonArray a partir de un objeto iterable.
static AJsonArray	valueOf(Object... objs) Crea un objeto JsonArray a partir de un objeto iterable.

Methods inherited from class abk.json.AJsonElement

byteValue, doubleValue, floatValue, getBasePath, getBoolean, getMapRef, getNumber, getString, intValue, isFalse, isMappeable, isNull, isTrue, jsonify, jsonifySimple, longValue, shortValue, stringify, stringify, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.List

equals, hashCode

Field Detail

STARTS

static final char STARTS

Carácter de inicio de un array: ([).

See Also:

Constant Field Values

ENDS

static final char ENDS

Carácter de cierre de un array: (]).

See Also:

Constant Field Values

iItems

private List<AJsonElement> iItems

Lista con todos los objetos del array.

Constructor Detail

AJsonArray

public AJsonArray()

Constructor por defecto, crea un AJsonArray vacío.

AJsonArray

private AJsonArray(List<AJsonElement> items)

Method Detail

stringify

public void stringify(Appendable sb)
               throws IOException

Description copied from class: AJsonElement

Se invoca para que escriba el objeto en el stream que se le pasa. Se debe sobrecargar por las clases descendientes.

Specified by:

stringify in class AJsonElement

Parameters:

sb - Objeto sobre el que se escribe el texto.

Throws:

IOException - si se produce un error de la capa de transporte.

valueOf

public static final AJsonArray valueOf(Iterable<?> all)

Crea un objeto JsonArray a partir de un objeto iterable.

Parameters:

all - Objeto iterable.

Returns:

Resultado de la conversión de objs a JSON.

Throws:

NullPointerException - si all es null.

IllegalArgumentException - si algún número del iterable no es válido conforme se indica en AJsonNumber.valueOf(Number).

valueOf

public static final AJsonArray valueOf(Object... objs)

Crea un objeto JsonArray a partir de un objeto iterable.

Parameters:

objs - Array o lista de argumentos.

Returns:

Resultado de la conversión de objs a JSON.

Throws:

NullPointerException - si objs es null.

IllegalArgumentException - si algún número del iterable no es válido conforme se indica en AJsonNumber.valueOf(Number).

jsonifyAll

static final AJsonArray jsonifyAll(Iterable<?> all,
                                   Map<Object,String> map,
                                   CharSequence owner)

Crea un objeto JsonArray a partir de un objeto iterable, que forma parte de otro objeto que está serializando a JSON.

Parameters:

all - Objeto iterable.

map - Mapa con los objetos Java Bean parseados en el misma llamada pública al API, para detectar propiedades autoreferentes.

owner - Nombre de la propiedad que contiene al iterable. En caso de objetos dentro de objetos, se considera el nombre completo, formando una ruta separada por puntos (.).

Returns:

Resultado de la conversión de all a JSON.

Throws:

NullPointerException - si all o map son nulos.

IllegalArgumentException - si algún número del iterable no es válido conforme se indica en AJsonNumber.valueOf(Number).

size

public int size()

Devuelve la cantidad de elementos que contiene el array.

Specified by:

size in interface Collection<AJsonElement>

Specified by:

size in interface List<AJsonElement>

Returns:

Cantidad de elementos del array.

add

public boolean add(AJsonElement je)

Añade un nuevo elemento JSON al final del array.

Specified by:

add in interface Collection<AJsonElement>

Specified by:

add in interface List<AJsonElement>

Parameters:

je - Elemento a añadir.

Throws:

NullArgumentException - si je es nulo.

get

public AJsonElement get(int k)

Devuelve el elemento JSON en la k-ésima posición.

Specified by:

get in interface List<AJsonElement>

Parameters:

k - Posición dentro del array, desde cero, del elemento que se pide.

Returns:

Elemento en la k-ésima posición.

Throws:

IndexOutOfBoundsException - si k es menor que cero o mayor o igual que la longitud del array.

iterator

public Iterator<AJsonElement> iterator()

Devuelve un iterador para recorrer el vector de AJsonElement que contiene.

Specified by:

iterator in interface Iterable<AJsonElement>

Specified by:

iterator in interface Collection<AJsonElement>

Specified by:

iterator in interface List<AJsonElement>

isEmpty

public boolean isEmpty()

Specified by:

isEmpty in interface Collection<AJsonElement>

Specified by:

isEmpty in interface List<AJsonElement>

contains

public boolean contains(Object o)

Specified by:

contains in interface Collection<AJsonElement>

Specified by:

contains in interface List<AJsonElement>

toArray

public Object[] toArray()

Specified by:

toArray in interface Collection<AJsonElement>

Specified by:

toArray in interface List<AJsonElement>

toArray

public <T> T[] toArray(T[] a)

Specified by:

toArray in interface Collection<AJsonElement>

Specified by:

toArray in interface List<AJsonElement>

remove

public boolean remove(Object o)

Specified by:

remove in interface Collection<AJsonElement>

Specified by:

remove in interface List<AJsonElement>

containsAll

public boolean containsAll(Collection<?> c)

Specified by:

containsAll in interface Collection<AJsonElement>

Specified by:

containsAll in interface List<AJsonElement>

addAll

public boolean addAll(Collection<? extends AJsonElement> c)

Specified by:

addAll in interface Collection<AJsonElement>

Specified by:

addAll in interface List<AJsonElement>

addAll

public boolean addAll(int index,
                      Collection<? extends AJsonElement> c)

Specified by:

addAll in interface List<AJsonElement>

removeAll

public boolean removeAll(Collection<?> c)

Specified by:

removeAll in interface Collection<AJsonElement>

Specified by:

removeAll in interface List<AJsonElement>

retainAll

public boolean retainAll(Collection<?> c)

Specified by:

retainAll in interface Collection<AJsonElement>

Specified by:

retainAll in interface List<AJsonElement>

clear

public void clear()

Specified by:

clear in interface Collection<AJsonElement>

Specified by:

clear in interface List<AJsonElement>

set

public AJsonElement set(int index,
                        AJsonElement je)

Specified by:

set in interface List<AJsonElement>

add

public void add(int index,
                AJsonElement element)

Specified by:

add in interface List<AJsonElement>

remove

public AJsonElement remove(int index)

Specified by:

remove in interface List<AJsonElement>

indexOf

public int indexOf(Object o)

Specified by:

indexOf in interface List<AJsonElement>

lastIndexOf

public int lastIndexOf(Object o)

Specified by:

lastIndexOf in interface List<AJsonElement>

listIterator

public ListIterator<AJsonElement> listIterator()

Specified by:

listIterator in interface List<AJsonElement>

listIterator

public ListIterator<AJsonElement> listIterator(int index)

Specified by:

listIterator in interface List<AJsonElement>

subList

public AJsonArray subList(int fromIndex,
                          int toIndex)

Specified by:

subList in interface List<AJsonElement>

getBean

public AJsonBean getBean(int k)

Devuelve el elemento en la posición k-ésima como un AJsonBean.

Parameters:

k - Posición dentro del array, desde cero, del elemento que se pide.

Returns:

Objeto en esa posición si es de tipo AJsonBean.

Throws:

IndexOutOfBoundsException - si k es menor que cero o mayor o igual que la longitud del array.

ClassCastException - si el elemento en esa posición no es un AJsonBean.

getArray

public AJsonArray getArray(int k)

Devuelve el elemento en la posición k-ésima como un AJsonArray.

Parameters:

k - Posición dentro del array, desde cero, del elemento que se pide.

Returns:

Objeto en esa posición si es de tipo AJsonArray.

Throws:

IndexOutOfBoundsException - si k es menor que cero o mayor o igual que la longitud del array.

ClassCastException - si el elemento en esa posición no es un AJsonArray.

addProperty

public void addProperty(int index,
                        CharSequence value)

getString

public String getString(int index)

addProperty

public void addProperty(int index,
                        Boolean value)

addProperty

public void addProperty(int index,
                        boolean value)

getBoolean

public boolean getBoolean(int index)

addProperty

public void addProperty(int index,
                        Number value)

getNumber

public Number getNumber(int index)

addProperty

public void addProperty(int index,
                        int value)

getInt

public int getInt(int index)

addProperty

public void addProperty(int index,
                        short value)

getShort

public short getShort(int index)

addProperty

public void addProperty(int index,
                        long value)

getLong

public long getLong(int index)

addProperty

public void addProperty(int index,
                        byte value)

getByte

public byte getByte(int index)

addProperty

public void addProperty(int index,
                        double value)

getDouble

public double getDouble(int index)

addProperty

public void addProperty(int index,
                        float value)

getFloat

public float getFloat(int index)