Jackson - Classe ObjectMapper
introduzione
ObjectMapper è la principale classe attore della libreria Jackson. Classe ObjectMapper ObjectMapper fornisce funzionalità per la lettura e la scrittura di JSON, da e verso POJO di base (Plain Old Java Objects) o da e verso un JSON Tree Model (JsonNode) per scopi generici, nonché funzionalità correlate per l'esecuzione di conversioni. È inoltre altamente personalizzabile per funzionare sia con diversi stili di contenuto JSON, sia per supportare concetti di oggetti più avanzati come il polimorfismo e l'identità degli oggetti. ObjectMapper funge anche da factory per classi ObjectReader e ObjectWriter più avanzate.
Dichiarazione di classe
Di seguito è riportata la dichiarazione per com.fasterxml.jackson.databind.ObjectMapper classe -
public class ObjectMapper
extends ObjectCodec
implements Versioned, SerializableClassi annidate
| S.No. | Classe e descrizione |
|---|---|
| 1 | static class ObjectMapper.DefaultTypeResolverBuilder TypeResolverBuilder personalizzato che fornisce costruttori di resolver di tipi utilizzati con la cosiddetta "tipizzazione predefinita" (vedere enableDefaultTyping () per i dettagli). |
| 2 | static class ObjectMapper.DefaultTyping Enumerazione utilizzata con enableDefaultTyping () per specificare il tipo di tipizzazione predefinita di tipi (classi) da utilizzare. |
Campi
protected DeserializationConfig _deserializationConfig - Oggetto di configurazione che definisce le impostazioni globali di base per il processo di serializzazione.
protected DefaultDeserializationContext _deserializationContext- Oggetto contesto Blueprint; memorizzato qui per consentire sottoclassi personalizzate.
protected InjectableValues _injectableValues - Provider di valori da iniettare in POJO deserializzati.
protected JsonFactory _jsonFactory - Factory utilizzata per creare istanze JsonParser e JsonGenerator secondo necessità.
protected SimpleMixInResolver _mixIns - Mappatura che definisce come applicare annotazioni mix-in: la chiave è il tipo di annotazioni aggiuntive ricevute e il valore è il tipo che ha annotazioni da "mescolare".
protected ConfigOverrides _propertyOverrides - Ignora la configurazione per tipo attualmente attiva, a cui si accede in base al tipo di proprietà dichiarato.
protected Set<Object> _registeredModuleTypes - Set di tipi di modulo (come per Module.getTypeId () che sono stati registrati; tenuto traccia di iff MapperFeature.IGNORE_DUPLICATE_MODULE_REGISTRATIONS è abilitato, in modo che le chiamate di registrazione duplicate possano essere ignorate (per evitare di aggiungere gli stessi gestori più volte, principalmente).
protected ConcurrentHashMap<JavaType,JsonDeserializer<Object>> _rootDeserializers - Useremo una mappa separata a livello principale per tenere traccia dei deserializzatori a livello di root.
protected SerializationConfig _serializationConfig - Oggetto di configurazione che definisce le impostazioni globali di base per il processo di serializzazione.
protected SerializerFactory _serializerFactory - Factory di serializzatori utilizzata per la creazione di serializzatori.
protected DefaultSerializerProvider _serializerProvider - Oggetto che gestisce l'accesso ai serializzatori utilizzati per la serializzazione, inclusa la memorizzazione nella cache.
protected SubtypeResolver _subtypeResolver - Cosa usata per registrare i sottotipi, risolvendoli in super / sottotipi secondo necessità.
protected TypeFactory _typeFactory- Factory specifica utilizzata per creare istanze JavaType; necessario per consentire ai moduli di aggiungere una gestione dei tipi più personalizzata (principalmente per supportare tipi di linguaggi JVM non Java).
protected static AnnotationIntrospector DEFAULT_ANNOTATION_INTROSPECTOR
protected static BaseSettings DEFAULT_BASE - Le impostazioni di base contengono i valori predefiniti utilizzati per tutte le istanze di ObjectMapper.
protected static VisibilityChecker<?> STD_VISIBILITY_CHECKER
Costruttori
| S.No. | Costruttore e descrizione |
|---|---|
| 1 | ObjectMapper() Il costruttore predefinito, che costruirà la JsonFactory predefinita come necessario, usa SerializerProvider come SerializerProvider e BeanSerializerFactory come SerializerFactory. |
| 2 | ObjectMapper(JsonFactory jf) Costruisce l'istanza che utilizza JsonFactory specificato per costruire JsonParsers e / o JsonGenerators necessari. |
| 3 | ObjectMapper(JsonFactory jf, SerializerProvider sp, DeserializerProvider dp) Costruisce l'istanza che utilizza JsonFactory specificato per costruire i JsonParser e / o JsonGenerators necessari e utilizza i provider forniti per accedere a serializzatori e deserializzatori. |
| 4 | protected ObjectMapper(ObjectMapper src) Copy-costruttore, utilizzato principalmente per supportare copy (). |
Metodi
Metodo di supporto di cui è possibile eseguire l'override utilizzato per costruire SerializerProvider da usare per la serializzazione. void addMixInAnnotations (Class <?> target, Class <?> mixinSource) - Deprecato. Dal 2.5: sostituito da una forma fluente del metodo; addMixIn (Classe, Classe). protected DefaultDeserializationContext createDeserializationContext (JsonParser p, DeserializationConfig cfg) - Metodo di supporto interno chiamato per creare un'istanza di DeserializationContext per deserializzare un singolo valore radice. JsonSchema generateJsonSchema (Class <?> T) - Deprecato. Dal 2.6 usa il generatore di schemi JSON esterno (https://github.com/FasterXML/jackson-module-jsonSchema) (che sotto il cofano chiama acceptJsonFormatVisitor (JavaType, JsonFormatVisitorWrapper)) void registerSubtypes (Class <?> ... classes) - Metodo per registrare la classe specificata come sottotipo, in modo che la risoluzione basata sul nome del tipo possa collegare i supertipi ai sottotipi (in alternativa all'uso delle annotazioni). void setFilters (FilterProvider filterProvider) - Deprecato. A partire dalla versione 2.6, utilizzare invece setFilterProvider (com.fasterxml.jackson.databind.ser.FilterProvider) (consente il concatenamento) Metodo Factory per costruire ObjectReader che utilizzerà i dettagli di escape dei caratteri specificati per l'output.| 1 | protected void _checkInvalidCopy(Class<?> exp) |
| 2 | protected void _configAndWriteValue(JsonGenerator g, Object value) - Metodo chiamato per configurare il generatore come necessario e quindi chiamare la funzionalità di scrittura |
| 3 | protected Object _convert(Object fromValue, JavaType toValueType) - Implementazione della conversione effettiva: invece di utilizzare i metodi di lettura e scrittura esistenti, gran parte del codice è inline. |
| 4 | protected JsonDeserializer<Object> _findRootDeserializer(DeserializationContext ctxt, JavaType valueType) - Metodo chiamato per individuare il deserializzatore per il valore a livello di root passato. |
| 5 | protected JsonToken _initForReading(JsonParser p) - Metodo chiamato per garantire che un determinato parser sia pronto per la lettura del contenuto per il data binding. |
| 6 | protected ObjectReader _newReader(DeserializationConfig config) - Le sottoclassi del metodo Factory devono sostituire, per produrre istanze ObjectReader del sottotipo appropriato |
| 7 | protected ObjectReader _newReader(DeserializationConfig config, JavaType valueType, Object valueToUpdate, FormatSchema schema, InjectableValues injectableValues) - Le sottoclassi del metodo Factory devono sostituire, per produrre istanze ObjectReader del sottotipo appropriato |
| 8 | protected ObjectWriter _newWriter(SerializationConfig config) - Le sottoclassi del metodo Factory devono sovrascrivere per produrre istanze ObjectWriter del sottotipo appropriato |
| 9 | protected ObjectWriter _newWriter(SerializationConfig config, FormatSchema schema) - Le sottoclassi del metodo Factory devono sovrascrivere per produrre istanze ObjectWriter del sottotipo appropriato |
| 10 | protected ObjectWriter _newWriter(SerializationConfig config, JavaType rootType, PrettyPrinter pp) - Le sottoclassi del metodo Factory devono sovrascrivere per produrre istanze ObjectWriter del sottotipo appropriato. |
| 11 | protected Object _readMapAndClose(JsonParser p0, JavaType valueType) |
| 12 | protected Object _readValue(DeserializationConfig cfg, JsonParser p, JavaType valueType) - Attuazione effettiva della lettura del valore + operazione di binding. |
| 13 | protected DefaultSerializerProvider _serializerProvider(SerializationConfig config) |
| 14 | protected Object _unwrapAndDeserialize(JsonParser p, DeserializationContext ctxt, DeserializationConfig config, JavaType rootType, JsonDeserializer<Object> deser) |
| 15 | protected void _verifySchemaType(FormatSchema schema) |
| 16 | void acceptJsonFormatVisitor(Class<?> type, JsonFormatVisitorWrapper visitor) - Metodo per la gerarchia del tipo di visita per un dato tipo, utilizzando il visitatore specificato. |
| 17 | void acceptJsonFormatVisitor(JavaType type, JsonFormatVisitorWrapper visitor) - Metodo per la gerarchia del tipo di visita per un dato tipo, utilizzando il visitatore specificato. |
| 18 | ObjectMapper addHandler(DeserializationProblemHandler h) - Metodo per l'aggiunta di DeserializationProblemHandler specificato da utilizzare per la gestione di problemi specifici durante la deserializzazione. |
| 19 | ObjectMapper addMixIn(Class<?> target, Class<?> mixinSource) - Metodo da utilizzare per aggiungere annotazioni mix-in da utilizzare per aumentare la classe o l'interfaccia specificata. |
| 20 | boolean canDeserialize(JavaType type) - Metodo che può essere chiamato per verificare se mapper pensa di poter deserializzare un oggetto di un dato tipo. |
| 21 | boolean canDeserialize(JavaType type, AtomicReference<Throwable> cause) - Metodo simile a canDeserialize (JavaType) ma che può restituire Throwable effettivo che è stato lanciato durante il tentativo di costruire il serializzatore: questo può essere utile per capire qual è il problema reale. |
| 22 | boolean canSerialize(Class<?> type) - Metodo che può essere chiamato per verificare se mapper pensa di poter serializzare un'istanza di una determinata classe. |
| 23 | boolean canSerialize(Class<?> type, AtomicReference<Throwable> cause) - Metodo simile a canSerialize (Class) ma che può restituire Throwable effettivo che è stato lanciato durante il tentativo di costruire il serializzatore: questo può essere utile per capire qual è il problema reale. |
| 24 | ObjectMapper clearProblemHandlers() - Metodo per rimuovere tutte le istanze di DeserializationProblemHandlers registrate da questo mapper. |
| 25 | MutableConfigOverride configOverride(Classlt;?> type) - Accessor per ottenere un oggetto di sostituzione della configurazione modificabile per un determinato tipo, necessario per aggiungere o modificare le sostituzioni per tipo applicate alle proprietà di un determinato tipo. |
| 26 | ObjectMapper configure(DeserializationFeature f, boolean state) - Metodo per modificare lo stato di una funzione di deserializzazione on / off per questo mapping di oggetti. |
| 27 | ObjectMapper configure(JsonGenerator.Feature f, boolean state) - Metodo per modificare lo stato di una funzione JsonGenerator on / off per le istanze del generatore create da questo mappatore di oggetti. |
| 28 | ObjectMapper configure(JsonParser.Feature f, boolean state) - Metodo per modificare lo stato di JsonParser.Features specificato per le istanze del parser create da questo mappatore di oggetti. |
| 29 | ObjectMapper configure(MapperFeature f, boolean state) - Metodo per modificare lo stato di una funzione mapper on / off per questa istanza mapper. |
| 30 | ObjectMapper configure(SerializationFeature f, boolean state) - Metodo per modificare lo stato di una funzione di serializzazione on / off per questo mappatore di oggetti. |
| 31 | JavaType constructType(Type t) - Metodo pratico per costruire JavaType su un dato tipo (tipicamente java.lang.Class), ma senza contesto esplicito. |
| 32 | <T> T convertValue(Object fromValue, Class<T> toValueType) - Metodo pratico per eseguire la conversione in due fasi da un dato valore, in un'istanza di un dato tipo di valore, se (ma solo se!) È necessaria la conversione. |
| 33 | <T> T convertValue(Object fromValue, JavaType toValueType) - Vedi convertValue (Object, Class) |
| 34 | <T> T convertValue(Object fromValue, TypeReference<?> toValueTypeRef) - Vedi convertValue (Object, Class) |
| 35 | ObjectMapper copy() - Metodo per creare una nuova istanza ObjectMapper con la stessa configurazione iniziale di questa istanza. |
| 36 | ArrayNode createArrayNode() - Nota: il tipo restituito è co-variante, poiché l'astrazione ObjectCodec di base non può fare riferimento a tipi di nodi concreti (poiché fa parte del pacchetto principale, mentre gli impls fanno parte del pacchetto mapper) |
| 37 | ObjectNode createObjectNode() - Nota: il tipo restituito è co-variante, poiché l'astrazione ObjectCodec di base non può fare riferimento a tipi di nodi concreti (poiché fa parte del pacchetto principale, mentre gli impls fanno parte del pacchetto mapper) |
| 38 | protected ClassIntrospector defaultClassIntrospector() - Metodo di supporto sovrascrivibile utilizzato per costruire ClassIntrospector predefinito da utilizzare. |
| 39 | ObjectMapper disable(DeserializationFeature feature) - Metodo per abilitare le funzionalità DeserializationConfig specificate. |
| 40 | ObjectMapper disable(DeserializationFeature first, DeserializationFeature... f) - Metodo per abilitare le funzionalità DeserializationConfig specificate. |
| 41 | ObjectMapper disable(JsonGenerator.Feature... features) - Metodo per disabilitare JsonGenerator.Features specificato per le istanze del parser create da questo mappatore di oggetti. |
| 42 | ObjectMapper disable(JsonParser.Feature... features) - Metodo per disabilitare JsonParser.Features specificato per le istanze del parser create da questo mappatore di oggetti. |
| 43 | ObjectMapper disable(MapperFeature... f) - Metodo per abilitare le funzionalità DeserializationConfig specificate. |
| 44 | ObjectMapper disable(SerializationFeature f) - Metodo per abilitare le funzionalità DeserializationConfig specificate. |
| 45 | ObjectMapper disable(SerializationFeature first, SerializationFeature... f) - Metodo per abilitare le funzionalità DeserializationConfig specificate. |
| 46 | ObjectMapper disableDefaultTyping()- Metodo per disabilitare l'inclusione automatica delle informazioni sul tipo; in tal caso, solo i tipi annotati in modo esplicito (quelli con JsonTypeInfo) avranno informazioni aggiuntive sul tipo incorporato. |
| 47 | ObjectMapper enable(DeserializationFeature feature) - Metodo per abilitare le funzionalità DeserializationConfig specificate. |
| 48 | ObjectMapper enable(DeserializationFeature first, DeserializationFeature... f) - Metodo per abilitare le funzionalità DeserializationConfig specificate. |
| 49 | ObjectMapper enable(JsonGenerator.Feature... features) - Metodo per abilitare JsonGenerator.Features specificato per le istanze del parser create da questo mappatore di oggetti. |
| 50 | ObjectMapper enable(JsonParser.Feature... features) - Metodo per abilitare JsonParser.Features specificato per le istanze del parser create da questo mappatore di oggetti. |
| 51 | ObjectMapper enable(MapperFeature... f) - Metodo per abilitare le funzionalità MapperConfig specificate. |
| 52 | ObjectMapper enable(SerializationFeature f) - Metodo per abilitare la funzione DeserializationConfig specificata. |
| 53 | ObjectMapper enable(SerializationFeature first, SerializationFeature... f) - Metodo per abilitare le funzionalità DeserializationConfig specificate. |
| 54 | ObjectMapper enableDefaultTyping() - Metodo pratico che equivale a chiamare |
| 55 | ObjectMapper enableDefaultTyping(ObjectMapper.DefaultTyping dti) - Metodo pratico che equivale a chiamare |
| 56 | ObjectMapper enableDefaultTyping(ObjectMapper.DefaultTyping applicability, JsonTypeInfo.As includeAs) - Metodo per abilitare l'inclusione automatica delle informazioni sul tipo, necessario per una corretta deserializzazione dei tipi polimorfici (a meno che i tipi non siano stati annotati con JsonTypeInfo). |
| 57 | ObjectMapper enableDefaultTypingAsProperty(ObjectMapper.DefaultTyping applicability, String propertyName) - Metodo per abilitare l'inclusione automatica delle informazioni sul tipo - necessario per una corretta deserializzazione dei tipi polimorfici (a meno che i tipi non siano stati annotati con JsonTypeInfo) - utilizzando il meccanismo di inclusione "As.PROPERTY" e il nome della proprietà specificato da utilizzare per l'inclusione (l'impostazione predefinita è "@ class "poiché le informazioni sul tipo predefinito utilizzano sempre il nome della classe come identificatore del tipo) |
| 58 | ObjectMapper findAndRegisterModules() - Metodo pratico che è funzionalmente equivalente a: mapper.registerModules (mapper.findModules ()); |
| 59 | Class<?> findMixInClassFor(Class<?> cls) |
| 60 | static List<Module> findModules() - Metodo per individuare i metodi disponibili, utilizzando la funzione JDK ServiceLoader, insieme all'SPI fornito dal modulo. |
| 61 | static List<Module> findModules(ClassLoader classLoader) - Metodo per individuare i metodi disponibili, utilizzando la funzione JDK ServiceLoader, insieme all'SPI fornito dal modulo. |
| 62 | DateFormat getDateFormat() |
| 63 | DeserializationConfig getDeserializationConfig() - Metodo che restituisce l'oggetto DeserializationConfig predefinito condiviso che definisce le impostazioni di configurazione per la deserializzazione. |
| 64 | DeserializationContext getDeserializationContext() - Metodo per ottenere DeserializationContext corrente. |
| 65 | JsonFactory getFactory() - Metodo che può essere utilizzato per ottenere JsonFactory che questo mappatore utilizza se deve costruire JsonParsers e / o JsonGenerators. |
| 66 | InjectableValues getInjectableValues() |
| 67 | JsonFactory getJsonFactory()- Deprecato. A partire dalla 2.1: utilizzare getFactory () invece |
| 68 | JsonNodeFactory getNodeFactory() - Metodo che può essere utilizzato per ottenere JsonNodeFactory che questo mappatore utilizzerà durante la costruzione diretta di istanze JsonNode radice per alberi. |
| 69 | PropertyNamingStrategy getPropertyNamingStrategy() |
| 70 | SerializationConfig getSerializationConfig() - Metodo che restituisce l'oggetto SerializationConfig predefinito condiviso che definisce le impostazioni di configurazione per la serializzazione. |
| 71 | SerializerFactory getSerializerFactory() - Metodo per ottenere SerializerFactory corrente. |
| 72 | SerializerProvider getSerializerProvider() - Accessor per l'istanza "blueprint" (o factory), da cui vengono create le istanze chiamando DefaultSerializerProvider.createInstance (com.fasterxml.jackson.databind.SerializationConfig, com.fasterxml.jackson.databind.ser.SerializerFactory). |
| 73 | SerializerProvider getSerializerProviderInstance() - Accessor per costruire e restituire un'istanza di SerializerProvider che può essere usata per accedere ai serializzatori. |
| 74 | SubtypeResolver getSubtypeResolver() - Metodo per accedere al risolutore di sottotipi in uso. |
| 75 | TypeFactory getTypeFactory() - Accessor per ottenere l'istanza TypeFactory attualmente configurata. |
| 76 | VisibilityChecker<?> getVisibilityChecker()- Metodo per accedere al controllo di visibilità attualmente configurato; oggetto utilizzato per determinare se un dato elemento di proprietà (metodo, campo, costruttore) può essere rilevato automaticamente o meno. |
| 77 | boolean isEnabled(DeserializationFeature f) - Metodo per verificare se una determinata funzione specifica della deserializzazione è abilitata. |
| 78 | boolean isEnabled(JsonFactory.Feature f) - Metodo pratico, equivalente a: |
| 79 | boolean isEnabled(JsonGenerator.Feature f) |
| 80 | boolean isEnabled(JsonParser.Feature f) |
| 81 | boolean isEnabled(MapperFeature f) - Metodo per verificare se un determinato MapperFeature è abilitato. |
| 82 | boolean isEnabled(SerializationFeature f) - Metodo per verificare se una determinata funzione specifica della serializzazione è abilitata. |
| 83 | int mixInCount() |
| 84 | ObjectReader reader() - Metodo di fabbrica per costruire ObjectReader con le impostazioni predefinite. |
| 85 | ObjectReader reader(Base64Variant defaultBase64) - Metodo di fabbrica per la costruzione di ObjectReader che utilizzerà la variante di codifica Base64 specificata per i dati binari con codifica Base64. |
| 86 | ObjectReader reader(Class<?> type)- Deprecato. Dalla 2.5, usa invece readerFor (Class) |
| 87 | ObjectReader reader(ContextAttributes attrs) - Metodo di fabbrica per la costruzione di ObjectReader che utilizzerà gli attributi predefiniti specificati. |
| 88 | ObjectReader reader(DeserializationFeature feature) - Metodo di fabbrica per la costruzione di ObjectReader con la funzionalità specificata abilitata (rispetto alle impostazioni di questa istanza del mapper). |
| 89 | ObjectReader reader(DeserializationFeature first, DeserializationFeature... other) - Metodo di fabbrica per la costruzione di ObjectReader con funzionalità specificate abilitate (rispetto alle impostazioni di questa istanza del mapper). |
| 90 | ObjectReader reader(FormatSchema schema) - Metodo Factory per la costruzione di ObjectReader che passerà un oggetto schema specifico a JsonParser utilizzato per la lettura del contenuto. |
| 91 | ObjectReader reader(InjectableValues injectableValues) - Metodo di fabbrica per la costruzione di ObjectReader che utilizzerà valori iniettabili specificati. |
| 92 | ObjectReader reader(JavaType type)- Deprecato. Dalla 2.5, usa invece readerFor (JavaType) |
| 93 | ObjectReader reader(JsonNodeFactory f) - Metodo Factory per la costruzione di ObjectReader che utilizzerà JsonNodeFactory specificato per la costruzione di alberi JSON. |
| 94 | ObjectReader reader(TypeReference<?> type)- Deprecato. Dalla 2.5, usa invece readerFor (TypeReference) |
| 95 | ObjectReader readerFor(Class<?> type) - Metodo di fabbrica per la costruzione di ObjectReader che leggerà o aggiornerà le istanze del tipo specificato |
| 96 | ObjectReader readerFor(JavaType type) - Metodo di fabbrica per la costruzione di ObjectReader che leggerà o aggiornerà le istanze del tipo specificato |
| 97 | ObjectReader readerFor(TypeReference<?> type) - Metodo di fabbrica per la costruzione di ObjectReader che leggerà o aggiornerà le istanze del tipo specificato |
| 98 | ObjectReader readerForUpdating(Object valueToUpdate) - Metodo Factory per la costruzione di ObjectReader che aggiornerà un determinato Object (di solito Bean, ma può anche essere una Collection o Map, ma NON un array) con dati JSON. |
| 99 | ObjectReader readerWithView(Class<?> view) - Metodo Factory per la costruzione di ObjectReader che deserializzerà gli oggetti utilizzando la vista JSON specificata (filtro). |
| 100 | JsonNode readTree(byte[] content) - Metodo per deserializzare il contenuto JSON come albero espresso utilizzando un set di istanze JsonNode. |
| 101 | JsonNode readTree(File file) - Metodo per deserializzare il contenuto JSON come albero espresso utilizzando un set di istanze JsonNode. |
| 102 | JsonNode readTree(InputStream in) - Metodo per deserializzare il contenuto JSON come albero espresso utilizzando un set di istanze JsonNode. |
| 103 | <T extends TreeNode> T readTree(JsonParser p) - Metodo per deserializzare il contenuto JSON come albero espresso utilizzando un set di istanze JsonNode. |
| 104 | JsonNode readTree(Reader r) - Metodo per deserializzare il contenuto JSON come albero espresso utilizzando un set di istanze JsonNode. |
| 105 | JsonNode readTree(String content) - Metodo per deserializzare il contenuto JSON come albero espresso utilizzando un set di istanze JsonNode. |
| 106 | JsonNode readTree(URL source) - Metodo per deserializzare il contenuto JSON come albero espresso utilizzando un set di istanze JsonNode. |
| 107 | <T> T readValue(byte[] src, Class<T> valueType) |
| 108 | <T> T readValue(byte[] src, int offset, int len, Class<T> valueType) |
| 109 | <T> T readValue(byte[] src, int offset, int len, JavaType valueType) |
| 110 | <T> T readValue(byte[] src, int offset, int len, TypeReference valueTypeRef) |
| 111 | <T> T readValue(byte[] src, JavaType valueType) |
| 112 | <T> T readValue(byte[] src, TypeReference valueTypeRef) |
| 113 | <T> T readValue(DataInput src, Class<T> valueType) |
| 114 | <T> T readValue(DataInput src, JavaType valueType) |
| 115 | <T> T readValue(File src, Class<T> valueType) - Metodo per deserializzare il contenuto JSON da un determinato file in un determinato tipo di Java. |
| 116 | <T> T readValue(File src, JavaType valueType) - Metodo per deserializzare il contenuto JSON da un determinato file in un determinato tipo di Java. |
| 117 | <T> T readValue(File src, TypeReference valueTypeRef) - Metodo per deserializzare il contenuto JSON da un determinato file in un determinato tipo di Java. |
| 118 | <T> T readValue(InputStream src, Class<T> valueType) |
| 119 | <T> T readValue(InputStream src, JavaType valueType) |
| 120 | <T> T readValue(InputStream src, TypeReference valueTypeRef) |
| 121 | <T> T readValue(JsonParser p, Class<T> valueType) - Method to deserialize JSON content into a non-container type (it can be an array type, however): typically a bean, array or a wrapper type (like Boolean). |
| 122 | <T> T readValue(JsonParser p, JavaType valueType) - Metodo di sovraccarico indipendente dai tipi, fondamentalmente alias per readValue (JsonParser, Class). |
| 123 | <T> T readValue(JsonParser p, ResolvedType valueType) - Metodo per deserializzare il contenuto JSON in un tipo Java, il riferimento al quale viene passato come argomento. |
| 124 | <T> T readValue(JsonParser p, TypeReference<?> valueTypeRef) - Metodo per deserializzare il contenuto JSON in un tipo Java, il riferimento al quale viene passato come argomento. |
| 125 | <T> T readValue(Reader src, Class<T> valueType) - |
| 1 | <T> T readValue(Reader src, JavaType valueType) |
| 126 | <T> T readValue(Reader src, TypeReference valueTypeRef) |
| 127 | <T> T readValue(String content, Class<T> valueType) - Metodo per deserializzare il contenuto JSON da una determinata stringa di contenuto JSON. |
| 128 | <T> T readValue(String content, JavaType valueType) - Metodo per deserializzare il contenuto JSON da una determinata stringa di contenuto JSON. |
| 129 | <T> T readValue(String content, TypeReference valueTypeRef) - Metodo per deserializzare il contenuto JSON da una determinata stringa di contenuto JSON. |
| 130 | <T> T readValue(URL src, Class<T> valueType) - Metodo per deserializzare il contenuto JSON da una determinata risorsa in un determinato tipo di Java. |
| 131 | <T> T readValue(URL src, JavaType valueType) |
| 132 | <T> T readValue(URL src, TypeReference valueTypeRef) - Metodo per deserializzare il contenuto JSON da una determinata risorsa in un determinato tipo di Java. |
| 133 | <T> MappingIterator<T> readValues(JsonParser p, Class<T> valueType) - Metodo pratico, equivalente in funzione a: |
| 134 | <T> MappingIterator<T> readValues(JsonParser p, JavaType valueType) - Metodo pratico, equivalente in funzione a: |
| 135 | <T> MappingIterator<T> readValues(JsonParser p, ResolvedType valueType) - Metodo pratico, equivalente in funzione a: |
| 136 | <T> MappingIterator<T> readValues(JsonParser p, TypeReference<?>valueTypeRef) - Metodo per leggere la sequenza di oggetti dal flusso del parser. |
| 137 | ObjectMapper registerModule(Module module)- Metodo per registrare un modulo che può estendere le funzionalità fornite da questo mappatore; ad esempio, aggiungendo provider per serializzatori e deserializzatori personalizzati. |
| 138 | ObjectMapper registerModules(Iterable<Module> modules)- Metodo pratico per registrare i moduli specificati in ordine; funzionalmente equivalente a: |
| 139 | ObjectMapper registerModules(Module... modules)- Metodo pratico per registrare i moduli specificati in ordine; funzionalmente equivalente a: |
| 140 | void registerSubtypes(NamedType... types) - Metodo per registrare la classe specificata come sottotipo, in modo che la risoluzione basata sul nome del tipo possa collegare i supertipi ai sottotipi (in alternativa all'uso delle annotazioni). |
| 141 | ObjectMapper setAnnotationIntrospector(AnnotationIntrospector ai) - Metodo per l'impostazione di AnnotationIntrospector utilizzato da questa istanza del mapper sia per la serializzazione che per la deserializzazione. |
| 142 | ObjectMapper setAnnotationIntrospectors(AnnotationIntrospector serializerAI, AnnotationIntrospector deserializerAI) - Metodo per modificare le istanze di AnnotationIntrospector utilizzate da questa istanza del mapper per la serializzazione e la deserializzazione, specificandole separatamente in modo che un'introspezione diversa possa essere utilizzata per aspetti diversi. |
| 143 | ObjectMapper setBase64Variant(Base64Variant v) - Metodo che configurerà Base64Variant predefinito che useranno i serializzatori e deserializzatori byte []. |
| 144 | ObjectMapper setConfig(DeserializationConfig config) - Metodo che consente l'override dell'oggetto DeserializationConfig sottostante. |
| 145 | ObjectMapper setConfig(SerializationConfig config) - Metodo che consente l'override dell'oggetto SerializationConfig sottostante, che contiene le impostazioni di configurazione specifiche della serializzazione. |
| 146 | ObjectMapper setDateFormat(DateFormat dateFormat) - Metodo per la configurazione del DateFormat predefinito da utilizzare durante la serializzazione dei valori temporali come stringhe e la deserializzazione da stringhe JSON. |
| 147 | ObjectMapper setDefaultPrettyPrinter(PrettyPrinter pp) - Metodo per specificare PrettyPrinter da usare quando "default pretty-printing" è abilitato (abilitando SerializationFeature.INDENT_OUTPUT) |
| 148 | ObjectMapper setDefaultTyping(TypeResolverBuilder<?> typer) - Metodo per abilitare l'inclusione automatica delle informazioni sul tipo, utilizzando l'oggetto gestore specificato per determinare quali tipi influiscono, nonché dettagli su come le informazioni sono incorporate. |
| 149 | ObjectMapper setFilterProvider(FilterProvider filterProvider) - Metodo per configurare questo mapper per utilizzare FilterProvider specificato per mappare gli ID filtro alle istanze di filtro effettive. |
| 150 | Object setHandlerInstantiator(HandlerInstantiator hi) - Metodo per configurare HandlerInstantiator da utilizzare per la creazione di istanze di gestori (come serializzatori, deserializzatori, risolutori di tipi e id di tipo), data una classe. |
| 151 | ObjectMapper setInjectableValues(InjectableValues injectableValues) - Metodo per la configurazione di InjectableValues utilizzato per trovare i valori da iniettare. |
| 152 | ObjectMapper setLocale(Locale l) - Metodo per sovrascrivere le impostazioni internazionali predefinite da utilizzare per la formattazione. |
| 153 | void setMixInAnnotations(Map<Class<?>,Class<?>> sourceMixins)- Deprecato. Dal 2.5: sostituito da una forma fluente del metodo; setMixIns (java.util.Map <java.lang.Class <?>, java.lang.Class <? >>). |
| 154 | ObjectMapper setMixInResolver(ClassIntrospector.MixInResolver resolver) - Metodo che può essere chiamato per specificare un determinato risolutore per individuare le classi mix-in da utilizzare, sovrascrivendo le mappature aggiunte direttamente. |
| 155 | ObjectMapper setMixIns(Map<Class<?>,Class<?>> sourceMixins) - Metodo da utilizzare per definire le annotazioni mix-in da utilizzare per aumentare le annotazioni che hanno le classi processabili (serializzabili / deserializzabili). |
| 156 | ObjectMapper setNodeFactory(JsonNodeFactory f) - Metodo per specificare JsonNodeFactory da utilizzare per costruire nodi dell'albero a livello di root (tramite il metodo createObjectNode () |
| 157 | ObjectMapper setPropertyInclusion(JsonInclude.Value incl) - Metodo per impostare la strategia di inclusione della proprietà POJO predefinita per la serializzazione. |
| 158 | ObjectMapper setPropertyNamingStrategy(PropertyNamingStrategy s) - Metodo per impostare la strategia di denominazione delle proprietà personalizzate da utilizzare. |
| 159 | ObjectMapper setSerializationInclusion(JsonInclude.Include incl) - Metodo pratico, equivalente a chiamare: |
| 160 | ObjectMapper setSerializerFactory(SerializerFactory f) - Metodo per impostare SerializerFactory specifico da utilizzare per costruire serializzatori (bean). |
| 161 | ObjectMapper setSerializerProvider(DefaultSerializerProvider p) - Metodo per impostare l'istanza di SerializerProvider "blueprint" da utilizzare come base per le istanze di provider effettive da utilizzare per la gestione della memorizzazione nella cache delle istanze di JsonSerializer. |
| 162 | ObjectMapper setSubtypeResolver(SubtypeResolver str) - Metodo per impostare il resolver di sottotipi personalizzati da utilizzare. |
| 163 | ObjectMapper setTimeZone(TimeZone tz) - Metodo per sovrascrivere il fuso orario predefinito da utilizzare per la formattazione. |
| 164 | ObjectMapper setTypeFactory(TypeFactory f) - Metodo che può essere utilizzato per sovrascrivere l'istanza TypeFactory utilizzata da questo mappatore. |
| 165 | ObjectMapper setVisibility(PropertyAccessor forMethod, JsonAutoDetect.Visibility visibility) - Metodo pratico che consente di modificare la configurazione per i VisibilityChecker sottostanti, per modificare i dettagli dei tipi di proprietà rilevati automaticamente. |
| 166 | ObjectMapper setVisibility(VisibilityChecker<?> vc) - Metodo per impostare VisibilityChecker attualmente configurato, oggetto utilizzato per determinare se un determinato elemento di proprietà (metodo, campo, costruttore) può essere rilevato automaticamente o meno. |
| 167 | void setVisibilityChecker(VisibilityChecker<?> vc)- Deprecato. Dal 2.6 usa invece setVisibility (VisibilityChecker). |
| 168 | JsonParser treeAsTokens(TreeNode n) - Metodo per costruire un JsonParser dalla rappresentazione ad albero JSON. |
| 169 | <T> T treeToValue(TreeNode n, Class<T> valueType) - Metodo di conversione conveniente che vincolerà i dati forniti dall'albero JSON in un tipo di valore specifico (di solito bean). |
| 170 | <T extends JsonNode> T valueToTree(Object fromValue)- Inverso di treeToValue (com.fasterxml.jackson.core.TreeNode, java.lang.Class <T>); dato un valore (di solito bean), costruirà una rappresentazione dell'albero JSON equivalente. |
| 171 | Version version() - Metodo che restituirà le informazioni sulla versione memorizzate e lette dal jar che contiene questa classe. |
| 172 | ObjectWriter writer() - Metodo pratico per costruire ObjectWriter con le impostazioni predefinite. |
| 173 | ObjectWriter writer(Base64Variant defaultBase64) - Metodo di fabbrica per la costruzione di ObjectWriter che utilizzerà la variante di codifica Base64 specificata per i dati binari con codifica Base64. |
| 174 | ObjectWriter writer(CharacterEscapes escapes) - |
| 175 | ObjectWriter writer(ContextAttributes attrs) - Metodo di fabbrica per la costruzione di ObjectWriter che utilizzerà gli attributi predefiniti specificati. |
| 176 | ObjectWriter writer(DateFormat df)- Metodo Factory per costruire ObjectWriter che serializzerà gli oggetti utilizzando DateFormat specificato; oppure, se viene passato null, utilizzando il timestamp (numero a 64 bit. |
| 177 | ObjectWriter writer(FilterProvider filterProvider) - Metodo Factory per la costruzione di ObjectWriter che serializzerà gli oggetti utilizzando il provider di filtri specificato. |
| 178 | ObjectWriter writer(FormatSchema schema) - Metodo Factory per la costruzione di ObjectWriter che passerà un oggetto schema specifico a JsonGenerator utilizzato per la scrittura del contenuto. |
| 179 | ObjectWriter writer(PrettyPrinter pp) - Metodo di fabbrica per la costruzione di ObjectWriter che serializzerà gli oggetti utilizzando la stampante carina specificata per il rientro (o se null, nessuna stampante carina) |
| 180 | ObjectWriter writer(SerializationFeature feature) - Metodo di fabbrica per la costruzione di ObjectWriter con la funzionalità specificata abilitata (rispetto alle impostazioni di questa istanza del mapper). |
| 181 | ObjectWriter writer(SerializationFeature first, SerializationFeature... other) - Metodo di fabbrica per la costruzione di ObjectWriter con funzionalità specificate abilitate (rispetto alle impostazioni di questa istanza del mapper). |
| 182 | ObjectWriter writerFor(Class<?> rootType) - Metodo di fabbrica per la costruzione di ObjectWriter che serializzerà gli oggetti utilizzando il tipo di root specificato, invece del tipo di valore di runtime effettivo. |
| 183 | ObjectWriter writerFor(JavaType rootType) - Metodo di fabbrica per la costruzione di ObjectWriter che serializzerà gli oggetti utilizzando il tipo di root specificato, invece del tipo di valore di runtime effettivo. |
| 184 | ObjectWriter writerFor(TypeReference<?> rootType) - Metodo di fabbrica per la costruzione di ObjectWriter che serializzerà gli oggetti utilizzando il tipo di root specificato, invece del tipo di valore di runtime effettivo. |
| 185 | ObjectWriter writerWithDefaultPrettyPrinter() - Metodo di fabbrica per la costruzione di ObjectWriter che serializzerà gli oggetti utilizzando la graziosa stampante predefinita per l'indentazione. |
| 186 | ObjectWriter writerWithType(Class<?> rootType)- Deprecato. Dalla 2.5, usa invece writerFor (Class). |
| 187 | ObjectWriter writerWithType(JavaType rootType)- Deprecato. Dalla 2.5, usa invece writerFor (JavaType). |
| 188 | ObjectWriter writerWithType(TypeReference<?> rootType)- Deprecato. Dalla 2.5, usa invece writerFor (TypeReference). |
| 189 | ObjectWriter writerWithView(Class<?> serializationView) - Metodo Factory per la costruzione di ObjectWriter che serializzerà gli oggetti utilizzando la vista JSON specificata (filtro). |
| 190 | void writeTree(JsonGenerator jgen, JsonNode rootNode) - Metodo per serializzare un dato albero JSON, utilizzando il generatore fornito. |
| 191 | void writeTree(JsonGenerator jgen, TreeNode rootNode) |
| 192 | void writeValue(DataOutput out, Object value) |
| 193 | void writeValue(File resultFile, Object value) - Metodo che può essere utilizzato per serializzare qualsiasi valore Java come output JSON, scritto nel file fornito. |
| 194 | void writeValue(JsonGenerator g, Object value) - Metodo che può essere utilizzato per serializzare qualsiasi valore Java come output JSON, utilizzando JsonGenerator fornito. |
| 195 | void writeValue(OutputStream out, Object value) - Metodo che può essere utilizzato per serializzare qualsiasi valore Java come output JSON, utilizzando il flusso di output fornito (utilizzando la codifica JsonEncoding.UTF8). |
| 196 | void writeValue(Writer w, Object value) - Metodo che può essere utilizzato per serializzare qualsiasi valore Java come output JSON, utilizzando Writer fornito. |
| 197 | byte[] writeValueAsBytes(Object value) - Metodo che può essere utilizzato per serializzare qualsiasi valore Java come array di byte. |
| 198 | String writeValueAsString(Object value) - Metodo che può essere utilizzato per serializzare qualsiasi valore Java come stringa. |
Metodi ereditati
Questa classe eredita i metodi dalle classi seguenti:
java.lang.Object
ObjectMapper Esempio
Crea il seguente programma java usando qualsiasi editor di tua scelta, diciamo C:/> Jackson_WORKSPACE
File: JacksonTester.java
import java.io.IOException;
import com.fasterxml.jackson.core.JsonParseException;
import com.fasterxml.jackson.databind.JsonMappingException;
import com.fasterxml.jackson.databind.ObjectMapper;
public class JacksonTester {
public static void main(String args[]){
ObjectMapper mapper = new ObjectMapper();
String jsonString = "{\"name\":\"Mahesh\", \"age\":21}";
//map json to student
try{
Student student = mapper.readValue(jsonString, Student.class);
System.out.println(student);
jsonString = mapper.writerWithDefaultPrettyPrinter().writeValueAsString(student);
System.out.println(jsonString);
}
catch (JsonParseException e) { e.printStackTrace();}
catch (JsonMappingException e) { e.printStackTrace(); }
catch (IOException e) { e.printStackTrace(); }
}
}
class Student {
private String name;
private int age;
public Student(){}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public int getAge() {
return age;
}
public void setAge(int age) {
this.age = age;
}
public String toString(){
return "Student [ name: "+name+", age: "+ age+ " ]";
}
}Verify the result
Compila le classi usando javac compilatore come segue:
C:\Jackson_WORKSPACE>javac JacksonTester.javaOra esegui il jacksonTester per vedere il risultato:
C:\Jackson_WORKSPACE>java JacksonTesterVerifica l'output
Student [ name: Mahesh, age: 21 ]
{
"name" : "Mahesh",
"age" : 21
}