Jackson - Clase JsonParser

Introducción

JsonParser es la clase base para definir la API pública para leer contenido Json. Las instancias se crean utilizando métodos de fábrica de una instancia de JsonFactory.

Declaración de clase

A continuación se muestra la declaración de com.fasterxml.jackson.core.JsonParser clase:

public abstract class JsonParser
   extends Object
      implements Closeable, Versioned

Clases anidadas

SNClase y descripción
1static class JsonParser.Feature
Enumeración que define todas las características alternables para analizadores.
2static class JsonParser.NumberType
Enumeración de posibles tipos "nativos" (óptimos) que se pueden usar para números.

Campos

  • protected int _features - Bandera de bits compuesta por bits que indican qué características de JsonParser.Features están habilitadas.

Constructores

SNConstructor y descripción
1protegido JsonParser ()
constructor predeterminado
2protegido JsonParser (características int)

Métodos de clase

SNMétodo y descripción
1protected JsonParseException _constructError(String msg) - Método auxiliar para construir JsonParseExceptions basado en el estado actual del analizador.
2protected void _reportUnsupportedOperation() - Método auxiliar para llamar a operaciones que no son compatibles con la implementación del analizador.
3boolean canReadObjectId() - Método de introspección al que se puede llamar para ver si el formato de datos subyacente admite algún tipo de ID de objeto de forma nativa (muchos no lo hacen; por ejemplo, JSON no lo hace).
4boolean canReadTypeId() - Método de introspección al que se puede llamar para ver si el formato de datos subyacente admite algún tipo de ID de tipo de forma nativa (muchos no lo hacen; por ejemplo, JSON no lo hace).
5boolean canUseSchema(FormatSchema schema) - Método que se puede usar para verificar que el esquema dado se puede usar con este analizador (usando setSchema (com.fasterxml.jackson.core.FormatSchema)).
6abstract void clearCurrentToken() - Método llamado para "consumir" el token actual eliminándolo de manera efectiva para que hasCurrentToken () devuelva falso y getCurrentToken () nulo).
7abstract void close()- Cierra el analizador para que no se puedan realizar más iteraciones o accesos a datos; también cerrará la fuente de entrada subyacente si el analizador es propietario de la fuente de entrada o si la función JsonParser.Feature.AUTO_CLOSE_SOURCE está habilitada.
8JsonParser configure(JsonParser.Feature f, boolean state) - Método para habilitar o deshabilitar la función especificada (consulte JsonParser.Feature para ver la lista de funciones)
9JsonParser disable(JsonParser.Feature f) - Método para deshabilitar la función especificada (consulte JsonParser.Feature para obtener una lista de funciones)
10JsonParser enable(JsonParser.Feature f) - Método para habilitar la función de analizador especificada (consulte JsonParser.Feature para obtener una lista de funciones)
11abstract BigInteger getBigIntegerValue() - Accesor numérico que se puede llamar cuando el token actual es de tipo JsonToken.VALUE_NUMBER_INT y no se puede usar como un tipo primitivo largo de Java debido a su magnitud.
12byte[] getBinaryValue() - Alternativa conveniente a getBinaryValue (Base64Variant) que por defecto usa Base64Variants.getDefaultVariant () como la codificación predeterminada.
13abstract byte[] getBinaryValue(Base64Variant b64variant) - Método que se puede usar para leer (y consumir; es posible que no se pueda acceder a los resultados usando otros métodos después de la llamada) datos binarios codificados en base64 incluidos en el valor JSON textual actual.
14boolean getBooleanValue() - Accesorio de conveniencia que se puede llamar cuando el token actual es JsonToken.VALUE_TRUE o JsonToken.VALUE_FALSE.
15byte getByteValue() - Accesor numérico que se puede llamar cuando el token actual es de tipo JsonToken.VALUE_NUMBER_INT y se puede expresar como un valor de tipo primitivo de bytes de Java.
dieciséisabstract ObjectCodec getCodec() - Accesor para ObjectCodec asociado con este analizador, si lo hay.
17abstract JsonLocation getCurrentLocation()- Método que devuelve la ubicación del último carácter procesado; generalmente para fines de informes de errores.
18abstract String getCurrentName()- Método que se puede llamar para obtener el nombre asociado con el token actual: para JsonToken.FIELD_NAMEs será el mismo que devuelve getText (); para los valores de campo, será el nombre del campo anterior; y para otros (valores de matriz, valores de nivel de raíz) nulo.
19abstract JsonToken getCurrentToken()- Accesor para encontrar a qué analizador de tokens apunta actualmente, si lo hay; se devolverá null si no hay ninguno.
20abstract int getCurrentTokenId() - Método similar a getCurrentToken () pero que devuelve un int en lugar de JsonToken (valor de enumeración).
21abstract BigDecimal getDecimalValue() - Accesor numérico que se puede llamar cuando el token actual es de tipo JsonToken.VALUE_NUMBER_FLOAT o JsonToken.VALUE_NUMBER_INT.
22abstract double getDoubleValue() - Accesor numérico que se puede llamar cuando el token actual es de tipo JsonToken.VALUE_NUMBER_FLOAT y se puede expresar como un tipo primitivo doble de Java.
23abstract Object getEmbeddedObject() - Accesor que se puede llamar si (y solo si) el token actual es JsonToken.VALUE_EMBEDDED_OBJECT.
24int getFeatureMask() - Método de acceso masivo para obtener el estado de todas las características estándar de JsonParser.
25abstract float getFloatValue() - Accesor numérico que se puede llamar cuando el token actual es de tipo JsonToken.VALUE_NUMBER_FLOAT y se puede expresar como un tipo primitivo flotante de Java.
26Object getInputSource()- Método que se puede utilizar para obtener acceso al objeto que se utiliza para acceder a la entrada que se analiza; esto suele ser InputStream o Reader, según con qué analizador se haya construido.
27abstract int getIntValue() - Accesor numérico que se puede llamar cuando el token actual es de tipo JsonToken.VALUE_NUMBER_INT y se puede expresar como un valor de tipo primitivo Java int.
28abstract JsonToken getLastClearedToken() - Método al que se puede llamar para obtener el último token que se borró usando clearCurrentToken ().
29abstract long getLongValue() - Accesor numérico que se puede llamar cuando el token actual es del tipo JsonToken.VALUE_NUMBER_INT y se puede expresar como un tipo primitivo largo de Java.
30abstract JsonParser.NumberType getNumberType()- Si el token actual es de tipo JsonToken.VALUE_NUMBER_INT o JsonToken.VALUE_NUMBER_FLOAT, devuelve una de las constantes JsonParser.NumberType; de lo contrario, devuelve nulo.
31abstract Number getNumberValue() - Método de acceso de valor numérico genérico que funcionará para todo tipo de valores numéricos.
32Object getObjectId() - Método que se puede llamar para verificar si el token actual (uno que se acaba de leer) tiene un ID de objeto asociado y, de ser así, devolverlo.
33abstract JsonStreamContext getParsingContext() - El método que se puede utilizar para acceder al lector de contexto de análisis actual está en.
34FormatSchema getSchema() - Método para acceder al esquema que utiliza este analizador, si lo hay.
35short getShortValue() - Accesor numérico que se puede llamar cuando el token actual es de tipo JsonToken.VALUE_NUMBER_INT y se puede expresar como un valor de tipo primitivo corto de Java.
36abstract String getText()- Método para acceder a la representación textual del token actual; si no hay un token actual (antes de la primera llamada a nextToken (), o después de encontrar el final de la entrada), devuelve un valor nulo.
37abstract char[] getTextCharacters() - Método similar a getText (), pero que devolverá una matriz de caracteres subyacente (no modificable) que contiene un valor textual, en lugar de construir un objeto String para contener esta información.
38abstract int getTextLength() - Accesor usado con getTextCharacters (), para conocer la longitud de String almacenada en el búfer devuelto.
39abstract int getTextOffset() - Accesor usado con getTextCharacters (), para conocer el desplazamiento del primer carácter de contenido de texto dentro del búfer.
40abstract JsonLocation getTokenLocation()- Método que devuelve la ubicación inicial del token actual; es decir, la posición del primer carácter de la entrada que inicia el token actual.
41Object getTypeId() - Método que se puede llamar para verificar si el token actual (uno que se acaba de leer) tiene un ID de tipo asociado y, de ser así, devolverlo.
42boolean getValueAsBoolean() - Método que intentará convertir el valor del token actual en booleano.
43boolean getValueAsBoolean(boolean defaultValue) - Método que intentará convertir el valor del token actual en booleano.
44double getValueAsDouble() - Método que intentará convertir el valor del token actual en un doble de Java.
45double getValueAsDouble(double defaultValue) - Método que intentará convertir el valor del token actual en un doble de Java.
46int getValueAsInt() - Método que intentará convertir el valor del token actual en un int.
47int getValueAsInt(int defaultValue) - Método que intentará convertir el valor del token actual en un int.
48long getValueAsLong() - Método que intentará convertir el valor del token actual a largo.
49long getValueAsLong(long defaultValue) - Método que intentará convertir el valor del token actual a largo.
50String getValueAsString() - Método que intentará convertir el valor del token actual en una cadena.
51abstract String getValueAsString(String defaultValue) - Método que intentará convertir el valor del token actual en una cadena.
52abstract boolean hasCurrentToken() - Método para verificar si el analizador apunta actualmente a un token (y los datos para ese token están disponibles).
53abstract boolean hasTextCharacters() - Método que se puede usar para determinar si llamar a getTextCharacters () sería la forma más eficiente de acceder al contenido textual para el analizador de eventos al que apunta actualmente.
54abstract boolean isClosed() - Método que se puede llamar para determinar si este analizador está cerrado o no.
55boolean isEnabled(JsonParser.Feature f) - Método para comprobar si el JsonParser.Feature especificado está habilitado.
56boolean isExpectedStartArrayToken() - Accesor especializado que se puede usar para verificar que el token actual indica la matriz de inicio (generalmente significa que el token actual es JsonToken.START_ARRAY) cuando se espera la matriz de inicio.
57Boolean nextBooleanValue()- Método que obtiene el siguiente token (como si estuviera llamando a nextToken ()) y si es JsonToken.VALUE_TRUE o JsonToken.VALUE_FALSE devuelve un valor booleano coincidente; de lo contrario, devuelve nulo.
58boolean nextFieldName(SerializableString str) - Método que obtiene el siguiente token (como si llamara a nextToken ()) y verifica si es JsonToken.FIELD_NAME con el nombre especificado y devuelve el resultado de esa comparación.
59int nextIntValue(int defaultValue)- Método que obtiene el siguiente token (como si estuviera llamando a nextToken ()) y si es JsonToken.VALUE_NUMBER_INT devuelve un valor int de 32 bits; de lo contrario, devuelve el valor predeterminado especificado.Es funcionalmente equivalente a:
60long nextLongValue(long defaultValue)- Método que obtiene el siguiente token (como si estuviera llamando a nextToken ()) y si es JsonToken.VALUE_NUMBER_INT devuelve un valor de 64 bits de longitud; de lo contrario, devuelve el valor predeterminado especificado.Es funcionalmente equivalente a:
61String nextTextValue()- Método que obtiene el siguiente token (como si estuviera llamando a nextToken ()) y si es JsonToken.VALUE_STRING devuelve el valor de cadena contenido; de lo contrario, devuelve nulo.
62abstract JsonToken nextToken() - Método de iteración principal, que hará avanzar el flujo lo suficiente para determinar el tipo de token siguiente, si lo hubiera
63abstract JsonToken nextValue() - Método de iteración que avanzará el flujo lo suficiente como para determinar el tipo del siguiente token que es un tipo de valor (incluidos los marcadores JSON Array y Object start / end).
64abstract void overrideCurrentName(String name) - Método que se puede utilizar para cambiar lo que se considera el nombre (campo) actual.
sesenta y cincoint readBinaryValue(Base64Variant b64variant, OutputStream out) - Similar a readBinaryValue (OutputStream) pero permite especificar explícitamente la variante base64 para usar.
66int readBinaryValue(OutputStream out) - Método que se puede utilizar como alternativa a getBigIntegerValue (), especialmente cuando el valor puede ser grande.
67<T> T readValueAs(Class<T> valueType) - Método para deserializar el contenido JSON en un tipo que no es de contenedor (sin embargo, puede ser un tipo de matriz): normalmente un bean, una matriz o un tipo de envoltura (como booleano).
68<T> T readValueAs(TypeReference<?> valueTypeRef)- Método para deserializar contenido JSON en un tipo Java, referencia al cual se pasa como argumento.
69<T extends TreeNode> T readValueAsTree() - Método para deserializar el contenido JSON en un "modelo de árbol" equivalente, representado por la raíz TreeNode del modelo resultante.
70<T> Iterator<T> readValuesAs(Class<T> valueType) - Método para leer la secuencia de objetos de la secuencia del analizador, todos con el mismo tipo de valor especificado.
71<T> Iterator<T> readValuesAs(TypeReference<?> valueTypeRef)- Método para leer la secuencia de objetos de la secuencia del analizador, todos con el mismo tipo de valor especificado.
72int releaseBuffered(OutputStream out) - Método al que se puede llamar para retroceder cualquier contenido que haya sido leído pero no consumido por el analizador.
73int releaseBuffered(Writer w) - Method that can be called to push back any content that has been read but not consumed by the parser.
74boolean requiresCustomCodec() - Método que se puede llamar para determinar si se necesita un ObjectCodec personalizado para vincular datos analizados usando JsonParser construido por esta fábrica (que normalmente también implica lo mismo para la serialización con JsonGenerator).
75abstract void setCodec(ObjectCodec c) - Setter que permite definir ObjectCodec asociado con este analizador, si lo hay.
76JsonParser setFeatureMask(int mask) - Método de configuración masiva para (re) establecer estados de todos los JsonParser estándar.
77void setSchema(FormatSchema schema) - Método para llamar para hacer que este analizador use el esquema especificado.
78abstract JsonParser skipChildren() - Method that will skip all child tokens of an array or object token that the parser currently points to, iff stream points to JsonToken.START_OBJECT or JsonToken.START_ARRAY.
79abstract Version version() - Accesor para obtener la versión del paquete principal, dada una instancia de analizador.

Métodos heredados

Esta clase hereda métodos de las siguientes clases:

  • java.lang.Object