ジャクソン-ObjectMapperクラス

前書き

ObjectMapperは、Jacksonライブラリのメインアクタークラスです。ObjectMapperクラスObjectMapperは、基本的なPOJO(Plain Old Java Objects)との間、または汎用JSONツリーモデル(JsonNode)との間でJSONを読み書きするための機能、および変換を実行するための関連機能を提供します。また、さまざまなスタイルのJSONコンテンツを処理し、ポリモーフィズムやオブジェクトIDなどのより高度なオブジェクトの概念をサポートするように高度にカスタマイズできます。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 -ミックスインアノテーションの適用方法を定義するマッピング:keyは追加のアノテーションを受け取るタイプであり、valueは「ミックスイン」するアノテーションを持つタイプです。

  • protected ConfigOverrides _propertyOverrides -宣言されたタイプのプロパティによってアクセスされる、現在アクティブなタイプごとの構成オーバーライド。

  • protected Set<Object> _registeredModuleTypes -モジュールタイプのセット(登録されているModule.getTypeId()に従って、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を構築するインスタンスを構築します。

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

指定されたJsonFactoryを使用して必要なJsonParsersやJsonGeneratorsを構築し、指定されたプロバイダーを使用してシリアライザーとデシリアライザーにアクセスするインスタンスを構築します。

4 protected ObjectMapper(ObjectMapper src)

コピーコンストラクタ。主にcopy()をサポートするために使用されます。

メソッド

シリアル化に使用するSerializerProviderを構築するために使用されるオーバーライド可能なヘルパーメソッド。void addMixInAnnotations(Class <?> target、Class <?> mixinSource)-非推奨。2.5以降:流暢な形式のメソッドに置き換えられました。addMixIn(Class、Class)。protected DefaultDeserializationContext createDeserializationContext(JsonParser p、DeserializationConfig cfg)-単一のルート値を逆シリアル化するためにDeserializationContextのインスタンスを作成するために呼び出される内部ヘルパーメソッド。JsonSchema generateJsonSchema(Class <?> t)-非推奨。2.6以降、外部JSONスキーマジェネレーター(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を構築するためのファクトリメソッド。
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.Featuresの状態を変更するためのメソッド。
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) -変換が必要な場合(ただし、!)、指定された値から指定された値タイプのインスタンスへの2段階変換を行うための便利な方法。
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抽象化は具体的なノードタイプを参照できないため、戻り値の型は共変です(コアパッケージの一部であるのに対し、implはマッパーパッケージの一部であるため)
37 ObjectNode createObjectNode() -注:基本的なObjectCodec抽象化は具体的なノードタイプを参照できないため、戻り値の型は共変です(コアパッケージの一部であるのに対し、implはマッパーパッケージの一部であるため)
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」包含メカニズムと包含に使用する指定されたプロパティ名(デフォルトは「@」)を使用デフォルトのタイプ情報は常にクラス名をタイプ識別子として使用するため、「クラス」)
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() -DefaultSerializerProvider.createInstance(com.fasterxml.jackson.databind.SerializationConfig、com.fasterxml.jackson.databind.ser.SerializerFactory)を呼び出すことによってインスタンスが作成される、「ブループリント」(またはファクトリ)インスタンスのアクセサー。
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) -Base64でエンコードされたバイナリデータに指定されたBase64エンコードバリアントを使用するObjectReaderを構築するためのファクトリメソッド。
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) -コンテンツの読み取りに使用されるJsonParserに特定のスキーマオブジェクトを渡すObjectReaderを構築するためのファクトリメソッド。
91 ObjectReader reader(InjectableValues injectableValues) -指定された注入可能な値を使用するObjectReaderを構築するためのファクトリメソッド。
92 ObjectReader reader(JavaType type)-非推奨。2.5以降、代わりにreaderFor(JavaType)を使用してください
93 ObjectReader reader(JsonNodeFactory f) --JSONツリーを構築するために指定されたJsonNodeFactoryを使用するObjectReaderを構築するためのファクトリメソッド。
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) -指定されたオブジェクト(通常はBeanですが、コレクションまたはマップでもかまいませんが、配列ではありません)をJSONデータで更新するObjectReaderを構築するためのファクトリメソッド。
99 ObjectReader readerWithView(Class<?> view) -指定されたJSONビュー(フィルター)を使用してオブジェクトを逆シリアル化するObjectReaderを構築するためのファクトリメソッド。
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) - 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) -タイプセーフなオーバーロードされたメソッド。基本的には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) -指定されたクラスをサブタイプとして登録する方法。これにより、typenameベースの解決でスーパータイプをサブタイプにリンクできます(アノテーションを使用する代わりに)。
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を指定する方法(SerializationFeature.INDENT_OUTPUTを有効にすることにより)
148 ObjectMapper setDefaultTyping(TypeResolverBuilder<?> typer) -指定されたハンドラオブジェクトを使用してタイプ情報を自動的に含めることができるようにする方法。これが影響するタイプと、情報の埋め込み方法の詳細を決定します。
149 ObjectMapper setFilterProvider(FilterProvider filterProvider) -フィルターIDを実際のフィルターインスタンスにマッピングするために指定されたFilterProviderを使用するようにこのマッパーを構成する方法。
150 Object setHandlerInstantiator(HandlerInstantiator hi) -クラスを指定して、ハンドラー(シリアライザー、デシリアライザー、タイプおよびタイプIDリゾルバーなど)のインスタンスを作成するために使用するHandlerInstantiatorを構成するためのメソッド。
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) -JsonSerializerインスタンスのキャッシュを処理するために使用する実際のプロバイダーインスタンスのベースとして使用する「ブループリント」SerializerProviderインスタンスを設定する方法。
162 ObjectMapper setSubtypeResolver(SubtypeResolver str) -使用するカスタムサブタイプリゾルバーを設定する方法。
163 ObjectMapper setTimeZone(TimeZone tz) -フォーマットに使用するデフォルトのTimeZoneをオーバーライドする方法。
164 ObjectMapper setTypeFactory(TypeFactory f) -このマッパーで使用されるTypeFactoryインスタンスをオーバーライドするために使用できるメソッド。
165 ObjectMapper setVisibility(PropertyAccessor forMethod, JsonAutoDetect.Visibility visibility) -基になるVisibilityCheckerの構成を変更して、自動検出されるプロパティの種類の詳細を変更できる便利な方法。
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 <T>);の逆。値(通常はBean)を指定すると、同等のJSONツリー表現が構築されます。
171 Version version() -このクラスを含むjarに格納され、jarから読み取られるバージョン情報を返すメソッド。
172 ObjectWriter writer() -デフォルト設定でObjectWriterを構築するための便利な方法。
173 ObjectWriter writer(Base64Variant defaultBase64) -Base64でエンコードされたバイナリデータに指定されたBase64エンコードバリアントを使用するObjectWriterを構築するためのファクトリメソッド。
174 ObjectWriter writer(CharacterEscapes escapes) -
175 ObjectWriter writer(ContextAttributes attrs) -指定されたデフォルト属性を使用するObjectWriterを構築するためのファクトリメソッド。
176 ObjectWriter writer(DateFormat df)-指定されたDateFormatを使用してオブジェクトをシリアル化するObjectWriterを構築するためのファクトリメソッド。または、nullが渡された場合は、タイムスタンプ(64ビットの数値)を使用します。
177 ObjectWriter writer(FilterProvider filterProvider) -指定されたフィルタープロバイダーを使用してオブジェクトをシリアル化するObjectWriterを構築するためのファクトリメソッド。
178 ObjectWriter writer(FormatSchema schema) -コンテンツの書き込みに使用されるJsonGeneratorに特定のスキーマオブジェクトを渡すObjectWriterを構築するためのファクトリメソッド。
179 ObjectWriter writer(PrettyPrinter pp) -インデントに指定されたプリティプリンターを使用してオブジェクトをシリアル化するObjectWriterを構築するためのファクトリメソッド(またはnullの場合はプリティプリンターなし)
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) -指定されたJSONビュー(フィルター)を使用してオブジェクトをシリアル化するObjectWriterを構築するためのファクトリメソッド。
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) -提供されたファイルに書き込まれるJSON出力として任意のJava値をシリアル化するために使用できるメソッド。
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

ObjectMapperの例

たとえば、任意のエディタを使用して次のJavaプログラムを作成します。 C:/> Jackson_WORKSPACE

ファイル: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

を使用してクラスをコンパイルします javac 次のようにコンパイラ:

C:\Jackson_WORKSPACE>javac JacksonTester.java

次に、jacksonTesterを実行して、結果を確認します。

C:\Jackson_WORKSPACE>java JacksonTester

出力を確認する

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