Джексон — Класс ObjectMapper

ObjectMapper — основной актерский класс библиотеки Джексона. Класс ObjectMapper ObjectMapper предоставляет функциональные возможности для чтения и записи JSON как в базовые объекты POJO (простые старые объекты Java), так и из общей модели дерева JSON (JsonNode), а также в связанные функции для выполнения преобразований. Он также обладает широкими возможностями настройки для работы как с различными стилями содержимого JSON, так и для поддержки более сложных концепций объектов, таких как полиморфизм и идентичность объектов. ObjectMapper также действует как фабрика для более продвинутых классов ObjectReader и ObjectWriter.

Декларация класса

Ниже приводится объявление для класса com.fasterxml.jackson.databind.ObjectMapper.

public class ObjectMapper
   extends ObjectCodec
      implements Versioned, Serializable

Вложенные классы

Настраиваемый TypeResolverBuilder, который предоставляет компоновщики распознавателя типов, используемые с так называемой «типизацией по умолчанию» (подробнее см. EnableDefaultTyping ()).

Перечисление, используемое с enableDefaultTyping (), чтобы указать, для каких типов (классов) следует использовать типизацию по умолчанию.

поля

• protected DeserializationConfig _deserializationConfig — объект конфигурации, который определяет основные глобальные параметры для процесса сериализации.

• защищенный DefaultDeserializationContext _deserializationContext — объект контекста Blueprint; хранится здесь, чтобы позволить пользовательские подклассы.

• protected InjectableValues ​​_injectableValues — Поставщик для значений для внедрения в десериализованные POJO.

• protected JsonFactory _jsonFactory — Фабрика, используемая для создания экземпляров JsonParser и JsonGenerator по мере необходимости.

• protected SimpleMixInResolver _mixIns — Сопоставление, которое определяет, как применять смешанные аннотации: ключ — это тип к полученным дополнительным аннотациям, а значение — это тип, который имеет аннотации для «смешивания».

• protected ConfigOverrides _propertyOverrides — в настоящее время активные переопределения конфигурации для типа, доступные по объявленному типу свойства.

• protected Set <Object> _registeredModuleTypes — Набор типов модулей (согласно Module.getTypeId (), которые были зарегистрированы; отслеживание iff MapperFeature.IGNORE_DUPLICATE_MODULE_REGISTRATIONS включен, так что дублирующие вызовы регистрации могут игнорироваться (чтобы избежать добавления одних и тех же обработчиков несколько раз) , в основном).

• protected ConcurrentHashMap <JavaType, JsonDeserializer <Object >> _rootDeserializer — мы будем использовать отдельную карту основного уровня для отслеживания десериализаторов корневого уровня.

• protected SerializationConfig _serializationConfig — Объект конфигурации, который определяет основные глобальные параметры для процесса сериализации.

• protected SerializerFactory _serializerFactory — Фабрика сериализатора, используемая для создания сериализаторов.

• protected DefaultSerializerProvider _serializerProvider — Объект, который управляет доступом к сериализаторам, используемым для сериализации, включая кеширование.

• protected SubtypeResolver _subtypeResolver — вещь, используемая для регистрации подтипов, разрешения их в супер / субтипы по мере необходимости.

• protected TypeFactory _typeFactory — Специальная фабрика, используемая для создания экземпляров JavaType; необходимо разрешить модулям добавлять больше пользовательских обработчиков типов (в основном для поддержки типов не Java-языков JVM).

• защищенная статическая аннотацияИнтроспектор DEFAULT_ANNOTATION_INTROSPECTOR

• Защищенные статические базовые параметры DEFAULT_BASE — базовые параметры содержат значения по умолчанию, используемые для всех экземпляров ObjectMapper.

• защищенный статический VisibilityChecker <?> STD_VISIBILITY_CHECKER

protected DeserializationConfig _deserializationConfig — объект конфигурации, который определяет основные глобальные параметры для процесса сериализации.

защищенный DefaultDeserializationContext _deserializationContext — объект контекста Blueprint; хранится здесь, чтобы позволить пользовательские подклассы.

protected InjectableValues ​​_injectableValues — Поставщик для значений для внедрения в десериализованные POJO.

protected JsonFactory _jsonFactory — Фабрика, используемая для создания экземпляров JsonParser и JsonGenerator по мере необходимости.

protected SimpleMixInResolver _mixIns — Сопоставление, которое определяет, как применять смешанные аннотации: ключ — это тип к полученным дополнительным аннотациям, а значение — это тип, который имеет аннотации для «смешивания».

protected ConfigOverrides _propertyOverrides — в настоящее время активные переопределения конфигурации для типа, доступные по объявленному типу свойства.

protected Set <Object> _registeredModuleTypes — Набор типов модулей (согласно Module.getTypeId (), которые были зарегистрированы; отслеживание iff MapperFeature.IGNORE_DUPLICATE_MODULE_REGISTRATIONS включен, так что дублирующие вызовы регистрации могут игнорироваться (чтобы избежать добавления одних и тех же обработчиков несколько раз) , в основном).

protected ConcurrentHashMap <JavaType, JsonDeserializer <Object >> _rootDeserializer — мы будем использовать отдельную карту основного уровня для отслеживания десериализаторов корневого уровня.

protected SerializationConfig _serializationConfig — Объект конфигурации, который определяет основные глобальные параметры для процесса сериализации.

protected SerializerFactory _serializerFactory — Фабрика сериализатора, используемая для создания сериализаторов.

protected DefaultSerializerProvider _serializerProvider — Объект, который управляет доступом к сериализаторам, используемым для сериализации, включая кеширование.

protected SubtypeResolver _subtypeResolver — вещь, используемая для регистрации подтипов, разрешения их в супер / субтипы по мере необходимости.

protected TypeFactory _typeFactory — Специальная фабрика, используемая для создания экземпляров JavaType; необходимо разрешить модулям добавлять больше пользовательских обработчиков типов (в основном для поддержки типов не Java-языков JVM).

защищенная статическая аннотацияИнтроспектор DEFAULT_ANNOTATION_INTROSPECTOR

Защищенные статические базовые параметры DEFAULT_BASE — базовые параметры содержат значения по умолчанию, используемые для всех экземпляров ObjectMapper.

защищенный статический VisibilityChecker <?> STD_VISIBILITY_CHECKER

Конструкторы

Конструктор по умолчанию, который будет создавать JsonFactory по умолчанию при необходимости, использует SerializerProvider в качестве своего SerializerProvider, а BeanSerializerFactory в качестве его SerializerFactory.

Создает экземпляр, который использует указанный JsonFactory для создания необходимых JsonParsers и / или JsonGenerators.

Создает экземпляр, который использует указанный JsonFactory для создания необходимых JsonParsers и / или JsonGenerators, и использует указанные провайдеры для доступа к сериализаторам и десериализаторам.

Copy-конструктор, в основном используется для поддержки copy ().

методы

Переопределяемый вспомогательный метод, используемый для создания SerializerProvider для использования для сериализации. void addMixInAnnotations (Class <?> target, Class <?> mixinSource) — устарело. Начиная с 2.5: заменена беглая форма метода; addMixIn (Класс, Класс). protected DefaultDeserializationContext createDeserializationContext (JsonParser p, DeserializationConfig cfg) — внутренний вспомогательный метод, вызываемый для создания экземпляра DeserializationContext для десериализации одного корневого значения. JsonSchema generateJsonSchema (Class <?> T) — устарело. Начиная с версии 2.6 используется внешний генератор JSON Schema (https://github.com/FasterXML/jackson-module-jsonSchema) (который под капотом вызывает acceptJsonFormatVisitor (JavaType, JsonFormatVisitorWrapper)) void registerSubtypes (Class <?> … classes) — Метод регистрации указанного класса в качестве подтипа, чтобы разрешение на основе типов имен могло связывать супертипы с подтипами (в качестве альтернативы использованию аннотаций). void setFilters (FilterProvider filterProvider) — устарел. Начиная с версии 2.6, вместо этого используйте setFilterProvider (com.fasterxml.jackson.databind.ser.FilterProvider) (позволяет связывать) Фабричный метод для создания ObjectReader, который будет использовать указанные символы, экранирующие детали для вывода.

Методы унаследованы

Этот класс наследует методы от следующих классов:

• java.lang.Object

java.lang.Object

ObjectMapper Example

Create the following java program using any editor of your choice in say C:/> Jackson_WORKSPACE

Файл: JacksonTester.java

 импорт java.io.IOException;

 import com.fasterxml.jackson.core.JsonParseException;
 import com.fasterxml.jackson.databind.JsonMappingException;
 import com.fasterxml.jackson.databind.ObjectMapper;

 открытый класс JacksonTester {
    public static void main (String args []) {
   
       ObjectMapper mapper = new ObjectMapper ();
       String jsonString = "{\" name \ ": \" Mahesh \ ", \" age \ ": 21}";
      
       // сопоставить JSON со студентом
       пытаться{
          Student student = mapper.readValue (jsonString, Student.class);
         
          System.out.println (студент);
         
          jsonString = mapper.writerWithDefaultPrettyPrinter (). writeValueAsString (student);
         
          System.out.println (jsonString);
       }
       catch (JsonParseException e) {e.printStackTrace ();}
       catch (JsonMappingException e) {e.printStackTrace ();  }
       catch (IOException e) {e.printStackTrace ();  }
    }
 }

 ученик класса {
    личное строковое имя;
    частный возраст;
    государственный студент () {}
    public String getName () {
       вернуть имя;
    }
    public void setName (String name) {
       this.name = имя;
    }
    public int getAge () {
       возвращаемый возраст;
    }
    public void setAge (int age) {
       this.age = возраст;
    }
    public String toString () {
       return "Студент [имя:" + имя + ", возраст:" + возраст + "]";
    }
 }

C:\Jackson_WORKSPACE>javac JacksonTester.java

C:\Jackson_WORKSPACE>java JacksonTester