Jackson - ObjectMapper 类
简介
ObjectMapper是Jackson库的主要参与者类。 ObjectMapper 类 ObjectMapper 提供了在基本 POJO(普通旧 Java 对象)之间或从通用 JSON 树模型 (JsonNode) 之间读取和写入 JSON 的功能,以及用于执行转换的相关功能。 它还具有高度可定制性,可以处理不同样式的 JSON 内容,并支持更高级的对象概念,例如多态性和对象标识。 ObjectMapper 还充当更高级的 ObjectReader 和 ObjectWriter 类的工厂。
类声明
以下是 com.fasterxml.jackson.databind.ObjectMapper 类的声明 −
public class ObjectMapper extends ObjectCodec implements Versioned, Serializable
嵌套类
S.No. | 类和描述 |
---|---|
1 | static class ObjectMapper.DefaultTypeResolverBuilder
自定义 TypeResolverBuilder,提供与所谓的"默认类型"一起使用的类型解析器构建器(有关详细信息,请参阅enableDefaultTyping())。 |
2 | static class ObjectMapper.DefaultTyping
与enableDefaultTyping()一起使用的枚举来指定应使用默认类型的类型(类)。 |
字段
protected DeserializationConfig _deserializationConfig - 配置对象,定义序列化过程的基本全局设置。
protected DefaultDeserializationContext_deserializationContext - 蓝图上下文对象; 存储在这里以允许自定义子类。
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>> _rootDeserializers - 我们将使用一个单独的主级映射来跟踪根级反序列化器。
protected SerializationConfig _serializationConfig - 定义序列化过程的基本全局设置的配置对象。
protected SerializerFactory _serializerFactory - 用于构造序列化器的序列化器工厂。
protected DefaultSerializerProvider _serializerProvider - 管理对用于序列化的序列化程序(包括缓存)的访问的对象。
protected SubtypeResolver _subtypeResolver - 用于注册子类型,根据需要将它们解析为超级/子类型的东西。
protected TypeFactory _typeFactory - 用于创建 JavaType 实例的特定工厂; 需要允许模块添加更多自定义类型处理(主要是为了支持非 Java JVM 语言的类型)。
protected static AnnotationIntrospector DEFAULT_ANNOTATION_INTROSPECTOR
protected static BaseSettings DEFAULT_BASE - 基本设置包含用于所有 ObjectMapper 实例的默认值。
protected static VisibilityChecker<?> STD_VISIBILITY_CHECKER
构造函数
S.No. | 构造函数 & 说明 |
---|---|
1 | ObjectMapper() 默认构造函数,将根据需要构造默认的 JsonFactory,使用 SerializerProvider 作为其 SerializerProvider,使用 BeanSerializerFactory 作为其 SerializerFactory。 |
2 | ObjectMapper(JsonFactory jf) 构造实例,该实例使用指定的 JsonFactory 来构造必要的 JsonParsers 和/或 JsonGenerators。 td> |
3 | ObjectMapper(JsonFactory jf, SerializerProvider sp, DeserializerProvider dp) 构造实例,该实例使用指定的 JsonFactory 来构造必要的 JsonParsers 和/或 JsonGenerators, 并使用给定的提供程序来访问序列化器和反序列化器。 |
4 | protected ObjectMapper(ObjectMapper src) 复制构造函数,主要用于支持 copy()。 |
方法
1 | protected void _checkInvalidCopy(Class<?> exp) |
2 | protected void _configAndWriteValue(JsonGenerator g, Object value) - 调用方法来根据需要配置生成器,然后调用写入功能 |
3 | protected Object _convert(Object fromValue, JavaType toValueType) - 实际转换实现:大部分代码是内联的,而不是使用现有的读写方法。 |
4 | protected JsonDeserializer<Object> _findRootDeserializer(DeserializationContext ctxt, JavaType valueType) - 调用方法来定位传递的根级值的反序列化器。 |
5 | protected JsonToken _initForReading(JsonParser p) - 调用方法以确保给定的解析器已准备好读取数据绑定的内容。 |
6 | protected ObjectReader _newReader(DeserializationConfig config) - 工厂方法子类必须重写,以生成正确子类型的 ObjectReader 实例 |
7 | protected ObjectReader _newReader(DeserializationConfig config, JavaType valueType, Object valueToUpdate, FormatSchema schema, InjectableValues injectableValues) - 工厂方法子类必须重写,以生成正确子类型的 ObjectReader 实例 |
8 | protected ObjectWriter _newWriter(SerializationConfig config) - 工厂方法子类必须重写,以生成正确子类型的 ObjectWriter 实例 |
9 | protected ObjectWriter _newWriter(SerializationConfig config, FormatSchema schema) - 工厂方法子类必须重写,以生成正确子类型的 ObjectWriter 实例 |
10 | protected ObjectWriter _newWriter(SerializationConfig config, JavaType rootType, PrettyPrinter pp) - 工厂方法子类必须重写,以生成正确子类型的 ObjectWriter 实例。 |
11 | protected Object _readMapAndClose(JsonParser p0, JavaType valueType) |
12 | protected Object _readValue(DeserializationConfig cfg, JsonParser p, JavaType valueType) - 实际实现读值+绑定操作。 |
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) - 使用指定访问者访问给定类型的类型层次结构的方法。 |
17 | void acceptJsonFormatVisitor(JavaType type, JsonFormatVisitorWrapper visitor) - 使用指定访问者访问给定类型的类型层次结构的方法。 |
18 | ObjectMapper addHandler(DeserializationProblemHandler h) - 添加指定DeserializationProblemHandler的方法,用于处理反序列化过程中的特定问题。 |
19 | ObjectMapper addMixIn(Class<?> target, Class<?> mixinSource) - 用于添加混合注释以用于增强指定类或接口的方法。 |
20 | boolean canDeserialize(JavaType type) -可以调用该方法来检查映射器是否认为它可以反序列化给定类型的对象。 |
21 | boolean canDeserialize(JavaType type, AtomicReference<Throwable> cause) - 与 canDeserialize(JavaType) 类似的方法,但可以返回尝试构造序列化器时抛出的实际 Throwable:这可能有助于找出实际问题是什么。 |
22 | boolean canSerialize(Class<?> type) - 可以调用该方法来检查映射器是否认为它可以序列化给定类的实例。 |
23 | boolean canSerialize(Class<?> type, AtomicReference<Throwable> cause) - 与 canSerialize(Class) 类似的方法,但可以返回尝试构造序列化器时抛出的实际 Throwable:这可能有助于找出实际问题是什么。 |
24 | ObjectMapper clearProblemHandlers() - 从此映射器中删除所有注册的 DeserializationProblemHandlers 实例的方法。 |
25 | MutableConfigOverride configOverride(Classlt;?> type) - 用于获取给定类型的可变配置覆盖对象的访问器,需要添加或更改应用于给定类型的属性的每个类型覆盖。 |
26 | ObjectMapper configure(DeserializationFeature f, boolean state) - 更改此对象映射器的开/关反序列化功能状态的方法。 |
27 | ObjectMapper configure(JsonGenerator.Feature f, boolean state) - 用于更改此对象映射器创建的生成器实例的开/关 JsonGenerator 功能状态的方法。 |
28 | ObjectMapper configure(JsonParser.Feature f, boolean state) - 用于更改指定 JsonParser 状态的方法。此对象映射器创建的解析器实例的功能。 |
29 | ObjectMapper configure(MapperFeature f, boolean state) - 更改此映射器实例的开/关映射器功能状态的方法。 |
30 | ObjectMapper configure(SerializationFeature f, boolean state) - 更改此对象映射器的开/关序列化功能状态的方法。 |
31 | JavaType constructType(Type t) - 从给定类型(通常是 java.lang.Class)构造 JavaType 的便捷方法,但没有显式上下文。 |
32 | <T> T convertValue(Object fromValue, Class<T> toValueType) - 从给定值到给定值类型实例进行两步转换的便捷方法。 |
33 | <T> T convertValue(Object fromValue, JavaType toValueType) - 请参阅 convertValue(Object, Class) |
34 | <T> T convertValue(Object fromValue, TypeReference<?> toValueTypeRef) - 请参阅 convertValue(Object, Class) |
35 | ObjectMapper copy() - 用于创建与此实例具有相同初始配置的新 ObjectMapper 实例的方法。 |
36 | ArrayNode createArrayNode() - 注意:返回类型是协变的,因为基本的 ObjectCodec 抽象不能引用具体的节点类型(因为它是核心包的一部分,而 impls 是映射器包的一部分) |
37 | ObjectNode createObjectNode() - 注意:返回类型是协变的,因为基本的 ObjectCodec 抽象不能引用具体的节点类型(因为它是核心包的一部分,而 impls 是映射器包的一部分) |
38 | protected ClassIntrospector defaultClassIntrospector() - 用于构造要使用的默认 ClassIntrospector 的可重写帮助器方法。 |
39 | ObjectMapper disable(DeserializationFeature feature) - 启用指定DeserializationConfig功能的方法。 |
40 | ObjectMapper disable(DeserializationFeature first, DeserializationFeature... f) - 启用指定DeserializationConfig功能的方法。 |
41 | ObjectMapper disable(JsonGenerator.Feature... features) - 禁用此对象映射器创建的解析器实例的指定 JsonGenerator.Features 的方法。 |
42 | ObjectMapper disable(JsonParser.Feature... features) - 禁用此对象映射器创建的解析器实例的指定 JsonParser.Features 的方法。 |
43 | ObjectMapper disable(MapperFeature... f) - 启用指定DeserializationConfig功能的方法。 |
44 | ObjectMapper disable(SerializationFeature f) - 启用指定DeserializationConfig功能的方法。 |
45 | ObjectMapper disable(SerializationFeature first, SerializationFeature... f) - 启用指定DeserializationConfig功能的方法。 |
46 | ObjectMapper disableDefaultTyping() - 禁止自动包含类型信息的方法; 如果是这样,只有显式注释的类型(具有 JsonTypeInfo 的类型)才会具有附加的嵌入类型信息。 |
47 | ObjectMapper enable(DeserializationFeature feature) - 启用指定DeserializationConfig功能的方法。 |
48 | ObjectMapper enable(DeserializationFeature first, DeserializationFeature... f) - 启用指定DeserializationConfig功能的方法。 |
49 | ObjectMapper enable(JsonGenerator.Feature... features) - 为该对象映射器创建的解析器实例启用指定的 JsonGenerator.Features 的方法。 |
50 | ObjectMapper enable(JsonParser.Feature... features) - 为该对象映射器创建的解析器实例启用指定的 JsonParser.Features 的方法。 |
51 | ObjectMapper enable(MapperFeature... f) - 启用指定MapperConfig功能的方法。 |
52 | ObjectMapper enable(SerializationFeature f) - 启用指定 DeserializationConfig 功能的方法。 |
53 | ObjectMapper enable(SerializationFeature first, SerializationFeature... f) -用于启用指定 DeserializationConfig 功能的方法。 |
54 | ObjectMapper enableDefaultTyping() - 相当于调用的便捷方法 |
55 | ObjectMapper enableDefaultTyping(ObjectMapper.DefaultTyping dti) - 相当于调用的便捷方法 |
56 | ObjectMapper enableDefaultTyping(ObjectMapper.DefaultTyping applicability, JsonTypeInfo.As includeAs) - 用于启用自动包含类型信息的方法,需要正确反序列化多态类型(除非类型已使用 JsonTypeInfo 进行注释)。 |
57 | ObjectMapper enableDefaultTypingAsProperty(ObjectMapper.DefaultTyping applicability, String propertyName) - 启用自动包含类型信息的方法——正确反序列化多态类型所需的(除非类型已用 JsonTypeInfo 注释)——使用"As.PROPERTY"包含机制和指定的属性名称来用于包含(默认为"@class",因为默认类型信息始终使用类名作为类型标识符) |
58 | ObjectMapper findAndRegisterModules() - 功能上等同于的便捷方法:mapper.registerModules(mapper.findModules()); |
59 | Class<?> findMixInClassFor(Class<?> cls) |
60 | static List<Module> findModules() - 使用 JDK ServiceLoader 工具以及模块提供的 SPI 来查找可用方法的方法。 |
61 | static List<Module> findModules(ClassLoader classLoader) - 使用 JDK ServiceLoader 工具以及模块提供的 SPI 来查找可用方法的方法。 |
62 | DateFormat getDateFormat() |
63 | DeserializationConfig getDeserializationConfig() - 返回定义反序列化配置设置的共享默认 DeserializationConfig 对象的方法。 |
64 | DeserializationContext getDeserializationContext() - 获取当前DeserializationContext的方法。 |
65 | JsonFactory getFactory() - 如果需要构造 JsonParsers 和/或 JsonGenerators,可用于获取此映射器使用的 JsonFactory 的方法。 |
66 | InjectableValues getInjectableValues() |
67 | JsonFactory getJsonFactory() - 已弃用。 从 2.1 开始:使用 getFactory() 代替 |
68 | JsonNodeFactory getNodeFactory() - 可用于获取此映射器在直接构造树的根 JsonNode 实例时将使用的 JsonNodeFactory 的方法。 |
69 | PropertyNamingStrategy getPropertyNamingStrategy() |
70 | SerializationConfig getSerializationConfig() - 返回定义序列化配置设置的共享默认 SerializationConfig 对象的方法。 |
71 | SerializerFactory getSerializerFactory() - 获取当前SerializerFactory的方法。 |
72 | SerializerProvider getSerializerProvider() - "blueprint"(或工厂)实例的访问器,通过调用 DefaultSerializerProvider.createInstance(com.fasterxml.jackson.databind.SerializationConfig, com.fasterxml.jackson.databind.ser.SerializerFactory) 从该实例创建实例。 TD> |
73 | SerializerProvider getSerializerProviderInstance() - 用于构造和返回可用于访问序列化器的 SerializerProvider 实例的访问器。 |
74 | SubtypeResolver getSubtypeResolver() - 访问正在使用的子类型解析器的方法。 |
75 | TypeFactory getTypeFactory() - 用于获取当前配置的 TypeFactory 实例的访问器。 |
76 | VisibilityChecker<?> getVisibilityChecker() - 访问当前配置的可见性检查器的方法; 用于确定给定属性元素(方法、字段、构造函数)是否可以自动检测的对象。 |
77 | boolean isEnabled(DeserializationFeature f) - 检查是否启用给定反序列化特定功能的方法。 |
78 | boolean isEnabled(JsonFactory.Feature f) - 便捷方法,相当于: |
79 | boolean isEnabled(JsonGenerator.Feature f) |
80 | boolean isEnabled(JsonParser.Feature f) |
81 | boolean isEnabled(MapperFeature f) - 检查给定MapperFeature是否启用的方法。 |
82 | boolean isEnabled(SerializationFeature f) - 检查是否启用给定序列化特定功能的方法。 |
83 | int mixInCount() |
84 | ObjectReader reader() - 使用默认设置构造 ObjectReader 的工厂方法。 |
85 | ObjectReader reader(Base64Variant defaultBase64) - 用于构造 ObjectReader 的工厂方法,它将使用指定的 Base64 编码变体来处理 Base64 编码的二进制数据。 |
86 | ObjectReader reader(Class<?> type) - 已弃用。 从2.5开始,改用readerFor(Class) |
87 | ObjectReader reader(ContextAttributes attrs) - 用于构造将使用指定默认属性的 ObjectReader 的工厂方法。 |
88 | ObjectReader reader(DeserializationFeature feature) - 用于构造启用指定功能的 ObjectReader 的工厂方法(与此映射器实例具有的设置相比)。 |
89 | ObjectReader reader(DeserializationFeature first, DeserializationFeature... other) - 用于构造启用指定功能的 ObjectReader 的工厂方法(与此映射器实例具有的设置相比)。 |
90 | ObjectReader reader(FormatSchema schema) - 用于构造 ObjectReader 的工厂方法,它将特定的架构对象传递给用于读取内容的 JsonParser。 |
91 | ObjectReader reader(InjectableValues injectableValues) - 用于构造将使用指定的可注入值的 ObjectReader 的工厂方法。 |
92 | ObjectReader reader(JavaType type) - 已弃用。 从2.5开始,改用readerFor(JavaType) |
93 | ObjectReader reader(JsonNodeFactory f) - 用于构造 ObjectReader 的工厂方法,它将使用指定的 JsonNodeFactory 来构造 JSON 树。 |
94 | ObjectReader reader(TypeReference<?> type) - 已弃用。 从2.5开始,使用 readerFor(TypeReference) 代替 |
95 | ObjectReader readerFor(Class<?> type) - 用于构造 ObjectReader 的工厂方法,该方法将读取或更新指定类型的实例 |
96 | ObjectReader readerFor(JavaType type) - 用于构造 ObjectReader 的工厂方法,该方法将读取或更新指定类型的实例 |
97 | ObjectReader readerFor(TypeReference<?> type) - 用于构造 ObjectReader 的工厂方法,该方法将读取或更新指定类型的实例 |
98 | ObjectReader readerForUpdating(Object valueToUpdate) - 用于构造 ObjectReader 的工厂方法,它将使用 JSON 数据更新给定的对象(通常是 Bean,但也可以是 Collection 或 Map,但不是数组)。 |
99 | ObjectReader readerWithView(Class<?> view) - 用于构造 ObjectReader 的工厂方法,该方法将使用指定的 JSON 视图(过滤器)反序列化对象。 |
100 | JsonNode readTree(byte[] content) - 将 JSON 内容反序列化为使用 JsonNode 实例集表示的树的方法。 |
101 | JsonNode readTree(File file) - 将 JSON 内容反序列化为使用 JsonNode 实例集表示的树的方法。 |
102 | JsonNode readTree(InputStream in) - 将 JSON 内容反序列化为使用 JsonNode 实例集表示的树的方法。 |
103 | <T extends TreeNode> T readTree(JsonParser p) - 将 JSON 内容反序列化为使用 JsonNode 实例集表示的树的方法。 |
104 | JsonNode readTree(Reader r) - 将 JSON 内容反序列化为使用 JsonNode 实例集表示的树的方法。 |
105 | JsonNode readTree(String content) - 将 JSON 内容反序列化为使用 JsonNode 实例集表示的树的方法。 |
106 | JsonNode readTree(URL source) - 将 JSON 内容反序列化为使用 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) - 将给定文件中的 JSON 内容反序列化为给定 Java 类型的方法。 |
116 | <T> T readValue(File src, JavaType valueType) - 将给定文件中的 JSON 内容反序列化为给定 Java 类型的方法。 |
117 | <T> T readValue(File src, TypeReference valueTypeRef) - 将给定文件中的 JSON 内容反序列化为给定 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) - 将 JSON 内容反序列化为非容器类型的方法(不过,它可以是数组类型):通常是 bean、数组或包装类型(如布尔值)。 |
122 | <T> T readValue(JsonParser p, JavaType valueType) - 类型安全的重载方法,基本上是 readValue(JsonParser, Class) 的别名。 |
123 | <T> T readValue(JsonParser p, ResolvedType valueType) - 将 JSON 内容反序列化为 Java 类型的方法,对其的引用作为参数传递。 |
124 | <T> T readValue(JsonParser p, TypeReference<?> valueTypeRef) - 将 JSON 内容反序列化为 Java 类型的方法,对其的引用作为参数传递。 |
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) - 从给定的 JSON 内容字符串反序列化 JSON 内容的方法。 |
128 | <T> T readValue(String content, JavaType valueType) - 从给定的 JSON 内容字符串反序列化 JSON 内容的方法。 |
129 | <T> T readValue(String content, TypeReference valueTypeRef) - 从给定的 JSON 内容字符串反序列化 JSON 内容的方法。 |
130 | <T> T readValue(URL src, Class<T> valueType) - 将给定资源中的 JSON 内容反序列化为给定 Java 类型的方法。 |
131 | <T> T readValue(URL src, JavaType valueType) |
132 | <T> T readValue(URL src, TypeReference valueTypeRef) - 将给定资源中的 JSON 内容反序列化为给定 Java 类型的方法。 |
133 | <T> MappingIterator<T> readValues(JsonParser p, Class<T> valueType) - 便捷方法,功能等同于: |
134 | <T> MappingIterator<T> readValues(JsonParser p, JavaType valueType) - 便捷方法,功能等同于: |
135 | <T> MappingIterator<T> readValues(JsonParser p, ResolvedType valueType) - 便捷方法,功能等同于: |
136 | <T> MappingIterator<T> readValues(JsonParser p, TypeReference<?>valueTypeRef) - 从解析器流中读取对象序列的方法。 |
137 | ObjectMapper registerModule(Module module) - 注册可扩展此映射器提供的功能的模块的方法; 例如,通过添加自定义序列化器和反序列化器的提供程序。 |
138 | ObjectMapper registerModules(Iterable<Module> modules) - 按顺序注册指定模块的便捷方法; 功能相当于: |
139 | ObjectMapper registerModules(Module... modules) - 按顺序注册指定模块的便捷方法; 功能相当于: |
140 | void registerSubtypes(NamedType... types) - 将指定类注册为子类型的方法,以便基于类型名称的解析可以将超类型链接到子类型(作为使用注释的替代方法)。 |
141 | ObjectMapper setAnnotationIntrospector(AnnotationIntrospector ai) - 设置此映射器实例用于序列化和反序列化的 AnnotationIntrospector 的方法。 |
142 | ObjectMapper setAnnotationIntrospectors(AnnotationIntrospector serializerAI, AnnotationIntrospector deserializerAI) - 更改此映射器实例用于序列化和反序列化的 AnnotationIntrospector 实例的方法,分别指定它们,以便不同的方面可以使用不同的内省。 |
143 | ObjectMapper setBase64Variant(Base64Variant v) - 配置 byte[] 序列化器和反序列化器将使用的默认 Base64Variant 的方法。 |
144 | ObjectMapper setConfig(DeserializationConfig config) - 允许重写底层 DeserializationConfig 对象的方法。 |
145 | ObjectMapper setConfig(SerializationConfig config) - 允许重写底层 SerializationConfig 对象的方法,该对象包含特定于序列化的配置设置。 |
146 | ObjectMapper setDateFormat(DateFormat dateFormat) - 用于配置将时间值序列化为字符串以及从 JSON 字符串反序列化时使用的默认 DateFormat 的方法。 |
147 | ObjectMapper setDefaultPrettyPrinter(PrettyPrinter pp) - 启用"默认PrettyPrinter"时指定要使用的 PrettyPrinter 的方法(通过启用 SerializationFeature.INDENT_OUTPUT) |
148 | ObjectMapper setDefaultTyping(TypeResolverBuilder<?> typer) - 启用自动包含类型信息的方法,使用指定的处理程序对象来确定这会影响哪些类型,以及如何嵌入信息的详细信息。 |
149 | ObjectMapper setFilterProvider(FilterProvider filterProvider) - 配置此映射器以使用指定的 FilterProvider 将 Filter Id 映射到实际过滤器实例的方法。 |
150 | Object setHandlerInstantiator(HandlerInstantiator hi) - 配置 HandlerInstantiator 以用于在给定类的情况下创建处理程序实例(例如序列化器、反序列化器、类型和类型 id 解析器)的方法。 |
151 | ObjectMapper setInjectableValues(InjectableValues injectableValues) - 配置 InjectableValues 的方法,用于查找要注入的值。 |
152 | ObjectMapper setLocale(Locale l) - 覆盖用于格式化的默认区域设置的方法。 |
153 | void setMixInAnnotations(Map<Class<?>,Class<?>> sourceMixins) - 已弃用。 自 2.5 起:被该方法的流畅形式取代; setMixIns(java.util.Map<java.lang.Class<?>, java.lang.Class<?>>). |
154 | ObjectMapper setMixInResolver(ClassIntrospector.MixInResolver resolver) - 可以调用该方法来指定给定的解析器,以定位要使用的混合类,覆盖直接添加的映射。 |
155 | ObjectMapper setMixIns(Map<Class<?>,Class<?>> sourceMixins) - 用于定义混合注释以用于增强可处理(可序列化/可反序列化)类所具有的注释的方法。 |
156 | ObjectMapper setNodeFactory(JsonNodeFactory f) - 指定用于构造根级树节点的 JsonNodeFactory 的方法(通过方法 createObjectNode() |
157 | ObjectMapper setPropertyInclusion(JsonInclude.Value incl) - 设置默认 POJO 属性包含序列化策略的方法。 |
158 | ObjectMapper setPropertyNamingStrategy(PropertyNamingStrategy s) - 设置要使用的自定义属性命名策略的方法。 |
159 | ObjectMapper setSerializationInclusion(JsonInclude.Include incl) - 便捷方法,相当于调用: |
160 | ObjectMapper setSerializerFactory(SerializerFactory f) - 设置用于构造(bean)序列化器的特定 SerializerFactory 的方法。 |
161 | ObjectMapper setSerializerProvider(DefaultSerializerProvider p) - 设置"blueprint(蓝图)"SerializerProvider 实例作为实际提供程序实例的基础的方法,用于处理 JsonSerializer 实例的缓存。 |
162 | ObjectMapper setSubtypeResolver(SubtypeResolver str) - 设置要使用的自定义子类型解析器的方法。 |
163 | ObjectMapper setTimeZone(TimeZone tz) - 覆盖用于格式化的默认时区的方法。 |
164 | ObjectMapper setTypeFactory(TypeFactory f) - 可用于覆盖此映射器使用的 TypeFactory 实例的方法。 |
165 | ObjectMapper setVisibility(PropertyAccessor forMethod, JsonAutoDetect.Visibility visibility) - 方便的方法,允许更改底层 VisibilityCheckers 的配置,以更改自动检测的属性类型的详细信息。 |
166 | ObjectMapper setVisibility(VisibilityChecker<?> vc) - 设置当前配置的 VisibilityChecker 的方法,用于确定给定属性元素(方法、字段、构造函数)是否可以自动检测的对象。 |
167 | void setVisibilityChecker(VisibilityChecker<?> vc) - 已弃用。 从 2.6 开始使用 setVisibility(VisibilityChecker) 代替。 |
168 | JsonParser treeAsTokens(TreeNode n) - 从 JSON 树表示构造 JsonParser 的方法。 |
169 | <T> T treeToValue(TreeNode n, Class<T> valueType) - 方便的转换方法,将给定的 JSON 树包含的数据绑定到特定值(通常是 bean)类型。 |
170 | <T extends JsonNode> T valueToTree(Object fromValue) - treeToValue(com.fasterxml.jackson.core.TreeNode, java.lang.Class |
171 | Version version() - 将返回存储在包含此类的 jar 中并从中读取版本信息的方法。 |
172 | ObjectWriter writer() - 使用默认设置构造 ObjectWriter 的便捷方法。 |
173 | ObjectWriter writer(Base64Variant defaultBase64) - 用于构造 ObjectWriter 的工厂方法,它将使用指定的 Base64 编码变体来处理 Base64 编码的二进制数据。 |
174 | ObjectWriter writer(CharacterEscapes escapes) - |
175 | ObjectWriter writer(ContextAttributes attrs) - 用于构造将使用指定默认属性的 ObjectWriter 的工厂方法。 |
176 | ObjectWriter writer(DateFormat df) - 用于构造 ObjectWriter 的工厂方法,该方法将使用指定的 DateFormat 序列化对象; 或者,如果传递 null,则使用时间戳(64 位数字)。 |
177 | ObjectWriter writer(FilterProvider filterProvider) - 用于构造 ObjectWriter 的工厂方法,该方法将使用指定的过滤器提供程序序列化对象。 |
178 | ObjectWriter writer(FormatSchema schema) - 用于构造 ObjectWriter 的工厂方法,它将特定的架构对象传递给用于写入内容的 JsonGenerator。 |
179 | ObjectWriter writer(PrettyPrinter pp) - 用于构造 ObjectWriter 的工厂方法,该方法将使用指定的prettyprinter进行缩进序列化对象(或者如果为 null,则没有prettyprinter) |
180 | ObjectWriter writer(SerializationFeature feature) - 用于构造启用指定功能的 ObjectWriter 的工厂方法(与此映射器实例具有的设置相比)。 |
181 | ObjectWriter writer(SerializationFeature first, SerializationFeature... other) - 用于构造启用指定功能的 ObjectWriter 的工厂方法(与此映射器实例具有的设置相比)。 |
182 | ObjectWriter writerFor(Class<?> rootType) - 用于构造 ObjectWriter 的工厂方法,该方法将使用指定的根类型而不是值的实际运行时类型来序列化对象。 |
183 | ObjectWriter writerFor(JavaType rootType) - 用于构造 ObjectWriter 的工厂方法,该方法将使用指定的根类型而不是值的实际运行时类型来序列化对象。 |
184 | ObjectWriter writerFor(TypeReference<?> rootType) - 用于构造 ObjectWriter 的工厂方法,该方法将使用指定的根类型而不是值的实际运行时类型来序列化对象。 |
185 | ObjectWriter writerWithDefaultPrettyPrinter() - 用于构造 ObjectWriter 的工厂方法,该方法将使用默认的漂亮打印机进行缩进序列化对象。 |
186 | ObjectWriter writerWithType(Class<?> rootType) - 已弃用。 从2.5开始,改用writerFor(Class)。 |
187 | ObjectWriter writerWithType(JavaType rootType) - 已弃用。 从 2.5 开始,改用 writerFor(JavaType)。 |
188 | ObjectWriter writerWithType(TypeReference<?> rootType) - 已弃用。 从 2.5 开始,改用 writerFor(TypeReference)。 |
189 | ObjectWriter writerWithView(Class<?> serializationView) - 用于构造 ObjectWriter 的工厂方法,该方法将使用指定的 JSON 视图(过滤器)序列化对象。 |
190 | void writeTree(JsonGenerator jgen, JsonNode rootNode) - 使用提供的生成器序列化给定 JSON 树的方法。 |
191 | void writeTree(JsonGenerator jgen, TreeNode rootNode) |
192 | void writeValue(DataOutput out, Object value) |
193 | void writeValue(File resultFile, Object value) - 可用于将任何 Java 值序列化为 JSON 输出并写入提供的文件的方法。 |
194 | void writeValue(JsonGenerator g, Object value) - 可用于使用提供的 JsonGenerator 将任何 Java 值序列化为 JSON 输出的方法。 |
195 | void writeValue(OutputStream out, Object value) - 可用于使用提供的输出流(使用编码 JsonEncoding.UTF8)将任何 Java 值序列化为 JSON 输出的方法。 |
196 | void writeValue(Writer w, Object value) - 使用提供的 Writer 将任何 Java 值序列化为 JSON 输出的方法。 |
197 | byte[] writeValueAsBytes(Object value) - 可用于将任何 Java 值序列化为字节数组的方法。 |
198 | String writeValueAsString(Object value) - 可用于将任何 Java 值序列化为字符串的方法。 |
继承的方法
该类继承了以下类的方法:
java.lang.Object
对象映射器示例
使用您选择的任何编辑器创建以下 java 程序,例如 C:/> Jackson_WORKSPACE
File: 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+ " ]"; } }
验证结果
使用javac编译器编译类,如下所示:
C:\Jackson_WORKSPACE>javac JacksonTester.java
现在运行 jacksonTester 查看结果:
C:\Jackson_WORKSPACE>java JacksonTester
验证输出
Student [ name: Mahesh, age: 21 ] { "name" : "Mahesh", "age" : 21 }