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, SerializableKlasy 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.javaTeraz uruchom test jacksonTester, aby zobaczyć wynik:
C:\Jackson_WORKSPACE>java JacksonTesterSprawdź dane wyjściowe
Student [ name: Mahesh, age: 21 ]
{
"name" : "Mahesh",
"age" : 21
}