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
SN | Clase y descripción |
---|---|
1 | static class JsonParser.Feature Enumeración que define todas las características alternables para analizadores. |
2 | static 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
SN | Constructor y descripción |
---|---|
1 | protegido JsonParser () constructor predeterminado |
2 | protegido JsonParser (características int) |
Métodos de clase
SN | Método y descripción |
---|---|
1 | protected JsonParseException _constructError(String msg) - Método auxiliar para construir JsonParseExceptions basado en el estado actual del analizador. |
2 | protected void _reportUnsupportedOperation() - Método auxiliar para llamar a operaciones que no son compatibles con la implementación del analizador. |
3 | boolean 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). |
4 | boolean 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). |
5 | boolean 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)). |
6 | abstract void clearCurrentToken() - Método llamado para "consumir" el token actual eliminándolo de manera efectiva para que hasCurrentToken () devuelva falso y getCurrentToken () nulo). |
7 | abstract 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. |
8 | JsonParser 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) |
9 | JsonParser disable(JsonParser.Feature f) - Método para deshabilitar la función especificada (consulte JsonParser.Feature para obtener una lista de funciones) |
10 | JsonParser enable(JsonParser.Feature f) - Método para habilitar la función de analizador especificada (consulte JsonParser.Feature para obtener una lista de funciones) |
11 | abstract 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. |
12 | byte[] getBinaryValue() - Alternativa conveniente a getBinaryValue (Base64Variant) que por defecto usa Base64Variants.getDefaultVariant () como la codificación predeterminada. |
13 | abstract 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. |
14 | boolean getBooleanValue() - Accesorio de conveniencia que se puede llamar cuando el token actual es JsonToken.VALUE_TRUE o JsonToken.VALUE_FALSE. |
15 | byte 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éis | abstract ObjectCodec getCodec() - Accesor para ObjectCodec asociado con este analizador, si lo hay. |
17 | abstract JsonLocation getCurrentLocation()- Método que devuelve la ubicación del último carácter procesado; generalmente para fines de informes de errores. |
18 | abstract 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. |
19 | abstract JsonToken getCurrentToken()- Accesor para encontrar a qué analizador de tokens apunta actualmente, si lo hay; se devolverá null si no hay ninguno. |
20 | abstract int getCurrentTokenId() - Método similar a getCurrentToken () pero que devuelve un int en lugar de JsonToken (valor de enumeración). |
21 | abstract 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. |
22 | abstract 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. |
23 | abstract Object getEmbeddedObject() - Accesor que se puede llamar si (y solo si) el token actual es JsonToken.VALUE_EMBEDDED_OBJECT. |
24 | int getFeatureMask() - Método de acceso masivo para obtener el estado de todas las características estándar de JsonParser. |
25 | abstract 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. |
26 | Object 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. |
27 | abstract 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. |
28 | abstract JsonToken getLastClearedToken() - Método al que se puede llamar para obtener el último token que se borró usando clearCurrentToken (). |
29 | abstract 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. |
30 | abstract 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. |
31 | abstract Number getNumberValue() - Método de acceso de valor numérico genérico que funcionará para todo tipo de valores numéricos. |
32 | Object 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. |
33 | abstract JsonStreamContext getParsingContext() - El método que se puede utilizar para acceder al lector de contexto de análisis actual está en. |
34 | FormatSchema getSchema() - Método para acceder al esquema que utiliza este analizador, si lo hay. |
35 | short 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. |
36 | abstract 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. |
37 | abstract 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. |
38 | abstract int getTextLength() - Accesor usado con getTextCharacters (), para conocer la longitud de String almacenada en el búfer devuelto. |
39 | abstract int getTextOffset() - Accesor usado con getTextCharacters (), para conocer el desplazamiento del primer carácter de contenido de texto dentro del búfer. |
40 | abstract 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. |
41 | Object 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. |
42 | boolean getValueAsBoolean() - Método que intentará convertir el valor del token actual en booleano. |
43 | boolean getValueAsBoolean(boolean defaultValue) - Método que intentará convertir el valor del token actual en booleano. |
44 | double getValueAsDouble() - Método que intentará convertir el valor del token actual en un doble de Java. |
45 | double getValueAsDouble(double defaultValue) - Método que intentará convertir el valor del token actual en un doble de Java. |
46 | int getValueAsInt() - Método que intentará convertir el valor del token actual en un int. |
47 | int getValueAsInt(int defaultValue) - Método que intentará convertir el valor del token actual en un int. |
48 | long getValueAsLong() - Método que intentará convertir el valor del token actual a largo. |
49 | long getValueAsLong(long defaultValue) - Método que intentará convertir el valor del token actual a largo. |
50 | String getValueAsString() - Método que intentará convertir el valor del token actual en una cadena. |
51 | abstract String getValueAsString(String defaultValue) - Método que intentará convertir el valor del token actual en una cadena. |
52 | abstract boolean hasCurrentToken() - Método para verificar si el analizador apunta actualmente a un token (y los datos para ese token están disponibles). |
53 | abstract 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. |
54 | abstract boolean isClosed() - Método que se puede llamar para determinar si este analizador está cerrado o no. |
55 | boolean isEnabled(JsonParser.Feature f) - Método para comprobar si el JsonParser.Feature especificado está habilitado. |
56 | boolean 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. |
57 | Boolean 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. |
58 | boolean 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. |
59 | int 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: |
60 | long 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: |
61 | String 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. |
62 | abstract 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 |
63 | abstract 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). |
64 | abstract void overrideCurrentName(String name) - Método que se puede utilizar para cambiar lo que se considera el nombre (campo) actual. |
sesenta y cinco | int readBinaryValue(Base64Variant b64variant, OutputStream out) - Similar a readBinaryValue (OutputStream) pero permite especificar explícitamente la variante base64 para usar. |
66 | int 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. |
72 | int 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. |
73 | int releaseBuffered(Writer w) - Method that can be called to push back any content that has been read but not consumed by the parser. |
74 | boolean 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). |
75 | abstract void setCodec(ObjectCodec c) - Setter que permite definir ObjectCodec asociado con este analizador, si lo hay. |
76 | JsonParser setFeatureMask(int mask) - Método de configuración masiva para (re) establecer estados de todos los JsonParser estándar. |
77 | void setSchema(FormatSchema schema) - Método para llamar para hacer que este analizador use el esquema especificado. |
78 | abstract 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. |
79 | abstract 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