Jackson - klasa ObjectMapper

Wprowadzenie

ObjectMapper to główna klasa aktorów w bibliotece Jacksona. Klasa ObjectMapper ObjectMapper zapewnia funkcje odczytu i zapisu JSON do i z podstawowych POJO (zwykłe stare obiekty Java) lub do i z modelu drzewa JSON ogólnego przeznaczenia (JsonNode), a także powiązane funkcje do wykonywania konwersji. Jest również wysoce konfigurowalny do pracy zarówno z różnymi stylami zawartości JSON, jak i do obsługi bardziej zaawansowanych koncepcji obiektów, takich jak polimorfizm i tożsamość obiektu. ObjectMapper działa również jako fabryka dla bardziej zaawansowanych klas ObjectReader i ObjectWriter.

Deklaracja klasy

Poniżej znajduje się deklaracja dla com.fasterxml.jackson.databind.ObjectMapper klasa -

public class ObjectMapper
   extends ObjectCodec
      implements Versioned, Serializable

Klasy zagnieżdżone

S.No. Klasa i opis
1 static class ObjectMapper.DefaultTypeResolverBuilder

Customized TypeResolverBuilder, który udostępnia konstruktory rozpoznawania typów używane z tak zwanym „domyślnym typowaniem” (szczegółowe informacje można znaleźć w sekcji enableDefaultTyping ()).

2 static class ObjectMapper.DefaultTyping

Wyliczenie używane z enableDefaultTyping () w celu określenia, jakiego rodzaju typy (klasy) mają być używane domyślne wpisywanie.

Pola

  • protected DeserializationConfig _deserializationConfig - Obiekt konfiguracyjny, który definiuje podstawowe ustawienia globalne procesu serializacji.

  • protected DefaultDeserializationContext _deserializationContext- obiekt kontekstu Blueprint; przechowywane tutaj, aby umożliwić niestandardowe podklasy.

  • protected InjectableValues _injectableValues - Dostawca wartości do wstrzyknięcia w zdeserializowanych POJO.

  • protected JsonFactory _jsonFactory - Fabryka używana do tworzenia wystąpień JsonParser i JsonGenerator w razie potrzeby.

  • protected SimpleMixInResolver _mixIns - Mapowanie, które definiuje sposób stosowania adnotacji mieszanych: klucz jest typem otrzymywanych dodatkowych adnotacji, a wartością jest typ, który ma adnotacje do „wmieszania”.

  • protected ConfigOverrides _propertyOverrides - Obecnie aktywne zastąpienia konfiguracji według typu, dostępne przez zadeklarowany typ właściwości.

  • protected Set<Object> _registeredModuleTypes - Zestaw typów modułów (zgodnie z Module.getTypeId (), które zostały zarejestrowane; śledzenie iff MapperFeature.IGNORE_DUPLICATE_MODULE_REGISTRATIONS jest włączone, dzięki czemu zduplikowane wywołania rejestracji mogą być ignorowane (aby uniknąć wielokrotnego dodawania tych samych programów obsługi, głównie).

  • protected ConcurrentHashMap<JavaType,JsonDeserializer<Object>> _rootDeserializers - Będziemy używać oddzielnej mapy głównego poziomu do śledzenia deserializatorów głównego poziomu.

  • protected SerializationConfig _serializationConfig - Obiekt konfiguracyjny, który definiuje podstawowe ustawienia globalne procesu serializacji.

  • protected SerializerFactory _serializerFactory - Fabryka serializatorów używana do budowy serializatorów.

  • protected DefaultSerializerProvider _serializerProvider - Obiekt zarządzający dostępem do serializatorów używanych do serializacji, w tym buforowania.

  • protected SubtypeResolver _subtypeResolver - Obiekt używany do rejestrowania podtypów, w razie potrzeby przekształcania ich w nadtypy / podtypy.

  • protected TypeFactory _typeFactory- Specjalna fabryka używana do tworzenia instancji JavaType; potrzebne, aby umożliwić modułom dodawanie większej liczby niestandardowych sposobów obsługi typów (głównie w celu obsługi typów języków JVM innych niż Java).

  • protected static AnnotationIntrospector DEFAULT_ANNOTATION_INTROSPECTOR

  • protected static BaseSettings DEFAULT_BASE - Ustawienia podstawowe zawierają wartości domyślne używane dla wszystkich instancji ObjectMapper.

  • protected static VisibilityChecker<?> STD_VISIBILITY_CHECKER

Konstruktorzy

S.No. Konstruktor i opis
1 ObjectMapper()

Konstruktor domyślny, który w razie potrzeby skonstruuje domyślną JsonFactory, używa SerializerProvider jako swojego SerializerProvider i BeanSerializerFactory jako jego SerializerFactory.

2 ObjectMapper(JsonFactory jf)

Konstruuje wystąpienie, które używa określonego JsonFactory do konstruowania niezbędnych JsonParsers i / lub JsonGenerators.

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

Konstruuje wystąpienie, które używa określonego JsonFactory do konstruowania niezbędnych JsonParsers i / lub JsonGenerators i używa danych dostawców do uzyskiwania dostępu do serializatorów i deserializatorów.

4 protected ObjectMapper(ObjectMapper src)

Konstruktor kopiujący, używany głównie do obsługi funkcji kopiowania ().

Metody

Zastępowalna metoda pomocnika używana do konstruowania SerializerProvider do użycia na potrzeby serializacji. void addMixInAnnotations (Class <?> target, Class <?> mixinSource) - przestarzałe. Od 2.5: zastąpiona płynną formą metody; addMixIn (klasa, klasa). protected DefaultDeserializationContext createDeserializationContext (JsonParser p, DeserializationConfig cfg) - wewnętrzna metoda pomocnika wywoływana w celu utworzenia wystąpienia DeserializationContext do deserializacji pojedynczej wartości głównej. JsonSchema generatedJsonSchema (Class <?> T) - przestarzałe. Od wersji 2.6 używaj zewnętrznego generatora schematów JSON (https://github.com/FasterXML/jackson-module-jsonSchema) (który pod maską wywołuje acceptJsonFormatVisitor (JavaType, JsonFormatVisitorWrapper)) void registerSubtypes (Class <?> ... classes) - Metoda rejestracji określonej klasy jako podtypu, dzięki czemu rozpoznawanie oparte na nazwie typu może łączyć nadtypy z podtypami (jako alternatywa dla używania adnotacji). void setFilters (FilterProvider filterProvider) - przestarzałe. Od wersji 2.6 zamiast tego należy używać metody setFilterProvider (com.fasterxml.jackson.databind.ser.FilterProvider) (umożliwia tworzenie łańcuchów) metody fabrycznej do konstruowania ObjectReader, która będzie używać określonych szczegółów ucieczki znaków na wyjściu.
1 protected void _checkInvalidCopy(Class<?> exp)

2 protected void _configAndWriteValue(JsonGenerator g, Object value) - Metoda wywoływana w celu skonfigurowania generatora w razie potrzeby, a następnie wywołania funkcji zapisu
3 protected Object _convert(Object fromValue, JavaType toValueType) - Rzeczywista implementacja konwersji: zamiast korzystać z istniejących metod odczytu i zapisu, znaczna część kodu jest wbudowana.
4 protected JsonDeserializer<Object> _findRootDeserializer(DeserializationContext ctxt, JavaType valueType) - Metoda wywołana w celu zlokalizowania deserializatora dla przekazanej wartości poziomu głównego.
5 protected JsonToken _initForReading(JsonParser p) - Metoda wywoływana w celu zapewnienia, że ​​dany parser jest gotowy do odczytu treści do powiązania danych.
6 protected ObjectReader _newReader(DeserializationConfig config) - Podklasy metod fabrycznych muszą przesłonić, aby utworzyć instancje ObjectReader odpowiedniego podtypu
7 protected ObjectReader _newReader(DeserializationConfig config, JavaType valueType, Object valueToUpdate, FormatSchema schema, InjectableValues injectableValues) - Podklasy metod fabrycznych muszą przesłonić, aby utworzyć instancje ObjectReader odpowiedniego podtypu
8 protected ObjectWriter _newWriter(SerializationConfig config) - Podklasy metod fabrycznych muszą przesłonić, aby utworzyć wystąpienia ObjectWriter odpowiedniego podtypu
9 protected ObjectWriter _newWriter(SerializationConfig config, FormatSchema schema) - Podklasy metod fabrycznych muszą przesłonić, aby utworzyć wystąpienia ObjectWriter odpowiedniego podtypu
10 protected ObjectWriter _newWriter(SerializationConfig config, JavaType rootType, PrettyPrinter pp) - Podklasy metod fabrycznych muszą przesłonić, aby utworzyć instancje ObjectWriter odpowiedniego podtypu.
11 protected Object _readMapAndClose(JsonParser p0, JavaType valueType)
12 protected Object _readValue(DeserializationConfig cfg, JsonParser p, JavaType valueType) - Rzeczywista realizacja odczytu wartości + operacja wiązania.
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) - Metoda hierarchii typów odwiedzin dla danego typu przy użyciu określonego gościa.
17 void acceptJsonFormatVisitor(JavaType type, JsonFormatVisitorWrapper visitor) - Metoda hierarchii typów odwiedzin dla danego typu przy użyciu określonego gościa.
18 ObjectMapper addHandler(DeserializationProblemHandler h) - Metoda dodawania określonego DeserializationProblemHandler, który ma być używany do obsługi określonych problemów podczas deserializacji.
19 ObjectMapper addMixIn(Class<?> target, Class<?> mixinSource) - Metoda używana do dodawania adnotacji dodawanych w celu rozszerzenia określonej klasy lub interfejsu.
20 boolean canDeserialize(JavaType type) - Metoda, którą można wywołać, aby sprawdzić, czy program mapujący uważa, że ​​może deserializować obiekt danego typu.
21 boolean canDeserialize(JavaType type, AtomicReference<Throwable> cause) - Metoda podobna do canDeserialize (JavaType), ale może zwrócić rzeczywisty Throwable, który został wyrzucony podczas próby skonstruowania serializatora: może to być przydatne przy ustalaniu, na czym polega rzeczywisty problem.
22 boolean canSerialize(Class<?> type) - Metoda, którą można wywołać, aby sprawdzić, czy program mapujący uważa, że ​​może serializować wystąpienie danej klasy.
23 boolean canSerialize(Class<?> type, AtomicReference<Throwable> cause) - Metoda podobna do canSerialize (Class), ale może zwrócić rzeczywisty Throwable, który został wyrzucony podczas próby skonstruowania serializatora: może to być przydatne w ustaleniu, jaki jest rzeczywisty problem.
24 ObjectMapper clearProblemHandlers() - Metoda usuwania wszystkich zarejestrowanych instancji DeserializationProblemHandlers z tego programu mapującego.
25 MutableConfigOverride configOverride(Classlt;?> type) - Accessor do uzyskiwania zmiennego obiektu przesłaniającego konfigurację dla danego typu, potrzebnego do dodania lub zmiany przesłonięć według typu zastosowanych do właściwości danego typu.
26 ObjectMapper configure(DeserializationFeature f, boolean state) - Metoda zmiany stanu włączania / wyłączania funkcji deserializacji dla tego mapowania obiektów.
27 ObjectMapper configure(JsonGenerator.Feature f, boolean state) - Metoda zmiany stanu włączania / wyłączania funkcji JsonGenerator dla instancji generatora tworzonych przez ten obiekt mapujący.
28 ObjectMapper configure(JsonParser.Feature f, boolean state) - Metoda zmiany stanu określonego JsonParser.Features dla instancji parsera tworzonych przez ten obiekt mapujący.
29 ObjectMapper configure(MapperFeature f, boolean state) - Metoda zmiany stanu włączonej / wyłączonej funkcji mapowania dla tej instancji mapera.
30 ObjectMapper configure(SerializationFeature f, boolean state) - Metoda zmiany stanu włączania / wyłączania funkcji serializacji dla tego mapowania obiektów.
31 JavaType constructType(Type t) - Wygodna metoda konstruowania JavaType z danego typu (zwykle java.lang.Class), ale bez jawnego kontekstu.
32 <T> T convertValue(Object fromValue, Class<T> toValueType) - Wygodna metoda wykonywania dwuetapowej konwersji z podanej wartości na instancję danego typu wartości, jeśli (ale tylko wtedy!) Konwersja jest potrzebna.
33 <T> T convertValue(Object fromValue, JavaType toValueType) - Zobacz convertValue (Object, Class)
34 <T> T convertValue(Object fromValue, TypeReference<?> toValueTypeRef) - Zobacz convertValue (Object, Class)
35 ObjectMapper copy() - Metoda tworzenia nowej instancji ObjectMapper, która ma taką samą konfigurację początkową, jak ta instancja.
36 ArrayNode createArrayNode() - Uwaga: typ zwracany jest kowarianty, ponieważ podstawowa abstrakcja ObjectCodec nie może odnosić się do konkretnych typów węzłów (ponieważ jest częścią pakietu podstawowego, podczas gdy impls są częścią pakietu mapper)
37 ObjectNode createObjectNode() - Uwaga: typ zwracany jest kowarianty, ponieważ podstawowa abstrakcja ObjectCodec nie może odnosić się do konkretnych typów węzłów (ponieważ jest częścią pakietu podstawowego, podczas gdy impls są częścią pakietu mapper)
38 protected ClassIntrospector defaultClassIntrospector() - zastępowalna metoda pomocnicza używana do konstruowania domyślnego ClassIntrospectora do użycia.
39 ObjectMapper disable(DeserializationFeature feature) - Metoda włączania określonych funkcji DeserializationConfig.
40 ObjectMapper disable(DeserializationFeature first, DeserializationFeature... f) - Metoda włączania określonych funkcji DeserializationConfig.
41 ObjectMapper disable(JsonGenerator.Feature... features) - Metoda wyłączania określonego JsonGenerator.Features dla wystąpień parsera, które tworzy ten obiekt mapujący.
42 ObjectMapper disable(JsonParser.Feature... features) - Metoda wyłączania określonego JsonParser.Features dla instancji parsera, które tworzy ten obiekt mapujący.
43 ObjectMapper disable(MapperFeature... f) - Metoda włączania określonych funkcji DeserializationConfig.
44 ObjectMapper disable(SerializationFeature f) - Metoda włączania określonych funkcji DeserializationConfig.
45 ObjectMapper disable(SerializationFeature first, SerializationFeature... f) - Metoda włączania określonych funkcji DeserializationConfig.
46 ObjectMapper disableDefaultTyping()- Metoda wyłączania automatycznego dołączania informacji o typie; jeśli tak, tylko typy z adnotacjami jawnymi (te z JsonTypeInfo) będą miały dodatkowe osadzone informacje o typie.
47 ObjectMapper enable(DeserializationFeature feature) - Metoda włączania określonych funkcji DeserializationConfig.
48 ObjectMapper enable(DeserializationFeature first, DeserializationFeature... f) - Metoda włączania określonych funkcji DeserializationConfig.
49 ObjectMapper enable(JsonGenerator.Feature... features) - Metoda włączania określonego JsonGenerator.Features dla wystąpień parsera, które tworzy ten obiekt mapujący.
50 ObjectMapper enable(JsonParser.Feature... features) - Metoda włączania określonych JsonParser.Features dla wystąpień parsera, które tworzy ten obiekt mapujący.
51 ObjectMapper enable(MapperFeature... f) - Metoda włączania określonych funkcji MapperConfig.
52 ObjectMapper enable(SerializationFeature f) - Metoda włączania określonej funkcji DeserializationConfig.
53 ObjectMapper enable(SerializationFeature first, SerializationFeature... f) - Metoda włączania określonych funkcji DeserializationConfig.
54 ObjectMapper enableDefaultTyping() - Wygodna metoda, która jest równoważna z dzwonieniem
55 ObjectMapper enableDefaultTyping(ObjectMapper.DefaultTyping dti) - Wygodna metoda, która jest równoważna z dzwonieniem
56 ObjectMapper enableDefaultTyping(ObjectMapper.DefaultTyping applicability, JsonTypeInfo.As includeAs) - Metoda umożliwiająca automatyczne dołączanie informacji o typie, potrzebnych do właściwej deserializacji typów polimorficznych (chyba że typy zostały opatrzone adnotacją JsonTypeInfo).
57 ObjectMapper enableDefaultTypingAsProperty(ObjectMapper.DefaultTyping applicability, String propertyName) - Metoda włączania automatycznego dołączania informacji o typie - potrzebna do właściwej deserializacji typów polimorficznych (chyba że typy zostały opatrzone adnotacją JsonTypeInfo) - użycie mechanizmu włączania "As.PROPERTY" i określonej nazwy właściwości do użycia (domyślnie "@ class ”, ponieważ domyślne informacje o typie zawsze używają nazwy klasy jako identyfikatora typu)
58 ObjectMapper findAndRegisterModules() - Wygodna metoda, która jest funkcjonalnym odpowiednikiem: mapper.registerModules (mapper.findModules ());
59 Class<?> findMixInClassFor(Class<?> cls)
60 static List<Module> findModules() - Metoda lokalizowania dostępnych metod, wykorzystująca narzędzie JDK ServiceLoader wraz z dostarczanym przez moduł SPI.
61 static List<Module> findModules(ClassLoader classLoader) - Metoda lokalizowania dostępnych metod, wykorzystująca narzędzie JDK ServiceLoader wraz z dostarczanym przez moduł SPI.
62 DateFormat getDateFormat()
63 DeserializationConfig getDeserializationConfig() - Metoda, która zwraca udostępniony domyślny obiekt DeserializationConfig, który definiuje ustawienia konfiguracji dla deserializacji.
64 DeserializationContext getDeserializationContext() - Metoda uzyskiwania bieżącego kontekstu deserializacji.
65 JsonFactory getFactory() - Metoda, której można użyć do uzyskania JsonFactory, z którego korzysta ten program odwzorowujący, jeśli musi skonstruować JsonParsers i / lub JsonGenerators.
66 InjectableValues getInjectableValues()
67 JsonFactory getJsonFactory()- wycofane. Od 2.1: Zamiast tego użyj metody getFactory ()
68 JsonNodeFactory getNodeFactory() - Metoda, której można użyć do uzyskania JsonNodeFactory, której ten program odwzorowujący będzie używał podczas bezpośredniego konstruowania głównych instancji JsonNode dla drzew.
69 PropertyNamingStrategy getPropertyNamingStrategy()
70 SerializationConfig getSerializationConfig() - Metoda, która zwraca udostępniony domyślny obiekt SerializationConfig, który definiuje ustawienia konfiguracji dla serializacji.
71 SerializerFactory getSerializerFactory() - Metoda uzyskiwania aktualnego SerializerFactory.
72 SerializerProvider getSerializerProvider() - Akcesor dla instancji „blueprint” (lub fabryki), z której instancje są tworzone przez wywołanie DefaultSerializerProvider.createInstance (com.fasterxml.jackson.databind.SerializationConfig, com.fasterxml.jackson.databind.ser.SerializerFactory).
73 SerializerProvider getSerializerProviderInstance() - Accessor do tworzenia i zwracania wystąpienia SerializerProvider, które może być używane do uzyskiwania dostępu do serializatorów.
74 SubtypeResolver getSubtypeResolver() - Metoda uzyskiwania dostępu do używanego programu rozpoznawania podtypów.
75 TypeFactory getTypeFactory() - Accessor do pobierania aktualnie skonfigurowanej instancji TypeFactory.
76 VisibilityChecker<?> getVisibilityChecker()- Metoda dostępu do aktualnie skonfigurowanego narzędzia do sprawdzania widoczności; obiekt używany do określenia, czy dany element właściwości (metoda, pole, konstruktor) może być automatycznie wykrywany, czy nie.
77 boolean isEnabled(DeserializationFeature f) - Metoda sprawdzania, czy dana funkcja specyficzna dla deserializacji jest włączona.
78 boolean isEnabled(JsonFactory.Feature f) - Metoda wygodna, odpowiednik:
79 boolean isEnabled(JsonGenerator.Feature f)
80 boolean isEnabled(JsonParser.Feature f)
81 boolean isEnabled(MapperFeature f) - Metoda sprawdzania, czy dana funkcja MapperFeature jest włączona.
82 boolean isEnabled(SerializationFeature f) - Metoda sprawdzania, czy dana funkcja specyficzna dla serializacji jest włączona.
83 int mixInCount()
84 ObjectReader reader() - Fabryczna metoda tworzenia ObjectReadera z domyślnymi ustawieniami.
85 ObjectReader reader(Base64Variant defaultBase64) - Fabryczna metoda konstruowania ObjectReader, która będzie używać określonego wariantu kodowania Base64 dla danych binarnych zakodowanych w formacie Base64.
86 ObjectReader reader(Class<?> type)- wycofane. Od wersji 2.5 zamiast tego użyj readerFor (Class)
87 ObjectReader reader(ContextAttributes attrs) - Fabryczna metoda konstruowania ObjectReader, która będzie używać określonych atrybutów domyślnych.
88 ObjectReader reader(DeserializationFeature feature) - Fabryczna metoda konstruowania ObjectReader z włączoną określoną funkcją (w porównaniu z ustawieniami, które ma ta instancja mapowania).
89 ObjectReader reader(DeserializationFeature first, DeserializationFeature... other) - Fabryczna metoda konstruowania ObjectReader z włączonymi określonymi funkcjami (w porównaniu z ustawieniami, które ma ta instancja mapowania).
90 ObjectReader reader(FormatSchema schema) - Fabryczna metoda konstruowania ObjectReader, która przekaże określony obiekt schematu do JsonParser używanego do odczytu treści.
91 ObjectReader reader(InjectableValues injectableValues) - Fabryczna metoda konstruowania ObjectReader, która będzie używać określonych wartości do wstrzykiwania.
92 ObjectReader reader(JavaType type)- wycofane. Od wersji 2.5 zamiast tego użyj readerFor (JavaType)
93 ObjectReader reader(JsonNodeFactory f) - Fabryczna metoda konstruowania ObjectReader, która będzie używać określonej JsonNodeFactory do konstruowania drzew JSON.
94 ObjectReader reader(TypeReference<?> type)- wycofane. Od wersji 2.5 zamiast tego użyj readerFor (TypeReference)
95 ObjectReader readerFor(Class<?> type) - Fabryczna metoda konstruowania ObjectReader, która odczyta lub zaktualizuje instancje określonego typu
96 ObjectReader readerFor(JavaType type) - Fabryczna metoda konstruowania ObjectReader, która odczyta lub zaktualizuje instancje określonego typu
97 ObjectReader readerFor(TypeReference<?> type) - Fabryczna metoda konstruowania ObjectReader, która odczyta lub zaktualizuje instancje określonego typu
98 ObjectReader readerForUpdating(Object valueToUpdate) - Fabryczna metoda konstruowania ObjectReader, która zaktualizuje dany Object (zwykle Bean, ale może być również Collection lub Map, ale NIE tablicą) z danymi JSON.
99 ObjectReader readerWithView(Class<?> view) - Fabryczna metoda konstruowania ObjectReader, która będzie deserializować obiekty przy użyciu określonego widoku JSON (filtr).
100 JsonNode readTree(byte[] content) - Metoda deserializacji zawartości JSON jako drzewa wyrażona za pomocą zestawu instancji JsonNode.
101 JsonNode readTree(File file) - Metoda deserializacji zawartości JSON jako drzewa wyrażona za pomocą zestawu instancji JsonNode.
102 JsonNode readTree(InputStream in) - Metoda deserializacji zawartości JSON jako drzewa wyrażona za pomocą zestawu instancji JsonNode.
103 <T extends TreeNode> T readTree(JsonParser p) - Metoda deserializacji zawartości JSON jako drzewa wyrażona za pomocą zestawu instancji JsonNode.
104 JsonNode readTree(Reader r) - Metoda deserializacji zawartości JSON jako drzewa wyrażona za pomocą zestawu instancji JsonNode.
105 JsonNode readTree(String content) - Metoda deserializacji zawartości JSON jako drzewa wyrażona za pomocą zestawu instancji JsonNode.
106 JsonNode readTree(URL source) - Metoda deserializacji zawartości JSON jako drzewa wyrażona za pomocą zestawu instancji 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) - Metoda deserializacji zawartości JSON z podanego pliku do danego typu Java.
116 <T> T readValue(File src, JavaType valueType) - Metoda deserializacji zawartości JSON z podanego pliku do danego typu Java.
117 <T> T readValue(File src, TypeReference valueTypeRef) - Metoda deserializacji zawartości JSON z podanego pliku do danego typu 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) - Przeciążona metoda bezpieczna dla typów, w zasadzie alias dla readValue (JsonParser, Class).
123 <T> T readValue(JsonParser p, ResolvedType valueType) - Metoda deserializacji treści JSON do typu Java, do którego odwołanie jest przekazywane jako argument.
124 <T> T readValue(JsonParser p, TypeReference<?> valueTypeRef) - Metoda deserializacji treści JSON do typu Java, do którego odwołanie jest przekazywane jako 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) - Metoda deserializacji zawartości JSON z danego ciągu zawartości JSON.
128 <T> T readValue(String content, JavaType valueType) - Metoda deserializacji zawartości JSON z danego ciągu zawartości JSON.
129 <T> T readValue(String content, TypeReference valueTypeRef) - Metoda deserializacji zawartości JSON z danego ciągu zawartości JSON.
130 <T> T readValue(URL src, Class<T> valueType) - Metoda deserializacji treści JSON z danego zasobu do danego typu Java.
131 <T> T readValue(URL src, JavaType valueType)
132 <T> T readValue(URL src, TypeReference valueTypeRef) - Metoda deserializacji treści JSON z danego zasobu do danego typu Java.
133 <T> MappingIterator<T> readValues(JsonParser p, Class<T> valueType) - Metoda wygodna, funkcjonalnie równoważna z:
134 <T> MappingIterator<T> readValues(JsonParser p, JavaType valueType) - Metoda wygodna, funkcjonalnie równoważna z:
135 <T> MappingIterator<T> readValues(JsonParser p, ResolvedType valueType) - Metoda wygodna, funkcjonalnie równoważna z:
136 <T> MappingIterator<T> readValues(JsonParser p, TypeReference<?>valueTypeRef) - Metoda odczytu sekwencji obiektów ze strumienia parsera.
137 ObjectMapper registerModule(Module module)- Metoda rejestracji modułu, który może rozszerzyć funkcjonalność zapewnianą przez ten mapper; na przykład dodając dostawców dla niestandardowych serializatorów i deserializatorów.
138 ObjectMapper registerModules(Iterable<Module> modules)- Wygodna metoda rejestracji określonych modułów w zamówieniu; funkcjonalnie równoważne z:
139 ObjectMapper registerModules(Module... modules)- Wygodna metoda rejestracji określonych modułów w zamówieniu; funkcjonalnie równoważne z:
140 void registerSubtypes(NamedType... types) - Metoda rejestracji określonej klasy jako podtypu, dzięki czemu rozpoznawanie oparte na nazwie typu może łączyć nadtypy z podtypami (jako alternatywa dla używania adnotacji).
141 ObjectMapper setAnnotationIntrospector(AnnotationIntrospector ai) - Metoda ustawiania AnnotationIntrospector używanej przez tę instancję programu odwzorowującego zarówno do serializacji, jak i deserializacji.
142 ObjectMapper setAnnotationIntrospectors(AnnotationIntrospector serializerAI, AnnotationIntrospector deserializerAI) - Metoda zmiany instancji AnnotationIntrospector używanych przez tę instancję programu odwzorowującego do serializacji i deserializacji, określając je osobno, aby można było użyć różnych introspekcji dla różnych aspektów.
143 ObjectMapper setBase64Variant(Base64Variant v) - Metoda, która skonfiguruje domyślną Base64Variant używaną przez serializatory bajtów [] i deserializatory.
144 ObjectMapper setConfig(DeserializationConfig config) - Metoda, która umożliwia przesłanianie podstawowego obiektu DeserializationConfig.
145 ObjectMapper setConfig(SerializationConfig config) - Metoda, która umożliwia zastąpienie podstawowego obiektu SerializationConfig, który zawiera ustawienia konfiguracji specyficzne dla serializacji.
146 ObjectMapper setDateFormat(DateFormat dateFormat) - Metoda konfigurowania domyślnego DateFormat do użycia podczas serializacji wartości czasu jako ciągów i deserializacji z ciągów JSON.
147 ObjectMapper setDefaultPrettyPrinter(PrettyPrinter pp) - Metoda określania PrettyPrinter do użycia, gdy włączone jest „domyślne drukowanie ładnie” (przez włączenie SerializationFeature.INDENT_OUTPUT)
148 ObjectMapper setDefaultTyping(TypeResolverBuilder<?> typer) - Metoda umożliwiająca automatyczne dołączanie informacji o typie, przy użyciu określonego obiektu obsługi do określania, na które typy ma to wpływ, a także szczegóły dotyczące osadzania informacji.
149 ObjectMapper setFilterProvider(FilterProvider filterProvider) - Metoda konfigurowania tego programu odwzorowującego tak, aby używał określonego elementu FilterProvider do mapowania identyfikatorów filtru na rzeczywiste wystąpienia filtru.
150 Object setHandlerInstantiator(HandlerInstantiator hi) - Metoda konfigurowania HandlerInstantiator do użycia do tworzenia wystąpień programów obsługi (takich jak serializatory, deserializatory, programy rozpoznawania typu i identyfikatora typu), dana klasa.
151 ObjectMapper setInjectableValues(InjectableValues injectableValues) - Metoda konfigurowania InjectableValues, która służyła do znajdowania wartości do wstrzyknięcia.
152 ObjectMapper setLocale(Locale l) - Metoda nadpisywania domyślnych ustawień regionalnych w celu formatowania.
153 void setMixInAnnotations(Map<Class<?>,Class<?>> sourceMixins)- wycofane. Od 2.5: zastąpiona płynną formą metody; setMixIns (java.util.Map <java.lang.Class <?>, java.lang.Class <? >>).
154 ObjectMapper setMixInResolver(ClassIntrospector.MixInResolver resolver) - Metoda, którą można wywołać, aby określić dany mechanizm rozpoznawania nazw w celu zlokalizowania używanych klas mieszanych, przesłaniając bezpośrednio dodane mapowania.
155 ObjectMapper setMixIns(Map<Class<?>,Class<?>> sourceMixins) - Metoda używana do definiowania dodanych adnotacji do użycia w celu rozszerzenia adnotacji, które mają klasy przetwarzalne (serializowalne / deserializowalne).
156 ObjectMapper setNodeFactory(JsonNodeFactory f) - Metoda określania JsonNodeFactory do użycia do konstruowania węzłów drzewa poziomu głównego (za pomocą metody createObjectNode ()
157 ObjectMapper setPropertyInclusion(JsonInclude.Value incl) - Metoda ustawiania domyślnej strategii włączania właściwości POJO do serializacji.
158 ObjectMapper setPropertyNamingStrategy(PropertyNamingStrategy s) - Metoda ustawiania strategii nazewnictwa właściwości niestandardowych do użycia.
159 ObjectMapper setSerializationInclusion(JsonInclude.Include incl) - Metoda wygodna, odpowiednik wywołania:
160 ObjectMapper setSerializerFactory(SerializerFactory f) - Metoda ustawiania określonego SerializerFactory do użycia do konstruowania serializatorów (bean).
161 ObjectMapper setSerializerProvider(DefaultSerializerProvider p) - Metoda ustawiania "blueprint" instancji SerializerProvider jako podstawy dla rzeczywistych instancji dostawcy do obsługi buforowania instancji JsonSerializer.
162 ObjectMapper setSubtypeResolver(SubtypeResolver str) - Metoda ustawiania niestandardowego mechanizmu rozpoznawania podtypów do użycia.
163 ObjectMapper setTimeZone(TimeZone tz) - Metoda nadpisywania domyślnej strefy czasowej do użycia do formatowania.
164 ObjectMapper setTypeFactory(TypeFactory f) - Metoda, której można użyć do przesłonięcia wystąpienia TypeFactory używanego przez ten program odwzorowujący.
165 ObjectMapper setVisibility(PropertyAccessor forMethod, JsonAutoDetect.Visibility visibility) - Wygodna metoda, która umożliwia zmianę konfiguracji dla bazowych VisibilityCheckers, aby zmienić szczegóły tego, jakie rodzaje właściwości są automatycznie wykrywane.
166 ObjectMapper setVisibility(VisibilityChecker<?> vc) - Metoda ustawiania aktualnie skonfigurowanego VisibilityChecker, obiektu używanego do określenia, czy dany element właściwości (metoda, pole, konstruktor) może być automatycznie wykrywany, czy nie.
167 void setVisibilityChecker(VisibilityChecker<?> vc)- wycofane. Od wersji 2.6 zamiast tego użyj setVisibility (VisibilityChecker).
168 JsonParser treeAsTokens(TreeNode n) - Metoda konstruowania JsonParser z reprezentacji drzewa JSON.
169 <T> T treeToValue(TreeNode n, Class<T> valueType) - Wygodna metoda konwersji, która będzie wiązać dane zawarte w drzewie JSON w określony typ wartości (zwykle bean).
170 <T extends JsonNode> T valueToTree(Object fromValue)- Odwrotność treeToValue (com.fasterxml.jackson.core.TreeNode, java.lang.Class <T>); dana wartość (zwykle bean), skonstruuje równoważną reprezentację JSON Tree.
171 Version version() - Metoda, która zwróci informacje o wersji przechowywane i odczytywane z pliku jar zawierającego tę klasę.
172 ObjectWriter writer() - Wygodna metoda tworzenia ObjectWriter z domyślnymi ustawieniami.
173 ObjectWriter writer(Base64Variant defaultBase64) - Fabryczna metoda konstruowania ObjectWriter, która będzie używać określonego wariantu kodowania Base64 dla danych binarnych zakodowanych w formacie Base64.
174 ObjectWriter writer(CharacterEscapes escapes) -
175 ObjectWriter writer(ContextAttributes attrs) - Fabryczna metoda konstruowania ObjectWriter, która będzie używać określonych atrybutów domyślnych.
176 ObjectWriter writer(DateFormat df)- Fabryczna metoda konstruowania ObjectWriter, która będzie serializować obiekty przy użyciu określonego DateFormat; lub, jeśli przekazano wartość null, przy użyciu znacznika czasu (liczba 64-bitowa.
177 ObjectWriter writer(FilterProvider filterProvider) - Fabryczna metoda konstruowania ObjectWriter, która będzie serializować obiekty przy użyciu określonego dostawcy filtru.
178 ObjectWriter writer(FormatSchema schema) - Fabryczna metoda konstruowania ObjectWriter, która przekaże określony obiekt schematu do JsonGenerator używanego do pisania treści.
179 ObjectWriter writer(PrettyPrinter pp) - Fabryczna metoda konstruowania ObjectWriter, która będzie serializować obiekty przy użyciu określonej ładnej drukarki do wcięcia (lub jeśli null, nie będzie ładnej drukarki)
180 ObjectWriter writer(SerializationFeature feature) - Fabryczna metoda konstruowania ObjectWriter z włączoną określoną funkcją (w porównaniu z ustawieniami, które ma ta instancja mapowania).
181 ObjectWriter writer(SerializationFeature first, SerializationFeature... other) - Fabryczna metoda konstruowania ObjectWriter z włączonymi określonymi funkcjami (w porównaniu z ustawieniami, które ma ta instancja mapowania).
182 ObjectWriter writerFor(Class<?> rootType) - Fabryczna metoda konstruowania ObjectWriter, która będzie serializować obiekty przy użyciu określonego typu głównego zamiast rzeczywistego typu wartości w czasie wykonywania.
183 ObjectWriter writerFor(JavaType rootType) - Fabryczna metoda konstruowania ObjectWriter, która będzie serializować obiekty przy użyciu określonego typu głównego zamiast rzeczywistego typu wartości w czasie wykonywania.
184 ObjectWriter writerFor(TypeReference<?> rootType) - Fabryczna metoda konstruowania ObjectWriter, która będzie serializować obiekty przy użyciu określonego typu głównego zamiast rzeczywistego typu wartości w czasie wykonywania.
185 ObjectWriter writerWithDefaultPrettyPrinter() - Fabryczna metoda konstruowania ObjectWriter, która będzie serializować obiekty przy użyciu domyślnej drukarki Pretty do wcięć.
186 ObjectWriter writerWithType(Class<?> rootType)- wycofane. Od wersji 2.5 zamiast tego użyj writerFor (Class).
187 ObjectWriter writerWithType(JavaType rootType)- wycofane. Od wersji 2.5 zamiast tego użyj writerFor (JavaType).
188 ObjectWriter writerWithType(TypeReference<?> rootType)- wycofane. Od wersji 2.5 zamiast tego użyj writerFor (TypeReference).
189 ObjectWriter writerWithView(Class<?> serializationView) - Fabryczna metoda konstruowania ObjectWriter, która będzie serializować obiekty przy użyciu określonego widoku JSON (filtr).
190 void writeTree(JsonGenerator jgen, JsonNode rootNode) - Metoda serializacji danego drzewa JSON przy użyciu dostarczonego generatora.
191 void writeTree(JsonGenerator jgen, TreeNode rootNode)
192 void writeValue(DataOutput out, Object value)
193 void writeValue(File resultFile, Object value) - Metoda, której można użyć do serializacji dowolnej wartości Java jako danych wyjściowych JSON, zapisanych w podanym pliku.
194 void writeValue(JsonGenerator g, Object value) - Metoda, której można użyć do serializacji dowolnej wartości Java jako danych wyjściowych JSON, przy użyciu dostarczonego JsonGenerator.
195 void writeValue(OutputStream out, Object value) - Metoda, której można użyć do serializacji dowolnej wartości Java jako danych wyjściowych JSON, przy użyciu dostarczonego strumienia wyjściowego (przy użyciu kodowania JsonEncoding.UTF8).
196 void writeValue(Writer w, Object value) - Metoda, której można użyć do serializacji dowolnej wartości Java jako danych wyjściowych JSON przy użyciu dostarczonego narzędzia Writer.
197 byte[] writeValueAsBytes(Object value) - Metoda, której można użyć do serializacji dowolnej wartości Java jako tablicy bajtów.
198 String writeValueAsString(Object value) - Metoda, której można użyć do serializacji dowolnej wartości Java jako ciągu.

Dziedziczone metody

Ta klasa dziedziczy metody z następujących klas:

  • java.lang.Object

Przykład ObjectMapper

Utwórz następujący program java, używając dowolnego wybranego edytora, powiedzmy C:/> Jackson_WORKSPACE

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

Skompiluj klasy przy użyciu javac kompilator w następujący sposób:

C:\Jackson_WORKSPACE>javac JacksonTester.java

Teraz uruchom test jacksonTester, aby zobaczyć wynik:

C:\Jackson_WORKSPACE>java JacksonTester

Sprawdź dane wyjściowe

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