abk.json
Class AJsonString

java.lang.Object
  abk.json.AJsonElement
      abk.json.AJsonString

public final class AJsonString
extends AJsonElement

Implementa la conversión de un String a JSON.

Field Summary

private String

iValor Valor de la cadena de texto.

Fields inherited from class abk.json.AJsonElement

DOT, FALSE, NULL, SEP, TRUE, UNDEFINED

Constructor Summary

private

AJsonString(String valor) Constructor a partir de un String.

Method Summary

private static StringBuilder	encode(CharSequence valor) Si no es nula, codifica la cadena siguiendo la especificación JSON descrita en el RFC.
String	getString() Devuelve el contenido de la instancia.
void	stringify(Appendable sb) Se invoca para que escriba el objeto en el stream que se le pasa.
private static void	toUnicode16(Appendable sb, int ch) Codifica una carácter como una cadena "\\u0000" y lo incorpora al Appendable que se le pasa.
static AJsonString	valueOf(char ch) Crea un objeto AJsonString que contiene un único carácter.
static AJsonString	valueOf(CharSequence valor) Crea un objeto a partir de un CharSequence.
static AJsonString	valueOf(Date fecha) Convierte un objeto Date a formato JSON.
static AJsonString	valueOf(Enum<?> e) Crea un objeto JsonString a partir de una constante enumerada, utilizando el nombre de dicha constante.

Methods inherited from class abk.json.AJsonElement

byteValue, doubleValue, floatValue, getBasePath, getBoolean, getMapRef, getNumber, 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

Field Detail

iValor

private String iValor

Valor de la cadena de texto.

Constructor Detail

AJsonString

private AJsonString(String valor)

Constructor a partir de un String.

Parameters:

valor - Valor del objeto.

Method Detail

valueOf

public static final AJsonString valueOf(CharSequence valor)

Crea un objeto a partir de un CharSequence.

Parameters:

valor - Valor del objeto.

Returns:

La instancia creada.

Throws:

NullPointerException - si valor es nulo.

valueOf

public static final AJsonString valueOf(char ch)

Crea un objeto AJsonString que contiene un único carácter.

Parameters:

ch - Carácter a representar.

Returns:

Instancia creada.

valueOf

public static final AJsonString valueOf(Enum<?> e)

Crea un objeto JsonString a partir de una constante enumerada, utilizando el nombre de dicha constante.

Parameters:

e - Constante enumerada.

Returns:

Instancia creada.

Throws:

NullPointerException - si e es nulo.

valueOf

public static final AJsonString valueOf(Date fecha)

Convierte un objeto Date a formato JSON. La conversión se realiza expresando la fecha en formato ISO para la zona horaria UTC.

Parameters:

fecha - Objeto a convertir.

See Also:

Dates.toISOString(Date)

getString

public String getString()

Devuelve el contenido de la instancia. A diferencia de AJsonElement.toString(), esta método devuelve el valor del objeto, si no su representación como JSON.

Overrides:

getString in class AJsonElement

Returns:

Contenido de la instancia.

See Also:

getString()

encode

private static final StringBuilder encode(CharSequence valor)
                                   throws IOException

Si no es nula, codifica la cadena siguiendo la especificación JSON descrita en el RFC.

En JSON una cadena es una secuencia de caracteres donde cada caracter puede ser:

any-Unicode-character- except-"-or-\-or- control-character \" \\ \/ \b \f \n \r \t \u four-hex-digits

Las expresiones regulares en Java contemplan estos caracteres especiales:

• \t The tab character ('\\u0009').
• \n The newline (line feed) character ('\\u000A').
• \r The carriage-return character ('\\u000D').
• \f The form-feed character ('\\u000C').
• \a The alert (bell) character ('\\u0007').
• \e The escape character ('\\u001B').

Parameters:

valor - Cadena a codificar.

Returns:

Cadena codificada.

Throws:

IOException - si se produce algún error en el escapado de la cadena de texto.

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.

toUnicode16

private static final void toUnicode16(Appendable sb,
                                      int ch)
                               throws IOException

Codifica una carácter como una cadena "\\u0000" y lo incorpora al Appendable que se le pasa.

Parameters:

sb - Instancia Appendable donde se añade el carácter codificado

ch - Carácter a codificar.

Throws:

IOException