Jackson - Classe ObjectMapper

Introdução

ObjectMapper é a classe de ator principal da biblioteca Jackson. Classe ObjectMapper ObjectMapper fornece funcionalidade para leitura e gravação de JSON, para e de POJOs básicos (Plain Old Java Objects), ou para e de um JSON Tree Model (JsonNode) de uso geral, bem como funcionalidade relacionada para executar conversões. Também é altamente personalizável para trabalhar com diferentes estilos de conteúdo JSON e para suportar conceitos de objeto mais avançados, como polimorfismo e identidade de objeto. ObjectMapper também atua como uma fábrica para classes ObjectReader e ObjectWriter mais avançadas.

Declaração de Classe

A seguir está a declaração para com.fasterxml.jackson.databind.ObjectMapper classe -

public class ObjectMapper
   extends ObjectCodec
      implements Versioned, Serializable

Classes aninhadas

S.No. Classe e descrição
1 static class ObjectMapper.DefaultTypeResolverBuilder

TypeResolverBuilder customizado que fornece construtores de resolvedor de tipo usados ​​com a chamada "digitação padrão" (consulte enableDefaultTyping () para obter detalhes).

2 static class ObjectMapper.DefaultTyping

Enumeração usada com enableDefaultTyping () para especificar para que tipo de tipos (classes) a digitação padrão deve ser usada.

Campos

  • protected DeserializationConfig _deserializationConfig - Objeto de configuração que define configurações globais básicas para o processo de serialização.

  • protected DefaultDeserializationContext _deserializationContext- Objeto de contexto Blueprint; armazenados aqui para permitir subclasses personalizadas.

  • protected InjectableValues _injectableValues - Provedor de valores para injetar em POJOs desserializados.

  • protected JsonFactory _jsonFactory - Fábrica usada para criar instâncias JsonParser e JsonGenerator conforme necessário.

  • protected SimpleMixInResolver _mixIns - Mapeamento que define como aplicar anotações mix-in: key é o tipo para anotações adicionais recebidas e value é o tipo que tem anotações para "mix in".

  • protected ConfigOverrides _propertyOverrides - Substituições de configuração por tipo atualmente ativas, acessadas por tipo declarado de propriedade.

  • protected Set<Object> _registeredModuleTypes - Conjunto de tipos de módulo (de acordo com Module.getTypeId () que foram registrados; monitorado iff MapperFeature.IGNORE_DUPLICATE_MODULE_REGISTRATIONS está habilitado, para que chamadas de registro duplicadas possam ser ignoradas (para evitar adicionar os mesmos manipuladores várias vezes, principalmente).

  • protected ConcurrentHashMap<JavaType,JsonDeserializer<Object>> _rootDeserializers - Usaremos um mapa de nível principal separado para controlar os desserializadores de nível raiz.

  • protected SerializationConfig _serializationConfig - Objeto de configuração que define configurações globais básicas para o processo de serialização.

  • protected SerializerFactory _serializerFactory - Fábrica de serializador usada para construir serializadores.

  • protected DefaultSerializerProvider _serializerProvider - Objeto que gerencia o acesso aos serializadores usados ​​para serialização, incluindo cache.

  • protected SubtypeResolver _subtypeResolver - Coisa usada para registrar subtipos, resolvendo-os em super / subtipos conforme necessário.

  • protected TypeFactory _typeFactory- Fábrica específica usada para criar instâncias JavaType; necessário para permitir que os módulos adicionem mais manipulação de tipo customizado (principalmente para suportar tipos de linguagens JVM não Java).

  • protected static AnnotationIntrospector DEFAULT_ANNOTATION_INTROSPECTOR

  • protected static BaseSettings DEFAULT_BASE - As configurações base contêm padrões usados ​​para todas as instâncias do ObjectMapper.

  • protected static VisibilityChecker<?> STD_VISIBILITY_CHECKER

Construtores

S.No. Construtor e descrição
1 ObjectMapper()

O construtor padrão, que construirá o JsonFactory padrão conforme necessário, usa SerializerProvider como seu SerializerProvider e BeanSerializerFactory como seu SerializerFactory.

2 ObjectMapper(JsonFactory jf)

Constrói uma instância que usa JsonFactory especificada para construir JsonParsers e / ou JsonGenerators necessários.

3 ObjectMapper(JsonFactory jf, SerializerProvider sp, DeserializerProvider dp)

Constrói uma instância que usa JsonFactory especificada para construir JsonParsers e / ou JsonGenerators necessários e usa provedores fornecidos para acessar serializadores e desserializadores.

4 protected ObjectMapper(ObjectMapper src)

Construtor de cópia, usado principalmente para oferecer suporte a copy ().

Métodos

Método auxiliar substituível usado para construir SerializerProvider a ser usado para serialização. void addMixInAnnotations (Class <?> target, Class <?> mixinSource) - Obsoleto. Desde 2.5: substituído por uma forma fluente do método; addMixIn (classe, classe). protegido DefaultDeserializationContext createDeserializationContext (JsonParser p, DeserializationConfig cfg) - Método auxiliar interno chamado para criar uma instância de DeserializationContext para desserializar um único valor de raiz. JsonSchema generateJsonSchema (Classe <?> T) - Obsoleto. Desde 2.6 use gerador de esquema JSON externo (https://github.com/FasterXML/jackson-module-jsonSchema) (que por baixo do capô chama acceptJsonFormatVisitor (JavaType, JsonFormatVisitorWrapper)) void registerSubtypes (Class <?> ... classes) - Método para registrar a classe especificada como um subtipo, de modo que a resolução baseada no nome do tipo possa vincular supertipos a subtipos (como uma alternativa ao uso de anotações). void setFilters (FilterProvider filterProvider) - Obsoleto. Desde 2.6, use setFilterProvider (com.fasterxml.jackson.databind.ser.FilterProvider) em vez (permite encadeamento) Método de fábrica para construir ObjectReader que usará detalhes de escape de caractere especificado para saída.
1 protected void _checkInvalidCopy(Class<?> exp)

2 protected void _configAndWriteValue(JsonGenerator g, Object value) - Método chamado para configurar o gerador conforme necessário e, em seguida, chamar a funcionalidade de gravação
3 protected Object _convert(Object fromValue, JavaType toValueType) - Implementação de conversão real: em vez de usar métodos existentes de leitura e gravação, grande parte do código é embutido.
4 protected JsonDeserializer<Object> _findRootDeserializer(DeserializationContext ctxt, JavaType valueType) - Método chamado para localizar o desserializador para o valor de nível raiz passado.
5 protected JsonToken _initForReading(JsonParser p) - Método chamado para garantir que determinado analisador está pronto para ler o conteúdo para vinculação de dados.
6 protected ObjectReader _newReader(DeserializationConfig config) - As subclasses do método de fábrica devem substituir, para produzir instâncias ObjectReader do subtipo adequado
7 protected ObjectReader _newReader(DeserializationConfig config, JavaType valueType, Object valueToUpdate, FormatSchema schema, InjectableValues injectableValues) - As subclasses do método de fábrica devem substituir, para produzir instâncias ObjectReader do subtipo adequado
8 protected ObjectWriter _newWriter(SerializationConfig config) - As subclasses do método de fábrica devem ser substituídas, para produzir instâncias ObjectWriter do subtipo adequado
9 protected ObjectWriter _newWriter(SerializationConfig config, FormatSchema schema) - As subclasses do método de fábrica devem ser substituídas, para produzir instâncias ObjectWriter do subtipo adequado
10 protected ObjectWriter _newWriter(SerializationConfig config, JavaType rootType, PrettyPrinter pp) - As subclasses do método de fábrica devem ser substituídas para produzir instâncias ObjectWriter do subtipo adequado.
11 protected Object _readMapAndClose(JsonParser p0, JavaType valueType)
12 protected Object _readValue(DeserializationConfig cfg, JsonParser p, JavaType valueType) - Implementação real da operação de leitura + ligação de valor.
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étodo de hierarquia de tipo de visita para determinado tipo, usando visitante especificado.
17 void acceptJsonFormatVisitor(JavaType type, JsonFormatVisitorWrapper visitor) - Método de hierarquia de tipo de visita para determinado tipo, usando visitante especificado.
18 ObjectMapper addHandler(DeserializationProblemHandler h) - Método para adicionar DeserializationProblemHandler especificado a ser usado para lidar com problemas específicos durante a desserialização.
19 ObjectMapper addMixIn(Class<?> target, Class<?> mixinSource) - Método a ser usado para adicionar anotações combinadas para usar para aumentar a classe ou interface especificada.
20 boolean canDeserialize(JavaType type) - Método que pode ser chamado para verificar se o mapeador acha que pode desserializar um objeto de determinado tipo.
21 boolean canDeserialize(JavaType type, AtomicReference<Throwable> cause) - Método semelhante a canDeserialize (JavaType), mas que pode retornar Throwable real que foi lançado ao tentar construir o serializador: isso pode ser útil para descobrir qual é o problema real.
22 boolean canSerialize(Class<?> type) - Método que pode ser chamado para verificar se o mapeador acha que pode serializar uma instância de determinada classe.
23 boolean canSerialize(Class<?> type, AtomicReference<Throwable> cause) - Método semelhante a canSerialize (Class), mas que pode retornar Throwable real que foi lançado ao tentar construir o serializador: isso pode ser útil para descobrir qual é o problema real.
24 ObjectMapper clearProblemHandlers() - Método para remover todas as instâncias DeserializationProblemHandlers registradas deste mapeador.
25 MutableConfigOverride configOverride(Classlt;?> type) - Acessador para obter um objeto de substituição de configuração mutável para determinado tipo, necessário para adicionar ou alterar substituições por tipo aplicadas a propriedades de determinado tipo.
26 ObjectMapper configure(DeserializationFeature f, boolean state) - Método para alterar o estado de um recurso de desserialização liga / desliga para este mapeador de objetos.
27 ObjectMapper configure(JsonGenerator.Feature f, boolean state) - Método para alterar o estado de um recurso JsonGenerator ligado / desligado para instâncias do gerador criadas por este mapeador de objetos.
28 ObjectMapper configure(JsonParser.Feature f, boolean state) - Método para alterar o estado de JsonParser.Features especificado para instâncias do analisador que este mapeador de objetos cria.
29 ObjectMapper configure(MapperFeature f, boolean state) - Método para alterar o estado de um recurso on / off do mapeador para esta instância do mapeador.
30 ObjectMapper configure(SerializationFeature f, boolean state) - Método para alterar o estado de um recurso de serialização liga / desliga para este mapeador de objetos.
31 JavaType constructType(Type t) - Método de conveniência para construir JavaType a partir de um determinado tipo (normalmente java.lang.Class), mas sem contexto explícito.
32 <T> T convertValue(Object fromValue, Class<T> toValueType) - Método de conveniência para fazer a conversão em duas etapas de determinado valor, em instância de determinado tipo de valor, se (mas somente se!) A conversão for necessária.
33 <T> T convertValue(Object fromValue, JavaType toValueType) - Veja convertValue (Object, Class)
34 <T> T convertValue(Object fromValue, TypeReference<?> toValueTypeRef) - Veja convertValue (Object, Class)
35 ObjectMapper copy() - Método para criar uma nova instância do ObjectMapper que possui a mesma configuração inicial desta instância.
36 ArrayNode createArrayNode() - Observação: o tipo de retorno é co-variante, já que a abstração ObjectCodec básica não pode se referir a tipos de nós concretos (já que é parte do pacote principal, enquanto impls faz parte do pacote mapeador)
37 ObjectNode createObjectNode() - Observação: o tipo de retorno é co-variante, já que a abstração ObjectCodec básica não pode se referir a tipos de nós concretos (já que é parte do pacote principal, enquanto impls faz parte do pacote mapeador)
38 protected ClassIntrospector defaultClassIntrospector() - Método auxiliar substituível usado para construir ClassIntrospector padrão a ser usado.
39 ObjectMapper disable(DeserializationFeature feature) - Método para habilitar recursos DeserializationConfig especificados.
40 ObjectMapper disable(DeserializationFeature first, DeserializationFeature... f) - Método para habilitar recursos DeserializationConfig especificados.
41 ObjectMapper disable(JsonGenerator.Feature... features) - Método para desativar JsonGenerator.Features especificado para instâncias do analisador que este mapeador de objeto cria.
42 ObjectMapper disable(JsonParser.Feature... features) - Método para desativar JsonParser.Features especificado para instâncias do analisador que este mapeador de objeto cria.
43 ObjectMapper disable(MapperFeature... f) - Método para habilitar recursos DeserializationConfig especificados.
44 ObjectMapper disable(SerializationFeature f) - Método para habilitar recursos DeserializationConfig especificados.
45 ObjectMapper disable(SerializationFeature first, SerializationFeature... f) - Método para habilitar recursos DeserializationConfig especificados.
46 ObjectMapper disableDefaultTyping()- Método para desabilitar a inclusão automática de informações de tipo; em caso afirmativo, apenas os tipos anotados explicitamente (aqueles com JsonTypeInfo) terão informações adicionais de tipo embutido.
47 ObjectMapper enable(DeserializationFeature feature) - Método para habilitar recursos DeserializationConfig especificados.
48 ObjectMapper enable(DeserializationFeature first, DeserializationFeature... f) - Método para habilitar recursos DeserializationConfig especificados.
49 ObjectMapper enable(JsonGenerator.Feature... features) - Método para habilitar JsonGenerator.Features especificado para instâncias do analisador que este mapeador de objetos cria.
50 ObjectMapper enable(JsonParser.Feature... features) - Método para habilitar JsonParser.Features especificado para instâncias do analisador que este mapeador de objetos cria.
51 ObjectMapper enable(MapperFeature... f) - Método para ativar os recursos MapperConfig especificados.
52 ObjectMapper enable(SerializationFeature f) - Método para ativar o recurso DeserializationConfig especificado.
53 ObjectMapper enable(SerializationFeature first, SerializationFeature... f) - Método para habilitar recursos DeserializationConfig especificados.
54 ObjectMapper enableDefaultTyping() - Método de conveniência que é equivalente a chamar
55 ObjectMapper enableDefaultTyping(ObjectMapper.DefaultTyping dti) - Método de conveniência que é equivalente a chamar
56 ObjectMapper enableDefaultTyping(ObjectMapper.DefaultTyping applicability, JsonTypeInfo.As includeAs) - Método para habilitar a inclusão automática de informações de tipo, necessárias para a desserialização adequada de tipos polimórficos (a menos que os tipos tenham sido anotados com JsonTypeInfo).
57 ObjectMapper enableDefaultTypingAsProperty(ObjectMapper.DefaultTyping applicability, String propertyName) - Método para habilitar a inclusão automática de informações de tipo - necessário para desserialização adequada de tipos polimórficos (a menos que os tipos tenham sido anotados com JsonTypeInfo) - usando o mecanismo de inclusão "As.PROPERTY" e o nome da propriedade especificada para usar para inclusão (o padrão é "@ class "já que a informação de tipo padrão sempre usa o nome da classe como identificador de tipo)
58 ObjectMapper findAndRegisterModules() - Método de conveniência funcionalmente equivalente a: mapper.registerModules (mapper.findModules ());
59 Class<?> findMixInClassFor(Class<?> cls)
60 static List<Module> findModules() - Método para localizar métodos disponíveis, usando o recurso JDK ServiceLoader, junto com o SPI fornecido pelo módulo.
61 static List<Module> findModules(ClassLoader classLoader) - Método para localizar métodos disponíveis, usando o recurso JDK ServiceLoader, junto com o SPI fornecido pelo módulo.
62 DateFormat getDateFormat()
63 DeserializationConfig getDeserializationConfig() - Método que retorna o objeto DeserializationConfig padrão compartilhado que define as configurações para desserialização.
64 DeserializationContext getDeserializationContext() - Método para obter DeserializationContext atual.
65 JsonFactory getFactory() - Método que pode ser usado para obter JsonFactory que este mapeador usa se precisar construir JsonParsers e / ou JsonGenerators.
66 InjectableValues getInjectableValues()
67 JsonFactory getJsonFactory()- Descontinuada. Desde 2.1: Use getFactory () ao invés
68 JsonNodeFactory getNodeFactory() - Método que pode ser usado para obter JsonNodeFactory que este mapeador usará ao construir diretamente instâncias JsonNode raiz para Árvores.
69 PropertyNamingStrategy getPropertyNamingStrategy()
70 SerializationConfig getSerializationConfig() - Método que retorna o objeto SerializationConfig padrão compartilhado que define as configurações para serialização.
71 SerializerFactory getSerializerFactory() - Método para obter a SerializerFactory atual.
72 SerializerProvider getSerializerProvider() - Acessador para a instância "blueprint" (ou fábrica), a partir da qual as instâncias são criadas chamando DefaultSerializerProvider.createInstance (com.fasterxml.jackson.databind.SerializationConfig, com.fasterxml.jackson.databind.ser.SerializerFactory).
73 SerializerProvider getSerializerProviderInstance() - Acessador para construir e retornar uma instância SerializerProvider que pode ser usada para acessar serializadores.
74 SubtypeResolver getSubtypeResolver() - Método para acessar o resolvedor de subtipo em uso.
75 TypeFactory getTypeFactory() - Acessador para obter a instância TypeFactory atualmente configurada.
76 VisibilityChecker<?> getVisibilityChecker()- Método para acessar o verificador de visibilidade atualmente configurado; objeto usado para determinar se determinado elemento de propriedade (método, campo, construtor) pode ser detectado automaticamente ou não.
77 boolean isEnabled(DeserializationFeature f) - Método para verificar se determinado recurso específico de desserialização está habilitado.
78 boolean isEnabled(JsonFactory.Feature f) - Método de conveniência, equivalente a:
79 boolean isEnabled(JsonGenerator.Feature f)
80 boolean isEnabled(JsonParser.Feature f)
81 boolean isEnabled(MapperFeature f) - Método para verificar se determinado MapperFeature está ativado.
82 boolean isEnabled(SerializationFeature f) - Método para verificar se determinado recurso específico de serialização está habilitado.
83 int mixInCount()
84 ObjectReader reader() - Método de fábrica para construir ObjectReader com configurações padrão.
85 ObjectReader reader(Base64Variant defaultBase64) - Método de fábrica para construir ObjectReader que usará a variante de codificação Base64 especificada para dados binários codificados por Base64.
86 ObjectReader reader(Class<?> type)- Descontinuada. Desde 2.5, use readerFor (Class) em vez
87 ObjectReader reader(ContextAttributes attrs) - Método de fábrica para construir ObjectReader que usará atributos padrão especificados.
88 ObjectReader reader(DeserializationFeature feature) - Método de fábrica para construir ObjectReader com o recurso especificado habilitado (em comparação com as configurações que esta instância do mapeador possui).
89 ObjectReader reader(DeserializationFeature first, DeserializationFeature... other) - Método de fábrica para construir ObjectReader com recursos especificados habilitados (em comparação com as configurações que esta instância do mapeador possui).
90 ObjectReader reader(FormatSchema schema) - Método de fábrica para construir ObjectReader que irá passar o objeto de esquema específico para JsonParser usado para ler o conteúdo.
91 ObjectReader reader(InjectableValues injectableValues) - Método de fábrica para construir ObjectReader que usará valores injetáveis ​​especificados.
92 ObjectReader reader(JavaType type)- Descontinuada. Desde 2.5, use readerFor (JavaType) em vez
93 ObjectReader reader(JsonNodeFactory f) - Método de fábrica para construir ObjectReader que usará JsonNodeFactory especificado para construir árvores JSON.
94 ObjectReader reader(TypeReference<?> type)- Descontinuada. Desde 2.5, use readerFor (TypeReference) em vez
95 ObjectReader readerFor(Class<?> type) - Método de fábrica para construir ObjectReader que irá ler ou atualizar instâncias do tipo especificado
96 ObjectReader readerFor(JavaType type) - Método de fábrica para construir ObjectReader que irá ler ou atualizar instâncias do tipo especificado
97 ObjectReader readerFor(TypeReference<?> type) - Método de fábrica para construir ObjectReader que irá ler ou atualizar instâncias do tipo especificado
98 ObjectReader readerForUpdating(Object valueToUpdate) - Método de fábrica para construir ObjectReader que atualizará determinado objeto (geralmente Bean, mas também pode ser uma coleção ou um mapa, mas NÃO um array) com dados JSON.
99 ObjectReader readerWithView(Class<?> view) - Método de fábrica para construir ObjectReader que desserializará objetos usando a Visualização JSON (filtro) especificada.
100 JsonNode readTree(byte[] content) - Método para desserializar o conteúdo JSON como árvore expressa usando um conjunto de instâncias JsonNode.
101 JsonNode readTree(File file) - Método para desserializar o conteúdo JSON como árvore expressa usando um conjunto de instâncias JsonNode.
102 JsonNode readTree(InputStream in) - Método para desserializar o conteúdo JSON como árvore expressa usando um conjunto de instâncias JsonNode.
103 <T extends TreeNode> T readTree(JsonParser p) - Método para desserializar o conteúdo JSON como árvore expressa usando um conjunto de instâncias JsonNode.
104 JsonNode readTree(Reader r) - Método para desserializar o conteúdo JSON como árvore expressa usando um conjunto de instâncias JsonNode.
105 JsonNode readTree(String content) - Método para desserializar o conteúdo JSON como árvore expressa usando um conjunto de instâncias JsonNode.
106 JsonNode readTree(URL source) - Método para desserializar o conteúdo JSON como árvore expressa usando um conjunto de instâncias 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étodo para desserializar o conteúdo JSON de determinado arquivo em determinado tipo Java.
116 <T> T readValue(File src, JavaType valueType) - Método para desserializar o conteúdo JSON de determinado arquivo em determinado tipo Java.
117 <T> T readValue(File src, TypeReference valueTypeRef) - Método para desserializar o conteúdo JSON de determinado arquivo em determinado tipo 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) - Método sobrecarregado de segurança de tipo, basicamente alias para readValue (JsonParser, Class).
123 <T> T readValue(JsonParser p, ResolvedType valueType) - Método para desserializar o conteúdo JSON em um tipo Java, referência ao qual é passada como argumento.
124 <T> T readValue(JsonParser p, TypeReference<?> valueTypeRef) - Método para desserializar o conteúdo JSON em um tipo Java, referência ao qual é passada como argumento.
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étodo para desserializar o conteúdo JSON de uma determinada String de conteúdo JSON.
128 <T> T readValue(String content, JavaType valueType) - Método para desserializar o conteúdo JSON de uma determinada String de conteúdo JSON.
129 <T> T readValue(String content, TypeReference valueTypeRef) - Método para desserializar o conteúdo JSON de uma determinada String de conteúdo JSON.
130 <T> T readValue(URL src, Class<T> valueType) - Método para desserializar o conteúdo JSON de determinado recurso em determinado tipo Java.
131 <T> T readValue(URL src, JavaType valueType)
132 <T> T readValue(URL src, TypeReference valueTypeRef) - Método para desserializar o conteúdo JSON de determinado recurso em determinado tipo Java.
133 <T> MappingIterator<T> readValues(JsonParser p, Class<T> valueType) - Método de conveniência, equivalente em função a:
134 <T> MappingIterator<T> readValues(JsonParser p, JavaType valueType) - Método de conveniência, equivalente em função a:
135 <T> MappingIterator<T> readValues(JsonParser p, ResolvedType valueType) - Método de conveniência, equivalente em função a:
136 <T> MappingIterator<T> readValues(JsonParser p, TypeReference<?>valueTypeRef) - Método para ler a sequência de objetos do fluxo do analisador.
137 ObjectMapper registerModule(Module module)- Método para registrar um módulo que pode estender a funcionalidade fornecida por este mapeador; por exemplo, adicionando provedores para serializadores e desserializadores personalizados.
138 ObjectMapper registerModules(Iterable<Module> modules)- Método de conveniência para registrar módulos especificados em ordem; funcionalmente equivalente a:
139 ObjectMapper registerModules(Module... modules)- Método de conveniência para registrar módulos especificados em ordem; funcionalmente equivalente a:
140 void registerSubtypes(NamedType... types) - Método para registrar a classe especificada como um subtipo, de modo que a resolução baseada no nome do tipo possa vincular supertipos a subtipos (como uma alternativa ao uso de anotações).
141 ObjectMapper setAnnotationIntrospector(AnnotationIntrospector ai) - Método para definir o AnnotationIntrospector usado por esta instância do mapeador para serialização e desserialização.
142 ObjectMapper setAnnotationIntrospectors(AnnotationIntrospector serializerAI, AnnotationIntrospector deserializerAI) - Método para alterar as instâncias do AnnotationIntrospector usado por esta instância do mapeador para serialização e desserialização, especificando-as separadamente para que diferentes introspecções possam ser usadas para diferentes aspectos.
143 ObjectMapper setBase64Variant(Base64Variant v) - Método que configurará Base64Variant padrão que os serializadores e desserializadores de byte [] usarão.
144 ObjectMapper setConfig(DeserializationConfig config) - Método que permite a substituição do objeto DeserializationConfig subjacente.
145 ObjectMapper setConfig(SerializationConfig config) - Método que permite a substituição do objeto SerializationConfig subjacente, que contém definições de configuração específicas da serialização.
146 ObjectMapper setDateFormat(DateFormat dateFormat) - Método para configurar o DateFormat padrão a ser usado ao serializar valores de tempo como Strings e desserializar de Strings JSON.
147 ObjectMapper setDefaultPrettyPrinter(PrettyPrinter pp) - Método para especificar PrettyPrinter a ser usado quando a "impressão bonita padrão" está ativada (ativando SerializationFeature.INDENT_OUTPUT)
148 ObjectMapper setDefaultTyping(TypeResolverBuilder<?> typer) - Método para habilitar a inclusão automática de informações de tipo, usando o objeto manipulador especificado para determinar quais tipos isso afeta, bem como detalhes de como as informações são incorporadas.
149 ObjectMapper setFilterProvider(FilterProvider filterProvider) - Método para configurar este mapeador para usar o FilterProvider especificado para mapear Ids de filtro para instâncias de filtro reais.
150 Object setHandlerInstantiator(HandlerInstantiator hi) - Método para configurar HandlerInstantiator a ser usado para criar instâncias de manipuladores (como serializadores, desserializadores, resolvedores de tipo e id de tipo), dada uma classe.
151 ObjectMapper setInjectableValues(InjectableValues injectableValues) - Método para configurar InjectableValues ​​que costumava encontrar valores para injetar.
152 ObjectMapper setLocale(Locale l) - Método para substituir a localidade padrão a ser usada para formatação.
153 void setMixInAnnotations(Map<Class<?>,Class<?>> sourceMixins)- Descontinuada. Desde 2.5: substituído por uma forma fluente do método; setMixIns (java.util.Map <java.lang.Class <?>, java.lang.Class <? >>).
154 ObjectMapper setMixInResolver(ClassIntrospector.MixInResolver resolver) - Método que pode ser chamado para especificar determinado resolvedor para localizar classes combinadas a serem usadas, substituindo mapeamentos adicionados diretamente.
155 ObjectMapper setMixIns(Map<Class<?>,Class<?>> sourceMixins) - Método a ser usado para definir anotações combinadas a serem usadas para aumentar as anotações que as classes processáveis ​​(serializáveis ​​/ desserializáveis) têm.
156 ObjectMapper setNodeFactory(JsonNodeFactory f) - Método para especificar JsonNodeFactory a ser usado para construir nós de árvore de nível raiz (via método createObjectNode ()
157 ObjectMapper setPropertyInclusion(JsonInclude.Value incl) - Método para definir a estratégia de inclusão de propriedade POJO padrão para serialização.
158 ObjectMapper setPropertyNamingStrategy(PropertyNamingStrategy s) - Método para definir a estratégia de nomenclatura de propriedade customizada a ser usada.
159 ObjectMapper setSerializationInclusion(JsonInclude.Include incl) - Método de conveniência, equivalente a chamar:
160 ObjectMapper setSerializerFactory(SerializerFactory f) - Método para definir SerializerFactory específico a ser usado para construir serializadores (bean).
161 ObjectMapper setSerializerProvider(DefaultSerializerProvider p) - Método para definir a instância SerializerProvider do "blueprint" a ser usada como base para as instâncias reais do provedor a serem usadas para manipular o cache de instâncias JsonSerializer.
162 ObjectMapper setSubtypeResolver(SubtypeResolver str) - Método para definir o resolvedor de subtipo personalizado a ser usado.
163 ObjectMapper setTimeZone(TimeZone tz) - Método para substituir o fuso horário padrão para usar na formatação.
164 ObjectMapper setTypeFactory(TypeFactory f) - Método que pode ser usado para substituir a instância TypeFactory usada por este mapeador.
165 ObjectMapper setVisibility(PropertyAccessor forMethod, JsonAutoDetect.Visibility visibility) - Método de conveniência que permite alterar a configuração de VisibilityCheckers subjacentes, para alterar os detalhes de quais tipos de propriedades são detectados automaticamente.
166 ObjectMapper setVisibility(VisibilityChecker<?> vc) - Método para definir VisibilityChecker atualmente configurado, objeto usado para determinar se determinado elemento de propriedade (método, campo, construtor) pode ser detectado automaticamente ou não.
167 void setVisibilityChecker(VisibilityChecker<?> vc)- Descontinuada. Desde o 2.6, use setVisibility (VisibilityChecker).
168 JsonParser treeAsTokens(TreeNode n) - Método para construir um JsonParser a partir da representação em árvore JSON.
169 <T> T treeToValue(TreeNode n, Class<T> valueType) - Método de conversão de conveniência que vinculará os dados fornecidos à árvore JSON em um tipo de valor específico (geralmente bean).
170 <T extends JsonNode> T valueToTree(Object fromValue)- Reverso de treeToValue (com.fasterxml.jackson.core.TreeNode, java.lang.Class <T>); dado um valor (geralmente bean), construirá uma representação de árvore JSON equivalente.
171 Version version() - Método que retornará informações de versão armazenadas e lidas no jar que contém essa classe.
172 ObjectWriter writer() - Método de conveniência para construir ObjectWriter com configurações padrão.
173 ObjectWriter writer(Base64Variant defaultBase64) - Método de fábrica para construir ObjectWriter que usará a variante de codificação Base64 especificada para dados binários codificados por Base64.
174 ObjectWriter writer(CharacterEscapes escapes) -
175 ObjectWriter writer(ContextAttributes attrs) - Método de fábrica para construir ObjectWriter que usará atributos padrão especificados.
176 ObjectWriter writer(DateFormat df)- Método de fábrica para construir ObjectWriter que serializará objetos usando DateFormat especificado; ou, se nulo passado, usando carimbo de data / hora (número de 64 bits.
177 ObjectWriter writer(FilterProvider filterProvider) - Método de fábrica para construir ObjectWriter que serializará objetos usando o provedor de filtro especificado.
178 ObjectWriter writer(FormatSchema schema) - Método de fábrica para construir ObjectWriter que passará o objeto de esquema específico para JsonGenerator usado para escrever conteúdo.
179 ObjectWriter writer(PrettyPrinter pp) - Método de fábrica para construir ObjectWriter que serializará objetos usando a impressora bonita especificada para recuo (ou se nulo, nenhuma impressora bonita)
180 ObjectWriter writer(SerializationFeature feature) - Método de fábrica para construir ObjectWriter com o recurso especificado ativado (em comparação com as configurações que esta instância do mapeador possui).
181 ObjectWriter writer(SerializationFeature first, SerializationFeature... other) - Método de fábrica para construir ObjectWriter com recursos especificados ativados (em comparação com as configurações que esta instância do mapeador possui).
182 ObjectWriter writerFor(Class<?> rootType) - Método de fábrica para construir ObjectWriter que serializará objetos usando o tipo de raiz especificado, em vez do tipo de valor de tempo de execução real.
183 ObjectWriter writerFor(JavaType rootType) - Método de fábrica para construir ObjectWriter que serializará objetos usando o tipo de raiz especificado, em vez do tipo de valor de tempo de execução real.
184 ObjectWriter writerFor(TypeReference<?> rootType) - Método de fábrica para construir ObjectWriter que serializará objetos usando o tipo de raiz especificado, em vez do tipo de valor de tempo de execução real.
185 ObjectWriter writerWithDefaultPrettyPrinter() - Método de fábrica para construir ObjectWriter que serializará objetos usando a bonita impressora padrão para indentação.
186 ObjectWriter writerWithType(Class<?> rootType)- Descontinuada. Desde 2.5, use writerFor (Class) em seu lugar.
187 ObjectWriter writerWithType(JavaType rootType)- Descontinuada. Desde 2.5, use o writerFor (JavaType) em seu lugar.
188 ObjectWriter writerWithType(TypeReference<?> rootType)- Descontinuada. Desde 2.5, use writerFor (TypeReference) em seu lugar.
189 ObjectWriter writerWithView(Class<?> serializationView) - Método de fábrica para construir ObjectWriter que serializará objetos usando a Visualização JSON (filtro) especificada.
190 void writeTree(JsonGenerator jgen, JsonNode rootNode) - Método para serializar determinada Árvore JSON, usando gerador fornecido.
191 void writeTree(JsonGenerator jgen, TreeNode rootNode)
192 void writeValue(DataOutput out, Object value)
193 void writeValue(File resultFile, Object value) - Método que pode ser usado para serializar qualquer valor Java como saída JSON, gravado no arquivo fornecido.
194 void writeValue(JsonGenerator g, Object value) - Método que pode ser usado para serializar qualquer valor Java como saída JSON, usando JsonGenerator fornecido.
195 void writeValue(OutputStream out, Object value) - Método que pode ser usado para serializar qualquer valor Java como saída JSON, usando o fluxo de saída fornecido (usando a codificação JsonEncoding.UTF8).
196 void writeValue(Writer w, Object value) - Método que pode ser usado para serializar qualquer valor Java como saída JSON, usando o Writer fornecido.
197 byte[] writeValueAsBytes(Object value) - Método que pode ser usado para serializar qualquer valor Java como uma matriz de bytes.
198 String writeValueAsString(Object value) - Método que pode ser usado para serializar qualquer valor Java como uma String.

Métodos herdados

Esta classe herda métodos das seguintes classes:

  • java.lang.Object

Exemplo de ObjectMapper

Crie o seguinte programa java usando qualquer editor de sua escolha em dizer C:/> Jackson_WORKSPACE

Arquivo: 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

Compile as classes usando javac compilador da seguinte forma:

C:\Jackson_WORKSPACE>javac JacksonTester.java

Agora execute o jacksonTester para ver o resultado:

C:\Jackson_WORKSPACE>java JacksonTester

Verifique a saída

Student [ name: Mahesh, age: 21 ]
{
  "name" : "Mahesh",
  "age" : 21
}