Jackson - Classe ObjectMapper
introduction
ObjectMapper est la classe d'acteur principale de la bibliothèque Jackson. ObjectMapper classe ObjectMapper fournit des fonctionnalités de lecture et d'écriture JSON, soit vers et depuis des POJO de base (Plain Old Java Objects), soit vers et depuis un modèle d'arbre JSON à usage général (JsonNode), ainsi que des fonctionnalités associées pour effectuer des conversions. Il est également hautement personnalisable pour fonctionner à la fois avec différents styles de contenu JSON et pour prendre en charge des concepts d'objets plus avancés tels que le polymorphisme et l'identité d'objet. ObjectMapper sert également de fabrique pour les classes ObjectReader et ObjectWriter plus avancées.
Déclaration de classe
Voici la déclaration pour com.fasterxml.jackson.databind.ObjectMapper classe -
public class ObjectMapper
extends ObjectCodec
implements Versioned, SerializableClasses imbriquées
| S.No. | Classe et description |
|---|---|
| 1 | static class ObjectMapper.DefaultTypeResolverBuilder TypeResolverBuilder personnalisé qui fournit des générateurs de résolution de type utilisés avec ce que l'on appelle le «typage par défaut» (voir enableDefaultTyping () pour plus de détails). |
| 2 | static class ObjectMapper.DefaultTyping Énumération utilisée avec enableDefaultTyping () pour spécifier le type de typage par défaut des types (classes) à utiliser. |
Des champs
protected DeserializationConfig _deserializationConfig - Objet de configuration qui définit les paramètres globaux de base pour le processus de sérialisation.
protected DefaultDeserializationContext _deserializationContext- Objet de contexte Blueprint; stocké ici pour autoriser les sous-classes personnalisées.
protected InjectableValues _injectableValues - Fournisseur de valeurs à injecter dans les POJO désérialisés.
protected JsonFactory _jsonFactory - Usine utilisée pour créer des instances JsonParser et JsonGenerator si nécessaire.
protected SimpleMixInResolver _mixIns - Mappage qui définit comment appliquer les annotations de mix-in: key est le type des annotations supplémentaires reçues, et value est le type qui a des annotations à «mixer».
protected ConfigOverrides _propertyOverrides - Remplacements de configuration par type actuellement actifs, accessibles par type de propriété déclaré.
protected Set<Object> _registeredModuleTypes - Ensemble de types de modules (selon Module.getTypeId () qui ont été enregistrés; suivi de iff MapperFeature.IGNORE_DUPLICATE_MODULE_REGISTRATIONS est activé, de sorte que les appels d'enregistrement en double peuvent être ignorés (pour éviter d'ajouter les mêmes gestionnaires plusieurs fois, la plupart du temps).
protected ConcurrentHashMap<JavaType,JsonDeserializer<Object>> _rootDeserializers - Nous utiliserons une carte de niveau principal distincte pour garder une trace des désérialiseurs de niveau racine.
protected SerializationConfig _serializationConfig - Objet de configuration qui définit les paramètres globaux de base pour le processus de sérialisation.
protected SerializerFactory _serializerFactory - Usine de sérialiseurs utilisée pour construire des sérialiseurs.
protected DefaultSerializerProvider _serializerProvider - Objet qui gère l'accès aux sérialiseurs utilisés pour la sérialisation, y compris la mise en cache.
protected SubtypeResolver _subtypeResolver - Chose utilisée pour enregistrer les sous-types, les résoudre en super / sous-types selon les besoins.
protected TypeFactory _typeFactory- Usine spécifique utilisée pour créer des instances JavaType; nécessaire pour permettre aux modules d'ajouter une gestion de type plus personnalisée (principalement pour prendre en charge des types de langages JVM non Java).
protected static AnnotationIntrospector DEFAULT_ANNOTATION_INTROSPECTOR
protected static BaseSettings DEFAULT_BASE - Les paramètres de base contiennent les valeurs par défaut utilisées pour toutes les instances d'ObjectMapper.
protected static VisibilityChecker<?> STD_VISIBILITY_CHECKER
Constructeurs
| S.No. | Constructeur et description |
|---|---|
| 1 | ObjectMapper() Le constructeur par défaut, qui construira le JsonFactory par défaut si nécessaire, utilise SerializerProvider comme SerializerProvider et BeanSerializerFactory comme SerializerFactory. |
| 2 | ObjectMapper(JsonFactory jf) Construit une instance qui utilise JsonFactory spécifié pour construire les JsonParsers et / ou JsonGenerators nécessaires. |
| 3 | ObjectMapper(JsonFactory jf, SerializerProvider sp, DeserializerProvider dp) Construit une instance qui utilise JsonFactory spécifié pour construire les JsonParsers et / ou JsonGenerators nécessaires, et utilise des fournisseurs donnés pour accéder aux sérialiseurs et désérialiseurs. |
| 4 | protected ObjectMapper(ObjectMapper src) Copy-constructeur, principalement utilisé pour prendre en charge copy (). |
Méthodes
Méthode d'assistance remplaçable utilisée pour construire SerializerProvider à utiliser pour la sérialisation. void addMixInAnnotations (classe <?> cible, classe <?> mixinSource) - obsolète. Depuis 2.5: remplacé par une forme courante de la méthode; addMixIn (Classe, Classe). protected DefaultDeserializationContext createDeserializationContext (JsonParser p, DeserializationConfig cfg) - Méthode d'assistance interne appelée pour créer une instance de DeserializationContext pour désérialiser une valeur racine unique. JsonSchema generateJsonSchema (Class <?> T) - Obsolète. Depuis 2.6, utilisez un générateur de schéma JSON externe (https://github.com/FasterXML/jackson-module-jsonSchema) (qui sous le capot appelle acceptJsonFormatVisitor (JavaType, JsonFormatVisitorWrapper)) void registerSubtypes (Class <?> ... classes) - Méthode d'enregistrement de la classe spécifiée en tant que sous-type, de sorte que la résolution basée sur le nom de type puisse lier les supertypes aux sous-types (au lieu d'utiliser des annotations). void setFilters (FilterProvider filterProvider) - Obsolète. Depuis 2.6, utilisez la méthode setFilterProvider (com.fasterxml.jackson.databind.ser.FilterProvider) à la place (autorise le chaînage) la méthode Factory pour la construction d'ObjectReader qui utilisera les détails d'échappement de caractères spécifiés pour la sortie.| 1 | protected void _checkInvalidCopy(Class<?> exp) |
| 2 | protected void _configAndWriteValue(JsonGenerator g, Object value) - Méthode appelée pour configurer le générateur si nécessaire, puis appeler la fonctionnalité d'écriture |
| 3 | protected Object _convert(Object fromValue, JavaType toValueType) - Implémentation de la conversion réelle: au lieu d'utiliser les méthodes de lecture et d'écriture existantes, une grande partie du code est incorporée. |
| 4 | protected JsonDeserializer<Object> _findRootDeserializer(DeserializationContext ctxt, JavaType valueType) - Méthode appelée pour localiser le désérialiseur pour la valeur de niveau racine transmise. |
| 5 | protected JsonToken _initForReading(JsonParser p) - Méthode appelée pour s'assurer que l'analyseur donné est prêt à lire le contenu pour la liaison de données. |
| 6 | protected ObjectReader _newReader(DeserializationConfig config) - Les sous-classes de méthodes d'usine doivent être remplacées pour produire des instances ObjectReader du sous-type approprié |
| sept | protected ObjectReader _newReader(DeserializationConfig config, JavaType valueType, Object valueToUpdate, FormatSchema schema, InjectableValues injectableValues) - Les sous-classes de méthodes d'usine doivent être remplacées pour produire des instances ObjectReader du sous-type approprié |
| 8 | protected ObjectWriter _newWriter(SerializationConfig config) - Les sous-classes de méthodes d'usine doivent être remplacées pour produire des instances ObjectWriter du sous-type approprié |
| 9 | protected ObjectWriter _newWriter(SerializationConfig config, FormatSchema schema) - Les sous-classes de méthodes d'usine doivent être remplacées pour produire des instances ObjectWriter du sous-type approprié |
| dix | protected ObjectWriter _newWriter(SerializationConfig config, JavaType rootType, PrettyPrinter pp) - Les sous-classes de méthode d'usine doivent être remplacées pour produire des instances ObjectWriter du sous-type approprié. |
| 11 | protected Object _readMapAndClose(JsonParser p0, JavaType valueType) |
| 12 | protected Object _readValue(DeserializationConfig cfg, JsonParser p, JavaType valueType) - Implémentation réelle de la lecture de valeur + opération de liaison. |
| 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) - Méthode de visite de la hiérarchie des types pour un type donné, en utilisant le visiteur spécifié. |
| 17 | void acceptJsonFormatVisitor(JavaType type, JsonFormatVisitorWrapper visitor) - Méthode de visite de la hiérarchie des types pour un type donné, en utilisant le visiteur spécifié. |
| 18 | ObjectMapper addHandler(DeserializationProblemHandler h) - Méthode d'ajout de DeserializationProblemHandler spécifié à utiliser pour gérer des problèmes spécifiques lors de la désérialisation. |
| 19 | ObjectMapper addMixIn(Class<?> target, Class<?> mixinSource) - Méthode à utiliser pour ajouter des annotations de mixage à utiliser pour augmenter la classe ou l'interface spécifiée. |
| 20 | boolean canDeserialize(JavaType type) - Méthode qui peut être appelée pour vérifier si le mappeur pense pouvoir désérialiser un objet d'un type donné. |
| 21 | boolean canDeserialize(JavaType type, AtomicReference<Throwable> cause) - Méthode similaire à canDeserialize (JavaType) mais qui peut renvoyer le Throwable réel qui a été lancé lors de la tentative de construction du sérialiseur: cela peut être utile pour déterminer quel est le problème réel. |
| 22 | boolean canSerialize(Class<?> type) - Méthode qui peut être appelée pour vérifier si le mappeur pense pouvoir sérialiser une instance d'une classe donnée. |
| 23 | boolean canSerialize(Class<?> type, AtomicReference<Throwable> cause) - Méthode similaire à canSerialize (Class) mais qui peut renvoyer le Throwable réel qui a été lancé lors de la tentative de construction du sérialiseur: cela peut être utile pour déterminer quel est le problème réel. |
| 24 | ObjectMapper clearProblemHandlers() - Méthode de suppression de toutes les instances DeserializationProblemHandlers enregistrées de ce mappeur. |
| 25 | MutableConfigOverride configOverride(Classlt;?> type) - Accesseur pour obtenir un objet de remplacement de configuration mutable pour un type donné, nécessaire pour ajouter ou modifier les remplacements par type appliqués aux propriétés d'un type donné. |
| 26 | ObjectMapper configure(DeserializationFeature f, boolean state) - Méthode de changement d'état d'une fonction de désérialisation on / off pour ce mappeur d'objets. |
| 27 | ObjectMapper configure(JsonGenerator.Feature f, boolean state) - Méthode de modification de l'état d'une fonction JsonGenerator on / off pour les instances de générateur créées par ce mappeur d'objets. |
| 28 | ObjectMapper configure(JsonParser.Feature f, boolean state) - Méthode de modification de l'état de JsonParser spécifié.Caractéristiques pour les instances d'analyseur créées par ce mappeur d'objets. |
| 29 | ObjectMapper configure(MapperFeature f, boolean state) - Méthode de modification de l'état d'une fonction de mappeur on / off pour cette instance de mappeur. |
| 30 | ObjectMapper configure(SerializationFeature f, boolean state) - Méthode de changement d'état d'une fonction de sérialisation marche / arrêt pour ce mappeur d'objets. |
| 31 | JavaType constructType(Type t) - Méthode pratique pour construire JavaType à partir d'un type donné (généralement java.lang.Class), mais sans contexte explicite. |
| 32 | <T> T convertValue(Object fromValue, Class<T> toValueType) - Méthode pratique pour effectuer une conversion en deux étapes à partir d'une valeur donnée, en une instance d'un type de valeur donné, si (mais seulement si!) Une conversion est nécessaire. |
| 33 | <T> T convertValue(Object fromValue, JavaType toValueType) - Voir convertValue (Object, Class) |
| 34 | <T> T convertValue(Object fromValue, TypeReference<?> toValueTypeRef) - Voir convertValue (Object, Class) |
| 35 | ObjectMapper copy() - Méthode de création d'une nouvelle instance d'ObjectMapper ayant la même configuration initiale que cette instance. |
| 36 | ArrayNode createArrayNode() - Remarque: le type de retour est co-variant, car l'abstraction ObjectCodec de base ne peut pas faire référence à des types de nœuds concrets (car elle fait partie du package principal, alors que les impls font partie du package mapper) |
| 37 | ObjectNode createObjectNode() - Remarque: le type de retour est co-variant, car l'abstraction ObjectCodec de base ne peut pas faire référence à des types de nœuds concrets (car elle fait partie du package principal, alors que les impls font partie du package mapper) |
| 38 | protected ClassIntrospector defaultClassIntrospector() - Méthode d'assistance remplaçable utilisée pour construire le ClassIntrospector par défaut à utiliser. |
| 39 | ObjectMapper disable(DeserializationFeature feature) - Méthode d'activation des fonctionnalités de DeserializationConfig spécifiées. |
| 40 | ObjectMapper disable(DeserializationFeature first, DeserializationFeature... f) - Méthode d'activation des fonctionnalités de DeserializationConfig spécifiées. |
| 41 | ObjectMapper disable(JsonGenerator.Feature... features) - Méthode de désactivation de JsonGenerator spécifié. Fonctionnalités pour les instances d'analyseur créées par ce mappeur d'objet. |
| 42 | ObjectMapper disable(JsonParser.Feature... features) - Méthode de désactivation de JsonParser spécifiée. Fonctionnalités pour les instances d'analyseur créées par ce mappeur d'objets. |
| 43 | ObjectMapper disable(MapperFeature... f) - Méthode d'activation des fonctionnalités de DeserializationConfig spécifiées. |
| 44 | ObjectMapper disable(SerializationFeature f) - Méthode d'activation des fonctionnalités de DeserializationConfig spécifiées. |
| 45 | ObjectMapper disable(SerializationFeature first, SerializationFeature... f) - Méthode d'activation des fonctionnalités de DeserializationConfig spécifiées. |
| 46 | ObjectMapper disableDefaultTyping()- Méthode de désactivation de l'inclusion automatique des informations de type; si tel est le cas, seuls les types explicitement annotés (ceux avec JsonTypeInfo) auront des informations de type incorporées supplémentaires. |
| 47 | ObjectMapper enable(DeserializationFeature feature) - Méthode d'activation des fonctionnalités de DeserializationConfig spécifiées. |
| 48 | ObjectMapper enable(DeserializationFeature first, DeserializationFeature... f) - Méthode d'activation des fonctionnalités de DeserializationConfig spécifiées. |
| 49 | ObjectMapper enable(JsonGenerator.Feature... features) - Méthode d'activation de JsonGenerator.Features spécifiées pour les instances d'analyseur créées par ce mappeur d'objets. |
| 50 | ObjectMapper enable(JsonParser.Feature... features) - Méthode d'activation de JsonParser.Features spécifiées pour les instances d'analyseur créées par ce mappeur d'objets. |
| 51 | ObjectMapper enable(MapperFeature... f) - Méthode d'activation des fonctionnalités MapperConfig spécifiées. |
| 52 | ObjectMapper enable(SerializationFeature f) - Méthode d'activation de la fonctionnalité DeserializationConfig spécifiée. |
| 53 | ObjectMapper enable(SerializationFeature first, SerializationFeature... f) - Méthode d'activation des fonctionnalités de DeserializationConfig spécifiées. |
| 54 | ObjectMapper enableDefaultTyping() - Méthode pratique qui équivaut à appeler |
| 55 | ObjectMapper enableDefaultTyping(ObjectMapper.DefaultTyping dti) - Méthode pratique qui équivaut à appeler |
| 56 | ObjectMapper enableDefaultTyping(ObjectMapper.DefaultTyping applicability, JsonTypeInfo.As includeAs) - Méthode d'activation de l'inclusion automatique des informations de type, nécessaire pour la désérialisation correcte des types polymorphes (sauf si les types ont été annotés avec JsonTypeInfo). |
| 57 | ObjectMapper enableDefaultTypingAsProperty(ObjectMapper.DefaultTyping applicability, String propertyName) - Méthode pour activer l'inclusion automatique des informations de type - nécessaire pour une désérialisation correcte des types polymorphes (sauf si les types ont été annotés avec JsonTypeInfo) - en utilisant le mécanisme d'inclusion "As.PROPERTY" et le nom de propriété spécifié à utiliser pour l'inclusion (la valeur par défaut étant "@ class "puisque les informations de type par défaut utilisent toujours le nom de classe comme identificateur de type) |
| 58 | ObjectMapper findAndRegisterModules() - Méthode pratique qui est fonctionnellement équivalente à: mapper.registerModules (mapper.findModules ()); |
| 59 | Class<?> findMixInClassFor(Class<?> cls) |
| 60 | static List<Module> findModules() - Méthode de localisation des méthodes disponibles, à l'aide de la fonction JDK ServiceLoader, ainsi que du SPI fourni par le module. |
| 61 | static List<Module> findModules(ClassLoader classLoader) - Méthode de localisation des méthodes disponibles, à l'aide de la fonction JDK ServiceLoader, ainsi que du SPI fourni par le module. |
| 62 | DateFormat getDateFormat() |
| 63 | DeserializationConfig getDeserializationConfig() - Méthode qui renvoie l'objet DeserializationConfig par défaut partagé qui définit les paramètres de configuration pour la désérialisation. |
| 64 | DeserializationContext getDeserializationContext() - Méthode pour obtenir le DeserializationContext actuel. |
| 65 | JsonFactory getFactory() - Méthode qui peut être utilisée pour obtenir JsonFactory que ce mappeur utilise s'il a besoin de construire JsonParsers et / ou JsonGenerators. |
| 66 | InjectableValues getInjectableValues() |
| 67 | JsonFactory getJsonFactory()- Obsolète. Depuis la version 2.1: utilisez plutôt getFactory () |
| 68 | JsonNodeFactory getNodeFactory() - Méthode qui peut être utilisée pour obtenir JsonNodeFactory que ce mappeur utilisera lors de la construction directe d'instances JsonNode racine pour les arbres. |
| 69 | PropertyNamingStrategy getPropertyNamingStrategy() |
| 70 | SerializationConfig getSerializationConfig() - Méthode qui renvoie l'objet SerializationConfig par défaut partagé qui définit les paramètres de configuration pour la sérialisation. |
| 71 | SerializerFactory getSerializerFactory() - Méthode pour obtenir SerializerFactory actuel. |
| 72 | SerializerProvider getSerializerProvider() - Accesseur pour l'instance "blueprint" (ou, factory), à partir de laquelle les instances sont créées en appelant DefaultSerializerProvider.createInstance (com.fasterxml.jackson.databind.SerializationConfig, com.fasterxml.jackson.databind.ser.SerializerFactory). |
| 73 | SerializerProvider getSerializerProviderInstance() - Accesseur pour construire et renvoyer une instance SerializerProvider qui peut être utilisée pour accéder aux sérialiseurs. |
| 74 | SubtypeResolver getSubtypeResolver() - Méthode d'accès au résolveur de sous-type utilisé. |
| 75 | TypeFactory getTypeFactory() - Accesseur pour obtenir l'instance TypeFactory actuellement configurée. |
| 76 | VisibilityChecker<?> getVisibilityChecker()- Méthode d'accès au vérificateur de visibilité actuellement configuré; objet utilisé pour déterminer si un élément de propriété donné (méthode, champ, constructeur) peut être détecté automatiquement ou non. |
| 77 | boolean isEnabled(DeserializationFeature f) - Méthode pour vérifier si une fonctionnalité spécifique à la désérialisation est activée. |
| 78 | boolean isEnabled(JsonFactory.Feature f) - Méthode de commodité, équivalente à: |
| 79 | boolean isEnabled(JsonGenerator.Feature f) |
| 80 | boolean isEnabled(JsonParser.Feature f) |
| 81 | boolean isEnabled(MapperFeature f) - Méthode pour vérifier si MapperFeature donné est activé. |
| 82 | boolean isEnabled(SerializationFeature f) - Méthode pour vérifier si une fonction spécifique à la sérialisation est activée. |
| 83 | int mixInCount() |
| 84 | ObjectReader reader() - Méthode d'usine pour construire ObjectReader avec les paramètres par défaut. |
| 85 | ObjectReader reader(Base64Variant defaultBase64) - Méthode d'usine pour construire ObjectReader qui utilisera la variante de codage Base64 spécifiée pour les données binaires codées en Base64. |
| 86 | ObjectReader reader(Class<?> type)- Obsolète. Depuis 2.5, utilisez à la place readerFor (Class) |
| 87 | ObjectReader reader(ContextAttributes attrs) - Méthode d'usine pour construire ObjectReader qui utilisera les attributs par défaut spécifiés. |
| 88 | ObjectReader reader(DeserializationFeature feature) - Méthode d'usine pour construire ObjectReader avec la fonctionnalité spécifiée activée (par rapport aux paramètres de cette instance de mappeur). |
| 89 | ObjectReader reader(DeserializationFeature first, DeserializationFeature... other) - Méthode d'usine pour construire ObjectReader avec les fonctionnalités spécifiées activées (par rapport aux paramètres de cette instance de mappeur). |
| 90 | ObjectReader reader(FormatSchema schema) - Méthode d'usine pour construire ObjectReader qui passera un objet de schéma spécifique à JsonParser utilisé pour lire le contenu. |
| 91 | ObjectReader reader(InjectableValues injectableValues) - Méthode d'usine pour construire ObjectReader qui utilisera les valeurs injectables spécifiées. |
| 92 | ObjectReader reader(JavaType type)- Obsolète. Depuis 2.5, utilisez à la place readerFor (JavaType) |
| 93 | ObjectReader reader(JsonNodeFactory f) - Méthode d'usine pour la construction d'ObjectReader qui utilisera JsonNodeFactory spécifié pour la construction d'arbres JSON. |
| 94 | ObjectReader reader(TypeReference<?> type)- Obsolète. Depuis 2.5, utilisez à la place readerFor (TypeReference) |
| 95 | ObjectReader readerFor(Class<?> type) - Méthode d'usine pour construire ObjectReader qui lira ou mettra à jour des instances du type spécifié |
| 96 | ObjectReader readerFor(JavaType type) - Méthode d'usine pour construire ObjectReader qui lira ou mettra à jour des instances du type spécifié |
| 97 | ObjectReader readerFor(TypeReference<?> type) - Méthode d'usine pour construire ObjectReader qui lira ou mettra à jour des instances du type spécifié |
| 98 | ObjectReader readerForUpdating(Object valueToUpdate) - Méthode d'usine pour construire ObjectReader qui mettra à jour un objet donné (généralement Bean, mais peut également être une collection ou une carte, mais PAS un tableau) avec des données JSON. |
| 99 | ObjectReader readerWithView(Class<?> view) - Méthode d'usine pour la construction d'ObjectReader qui désérialise les objets à l'aide de la vue JSON spécifiée (filtre). |
| 100 | JsonNode readTree(byte[] content) - Méthode pour désérialiser le contenu JSON sous forme d'arborescence exprimée à l'aide d'un ensemble d'instances JsonNode. |
| 101 | JsonNode readTree(File file) - Méthode pour désérialiser le contenu JSON sous forme d'arborescence exprimée à l'aide d'un ensemble d'instances JsonNode. |
| 102 | JsonNode readTree(InputStream in) - Méthode pour désérialiser le contenu JSON sous forme d'arborescence exprimée à l'aide d'un ensemble d'instances JsonNode. |
| 103 | <T extends TreeNode> T readTree(JsonParser p) - Méthode pour désérialiser le contenu JSON sous forme d'arborescence exprimée à l'aide d'un ensemble d'instances JsonNode. |
| 104 | JsonNode readTree(Reader r) - Méthode pour désérialiser le contenu JSON sous forme d'arborescence exprimée à l'aide d'un ensemble d'instances JsonNode. |
| 105 | JsonNode readTree(String content) - Méthode pour désérialiser le contenu JSON sous forme d'arborescence exprimée à l'aide d'un ensemble d'instances JsonNode. |
| 106 | JsonNode readTree(URL source) - Méthode pour désérialiser le contenu JSON sous forme d'arborescence exprimée à l'aide d'un ensemble d'instances 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) - Méthode pour désérialiser le contenu JSON d'un fichier donné dans un type Java donné. |
| 116 | <T> T readValue(File src, JavaType valueType) - Méthode pour désérialiser le contenu JSON d'un fichier donné dans un type Java donné. |
| 117 | <T> T readValue(File src, TypeReference valueTypeRef) - Méthode pour désérialiser le contenu JSON d'un fichier donné dans un type Java donné. |
| 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) - Méthode surchargée de type sécurisé, essentiellement un alias pour readValue (JsonParser, Class). |
| 123 | <T> T readValue(JsonParser p, ResolvedType valueType) - Méthode pour désérialiser le contenu JSON en un type Java, dont la référence est passée en argument. |
| 124 | <T> T readValue(JsonParser p, TypeReference<?> valueTypeRef) - Méthode pour désérialiser le contenu JSON en un type Java, dont la référence est passée en argument. |
| 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) - Méthode pour désérialiser le contenu JSON à partir d'une chaîne de contenu JSON donnée. |
| 128 | <T> T readValue(String content, JavaType valueType) - Méthode pour désérialiser le contenu JSON à partir d'une chaîne de contenu JSON donnée. |
| 129 | <T> T readValue(String content, TypeReference valueTypeRef) - Méthode pour désérialiser le contenu JSON à partir d'une chaîne de contenu JSON donnée. |
| 130 | <T> T readValue(URL src, Class<T> valueType) - Méthode pour désérialiser le contenu JSON d'une ressource donnée dans un type Java donné. |
| 131 | <T> T readValue(URL src, JavaType valueType) |
| 132 | <T> T readValue(URL src, TypeReference valueTypeRef) - Méthode pour désérialiser le contenu JSON d'une ressource donnée dans un type Java donné. |
| 133 | <T> MappingIterator<T> readValues(JsonParser p, Class<T> valueType) - Méthode de confort, équivalente en fonction à: |
| 134 | <T> MappingIterator<T> readValues(JsonParser p, JavaType valueType) - Méthode de confort, équivalente en fonction à: |
| 135 | <T> MappingIterator<T> readValues(JsonParser p, ResolvedType valueType) - Méthode de confort, équivalente en fonction à: |
| 136 | <T> MappingIterator<T> readValues(JsonParser p, TypeReference<?>valueTypeRef) - Méthode de lecture de la séquence d'objets à partir du flux de l'analyseur. |
| 137 | ObjectMapper registerModule(Module module)- Méthode d'enregistrement d'un module pouvant étendre les fonctionnalités fournies par ce mappeur; par exemple, en ajoutant des fournisseurs pour les sérialiseurs et désérialiseurs personnalisés. |
| 138 | ObjectMapper registerModules(Iterable<Module> modules)- Méthode pratique pour enregistrer les modules spécifiés dans l'ordre; fonctionnellement équivalent à: |
| 139 | ObjectMapper registerModules(Module... modules)- Méthode pratique pour enregistrer les modules spécifiés dans l'ordre; fonctionnellement équivalent à: |
| 140 | void registerSubtypes(NamedType... types) - Méthode d'enregistrement de la classe spécifiée en tant que sous-type, de sorte que la résolution basée sur le nom de type puisse lier les supertypes à des sous-types (comme alternative à l'utilisation d'annotations). |
| 141 | ObjectMapper setAnnotationIntrospector(AnnotationIntrospector ai) - Méthode de définition d'AnnotationIntrospector utilisée par cette instance de mappeur pour la sérialisation et la désérialisation. |
| 142 | ObjectMapper setAnnotationIntrospectors(AnnotationIntrospector serializerAI, AnnotationIntrospector deserializerAI) - Méthode de modification des instances AnnotationIntrospector utilisée par cette instance de mappeur pour la sérialisation et la désérialisation, en les spécifiant séparément afin que différentes introspections puissent être utilisées pour différents aspects. |
| 143 | ObjectMapper setBase64Variant(Base64Variant v) - Méthode qui configurera Base64Variant par défaut que les sérialiseurs et désérialiseurs byte [] utiliseront. |
| 144 | ObjectMapper setConfig(DeserializationConfig config) - Méthode qui permet de remplacer l'objet DeserializationConfig sous-jacent. |
| 145 | ObjectMapper setConfig(SerializationConfig config) - Méthode qui permet de remplacer l'objet SerializationConfig sous-jacent, qui contient les paramètres de configuration spécifiques à la sérialisation. |
| 146 | ObjectMapper setDateFormat(DateFormat dateFormat) - Méthode de configuration du DateFormat par défaut à utiliser lors de la sérialisation des valeurs d'heure en tant que chaînes et de la désérialisation des chaînes JSON. |
| 147 | ObjectMapper setDefaultPrettyPrinter(PrettyPrinter pp) - Méthode de spécification de PrettyPrinter à utiliser lorsque "l'impression jolie par défaut" est activée (en activant SerializationFeature.INDENT_OUTPUT) |
| 148 | ObjectMapper setDefaultTyping(TypeResolverBuilder<?> typer) - Méthode pour activer l'inclusion automatique des informations de type, en utilisant un objet gestionnaire spécifié pour déterminer quels types cela affecte, ainsi que des détails sur la façon dont les informations sont incorporées. |
| 149 | ObjectMapper setFilterProvider(FilterProvider filterProvider) - Méthode de configuration de ce mappeur pour utiliser le FilterProvider spécifié pour mapper les ID de filtre aux instances de filtre réelles. |
| 150 | Object setHandlerInstantiator(HandlerInstantiator hi) - Méthode de configuration de HandlerInstantiator à utiliser pour créer des instances de gestionnaires (tels que des sérialiseurs, des désérialiseurs, des résolveurs d'id de type et de type), étant donné une classe. |
| 151 | ObjectMapper setInjectableValues(InjectableValues injectableValues) - Méthode de configuration des InjectableValues qui permettait de trouver des valeurs à injecter. |
| 152 | ObjectMapper setLocale(Locale l) - Méthode de remplacement des paramètres régionaux par défaut à utiliser pour le formatage. |
| 153 | void setMixInAnnotations(Map<Class<?>,Class<?>> sourceMixins)- Obsolète. Depuis 2.5: remplacé par une forme courante de la méthode; setMixIns (java.util.Map <java.lang.Class <?>, java.lang.Class <? >>). |
| 154 | ObjectMapper setMixInResolver(ClassIntrospector.MixInResolver resolver) - Méthode qui peut être appelée pour spécifier un résolveur donné pour localiser les classes de mixage à utiliser, en remplaçant les mappages directement ajoutés. |
| 155 | ObjectMapper setMixIns(Map<Class<?>,Class<?>> sourceMixins) - Méthode à utiliser pour définir les annotations de mixage à utiliser pour augmenter les annotations que possèdent les classes traitables (sérialisables / désérialisables). |
| 156 | ObjectMapper setNodeFactory(JsonNodeFactory f) - Méthode de spécification de JsonNodeFactory à utiliser pour construire des nœuds d'arborescence au niveau racine (via la méthode createObjectNode () |
| 157 | ObjectMapper setPropertyInclusion(JsonInclude.Value incl) - Méthode de définition de la stratégie d'inclusion de propriété POJO par défaut pour la sérialisation. |
| 158 | ObjectMapper setPropertyNamingStrategy(PropertyNamingStrategy s) - Méthode de définition de la stratégie de dénomination de propriété personnalisée à utiliser. |
| 159 | ObjectMapper setSerializationInclusion(JsonInclude.Include incl) - Méthode pratique, équivalente à l'appel: |
| 160 | ObjectMapper setSerializerFactory(SerializerFactory f) - Méthode de définition de SerializerFactory spécifique à utiliser pour la construction de sérialiseurs (bean). |
| 161 | ObjectMapper setSerializerProvider(DefaultSerializerProvider p) - Méthode de définition de l'instance SerializerProvider "blueprint" à utiliser comme base pour les instances de fournisseur réelles à utiliser pour gérer la mise en cache des instances JsonSerializer. |
| 162 | ObjectMapper setSubtypeResolver(SubtypeResolver str) - Méthode de définition du résolveur de sous-type personnalisé à utiliser. |
| 163 | ObjectMapper setTimeZone(TimeZone tz) - Méthode de remplacement de la zone horaire par défaut à utiliser pour le formatage. |
| 164 | ObjectMapper setTypeFactory(TypeFactory f) - Méthode qui peut être utilisée pour remplacer l'instance TypeFactory utilisée par ce mappeur. |
| 165 | ObjectMapper setVisibility(PropertyAccessor forMethod, JsonAutoDetect.Visibility visibility) - Méthode pratique qui permet de modifier la configuration des VisibilityCheckers sous-jacents, pour modifier les détails des types de propriétés détectés automatiquement. |
| 166 | ObjectMapper setVisibility(VisibilityChecker<?> vc) - Méthode de définition du VisibilityChecker actuellement configuré, objet utilisé pour déterminer si l'élément de propriété donné (méthode, champ, constructeur) peut être détecté automatiquement ou non. |
| 167 | void setVisibilityChecker(VisibilityChecker<?> vc)- Obsolète. Depuis 2.6, utilisez à la place setVisibility (VisibilityChecker). |
| 168 | JsonParser treeAsTokens(TreeNode n) - Méthode de construction d'un JsonParser à partir d'une représentation arborescente JSON. |
| 169 | <T> T treeToValue(TreeNode n, Class<T> valueType) - Méthode de conversion pratique qui liera les données que l'arborescence JSON contient dans un type de valeur spécifique (généralement un bean). |
| 170 | <T extends JsonNode> T valueToTree(Object fromValue)- Inverse de treeToValue (com.fasterxml.jackson.core.TreeNode, java.lang.Class <T>); étant donné une valeur (généralement bean), construira une représentation d'arbre JSON équivalente. |
| 171 | Version version() - Méthode qui retournera les informations de version stockées et lues à partir du fichier jar contenant cette classe. |
| 172 | ObjectWriter writer() - Méthode pratique pour construire ObjectWriter avec les paramètres par défaut. |
| 173 | ObjectWriter writer(Base64Variant defaultBase64) - Méthode d'usine pour construire ObjectWriter qui utilisera la variante de codage Base64 spécifiée pour les données binaires codées en Base64. |
| 174 | ObjectWriter writer(CharacterEscapes escapes) - |
| 175 | ObjectWriter writer(ContextAttributes attrs) - Méthode d'usine pour construire ObjectWriter qui utilisera les attributs par défaut spécifiés. |
| 176 | ObjectWriter writer(DateFormat df)- Méthode d'usine pour construire ObjectWriter qui sérialisera des objets en utilisant DateFormat spécifié; ou, si null est passé, à l'aide de l'horodatage (nombre 64 bits. |
| 177 | ObjectWriter writer(FilterProvider filterProvider) - Méthode d'usine pour construire ObjectWriter qui sérialisera les objets à l'aide du fournisseur de filtre spécifié. |
| 178 | ObjectWriter writer(FormatSchema schema) - Méthode d'usine pour construire ObjectWriter qui passera un objet de schéma spécifique à JsonGenerator utilisé pour écrire du contenu. |
| 179 | ObjectWriter writer(PrettyPrinter pp) - Méthode d'usine pour construire ObjectWriter qui sérialisera des objets en utilisant une jolie imprimante spécifiée pour l'indentation (ou si null, pas de jolie imprimante) |
| 180 | ObjectWriter writer(SerializationFeature feature) - Méthode d'usine pour construire ObjectWriter avec la fonctionnalité spécifiée activée (par rapport aux paramètres de cette instance de mappeur). |
| 181 | ObjectWriter writer(SerializationFeature first, SerializationFeature... other) - Méthode d'usine pour construire ObjectWriter avec les fonctionnalités spécifiées activées (par rapport aux paramètres de cette instance de mappeur). |
| 182 | ObjectWriter writerFor(Class<?> rootType) - Méthode d'usine pour la construction d'ObjectWriter qui sérialisera les objets en utilisant le type racine spécifié, au lieu du type d'exécution réel de valeur. |
| 183 | ObjectWriter writerFor(JavaType rootType) - Méthode d'usine pour la construction d'ObjectWriter qui sérialisera les objets en utilisant le type racine spécifié, au lieu du type d'exécution réel de valeur. |
| 184 | ObjectWriter writerFor(TypeReference<?> rootType) - Méthode d'usine pour la construction d'ObjectWriter qui sérialisera les objets en utilisant le type racine spécifié, au lieu du type d'exécution réel de valeur. |
| 185 | ObjectWriter writerWithDefaultPrettyPrinter() - Méthode d'usine pour construire ObjectWriter qui sérialisera des objets en utilisant la jolie imprimante par défaut pour l'indentation. |
| 186 | ObjectWriter writerWithType(Class<?> rootType)- Obsolète. Depuis la version 2.5, utilisez plutôt writerFor (Class). |
| 187 | ObjectWriter writerWithType(JavaType rootType)- Obsolète. Depuis la version 2.5, utilisez plutôt writerFor (JavaType). |
| 188 | ObjectWriter writerWithType(TypeReference<?> rootType)- Obsolète. Depuis la version 2.5, utilisez plutôt writerFor (TypeReference). |
| 189 | ObjectWriter writerWithView(Class<?> serializationView) - Méthode d'usine pour la construction d'ObjectWriter qui sérialisera les objets en utilisant la vue JSON spécifiée (filtre). |
| 190 | void writeTree(JsonGenerator jgen, JsonNode rootNode) - Méthode de sérialisation de l'arbre JSON donné, à l'aide du générateur fourni. |
| 191 | void writeTree(JsonGenerator jgen, TreeNode rootNode) |
| 192 | void writeValue(DataOutput out, Object value) |
| 193 | void writeValue(File resultFile, Object value) - Méthode qui peut être utilisée pour sérialiser toute valeur Java en tant que sortie JSON, écrite dans le fichier fourni. |
| 194 | void writeValue(JsonGenerator g, Object value) - Méthode qui peut être utilisée pour sérialiser toute valeur Java en tant que sortie JSON, en utilisant JsonGenerator fourni. |
| 195 | void writeValue(OutputStream out, Object value) - Méthode qui peut être utilisée pour sérialiser n'importe quelle valeur Java en tant que sortie JSON, en utilisant le flux de sortie fourni (en utilisant le codage JsonEncoding.UTF8). |
| 196 | void writeValue(Writer w, Object value) - Méthode qui peut être utilisée pour sérialiser toute valeur Java en tant que sortie JSON, à l'aide de Writer fourni. |
| 197 | byte[] writeValueAsBytes(Object value) - Méthode qui peut être utilisée pour sérialiser toute valeur Java sous forme de tableau d'octets. |
| 198 | String writeValueAsString(Object value) - Méthode qui peut être utilisée pour sérialiser toute valeur Java en tant que chaîne. |
Méthodes héritées
Cette classe hérite des méthodes des classes suivantes:
java.lang.Object
Exemple d'ObjectMapper
Créez le programme Java suivant en utilisant n'importe quel éditeur de votre choix dans say C:/> Jackson_WORKSPACE
Fichier: 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
Compilez les classes en utilisant javac compilateur comme suit:
C:\Jackson_WORKSPACE>javac JacksonTester.javaExécutez maintenant le jacksonTester pour voir le résultat:
C:\Jackson_WORKSPACE>java JacksonTesterVérifiez la sortie
Student [ name: Mahesh, age: 21 ]
{
"name" : "Mahesh",
"age" : 21
}