クラス MappingJackson2MessageConverter
java.lang.ObjectSE
org.springframework.messaging.converter.AbstractMessageConverter
org.springframework.messaging.converter.MappingJackson2MessageConverter
- 実装されているすべてのインターフェース:
MessageConverter,SmartMessageConverter
@DeprecatedSE(since="7.0",
forRemoval=true)
public class MappingJackson2MessageConverter
extends AbstractMessageConverter
非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。
Jackson 2 ベースの
MessageConverter 実装。Jackson のデフォルトプロパティを次のようにカスタマイズします。
MapperFeature.DEFAULT_VIEW_INCLUSIONは無効ですDeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIESは無効です
- 導入:
- 4.0
- 作成者:
- Rossen Stoyanchev, Juergen Hoeller, Sebastien Deleuze
フィールドのサマリー
クラス org.springframework.messaging.converter.AbstractMessageConverter から継承されたフィールド
loggerコンストラクターの概要
コンストラクターコンストラクター説明非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。デフォルトのObjectMapperを使用してMappingJackson2MessageConverterを構築し、UTF-8文字セットでapplication/jsonMIME 型をサポートします。MappingJackson2MessageConverter(com.fasterxml.jackson.databind.ObjectMapper objectMapper) 非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。UTF-8文字セットでapplication/jsonMIME 型をサポートするカスタムObjectMapperを使用してMappingJackson2MessageConverterを構築します。MappingJackson2MessageConverter(com.fasterxml.jackson.databind.ObjectMapper objectMapper, MimeType... supportedMimeTypes) 非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。1 つ以上のカスタム MIME 型をサポートするカスタムObjectMapperを使用してMappingJackson2MessageConverterを構築します。MappingJackson2MessageConverter(MimeType... supportedMimeTypes) 非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。1 つ以上のカスタム MIME 型をサポートする、デフォルトのObjectMapperを使用してMappingJackson2MessageConverterを構築します。メソッドのサマリー
修飾子と型メソッド説明protected booleancanConvertFrom(Message<?> message, @Nullable ClassSE<?> targetClass) 非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。protected booleancanConvertTo(ObjectSE payload, @Nullable MessageHeaders headers) 非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。convertFromInternal(Message<?> message, ClassSE<?> targetClass, @Nullable ObjectSE conversionHint) 非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。メッセージペイロードを直列化された形式からオブジェクトに変換します。convertToInternal(ObjectSE payload, @Nullable MessageHeaders headers, @Nullable ObjectSE conversionHint) 非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。ペイロードオブジェクトを直列化された形式に変換します。protected com.fasterxml.jackson.core.JsonEncodinggetJsonEncoding(@Nullable MimeType contentType) 非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。指定されたコンテンツ型に使用する JSON エンコーディングを決定します。com.fasterxml.jackson.databind.ObjectMapper非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。このコンバーターの基になるObjectMapperを返します。getSerializationView(@Nullable ObjectSE conversionHint) 非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。指定された変換ヒントに基づいて、Jackson 直列化ビューを決定します。protected voidlogWarningIfNecessary(TypeSE type, @Nullable ThrowableSE cause) 非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。ObjectMapper.canDeserialize(com.fasterxml.jackson.databind.JavaType)/ObjectMapper.canSerialize(java.lang.Class<?>)チェックから発生した特定の例外をログに記録するかどうかを決定します。voidsetObjectMapper(com.fasterxml.jackson.databind.ObjectMapper objectMapper) 非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。このコンバーターのObjectMapperを設定します。voidsetPrettyPrint(boolean prettyPrint) 非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。JSON を書き込むときにDefaultPrettyPrinterを使用するかどうか。protected boolean非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。指定されたクラスがこのコンバーターでサポートされているかどうか。クラス org.springframework.messaging.converter.AbstractMessageConverter から継承されたメソッド
addSupportedMimeTypes, fromMessage, fromMessage, getContentTypeResolver, getDefaultContentType, getMimeType, getSerializedPayloadClass, getSupportedMimeTypes, isStrictContentTypeMatch, setContentTypeResolver, setSerializedPayloadClass, setStrictContentTypeMatch, supportsMimeType, toMessage, toMessage
コンストラクターの詳細
MappingJackson2MessageConverter
public MappingJackson2MessageConverter()非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。デフォルトのObjectMapperを使用してMappingJackson2MessageConverterを構築し、UTF-8文字セットでapplication/jsonMIME 型をサポートします。MappingJackson2MessageConverter
非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。1 つ以上のカスタム MIME 型をサポートする、デフォルトのObjectMapperを使用してMappingJackson2MessageConverterを構築します。- パラメーター:
supportedMimeTypes- サポートされている MIME 型- 導入:
- 4.1.5
MappingJackson2MessageConverter
public MappingJackson2MessageConverter(com.fasterxml.jackson.databind.ObjectMapper objectMapper) 非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。UTF-8文字セットでapplication/jsonMIME 型をサポートするカスタムObjectMapperを使用してMappingJackson2MessageConverterを構築します。- パラメーター:
objectMapper- 使用するObjectMapper- 導入:
- 6.1
MappingJackson2MessageConverter
public MappingJackson2MessageConverter(com.fasterxml.jackson.databind.ObjectMapper objectMapper, MimeType... supportedMimeTypes) 非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。1 つ以上のカスタム MIME 型をサポートするカスタムObjectMapperを使用してMappingJackson2MessageConverterを構築します。- パラメーター:
objectMapper- 使用するObjectMappersupportedMimeTypes- サポートされている MIME 型- 導入:
- 6.1
メソッドの詳細
setObjectMapper
public void setObjectMapper(com.fasterxml.jackson.databind.ObjectMapper objectMapper) 非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。このコンバーターのObjectMapperを設定します。設定されていない場合は、デフォルトの
ObjectMapperが使用されます。カスタム構成の
ObjectMapperを設定することは、JSON 直列化プロセスをさらに制御する方法の一つです。たとえば、特定の型に対してカスタムシリアライザーを提供する拡張SerializerFactoryを設定できます。直列化プロセスを洗練させるもう一つの方法は、直列化対象の型に Jackson が提供するアノテーションを使用することです。この場合、カスタム構成のObjectMapperは不要です。getObjectMapper
public com.fasterxml.jackson.databind.ObjectMapper getObjectMapper()非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。このコンバーターの基になるObjectMapperを返します。setPrettyPrint
public void setPrettyPrint(boolean prettyPrint) 非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。JSON を書き込むときにDefaultPrettyPrinterを使用するかどうか。これは、次のように
ObjectMapperをセットアップするためのショートカットです。ObjectMapper mapper = new ObjectMapper(); mapper.configure(SerializationFeature.INDENT_OUTPUT, true); converter.setObjectMapper(mapper);
canConvertFrom
非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。- オーバーライド:
- クラス
AbstractMessageConverterのcanConvertFrom
canConvertTo
非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。- オーバーライド:
- クラス
AbstractMessageConverterのcanConvertTo
logWarningIfNecessary
非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。ObjectMapper.canDeserialize(com.fasterxml.jackson.databind.JavaType)/ObjectMapper.canSerialize(java.lang.Class<?>)チェックから発生した特定の例外をログに記録するかどうかを決定します。- パラメーター:
type- Jackson が(非)直列化可能性についてテストしたクラスcause- 評価する Jackson 投げ例外 (通常はJsonMappingException)- 導入:
- 4.3
supports
非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。クラスからコピーされた説明:AbstractMessageConverter指定されたクラスがこのコンバーターでサポートされているかどうか。- 次で指定:
- クラス
AbstractMessageConverterのsupports - パラメーター:
clazz- サポートをテストするクラス- 戻り値:
- サポートされている場合は
true。それ以外の場合はfalse
convertFromInternal
protected @Nullable ObjectSE convertFromInternal(Message<?> message, ClassSE<?> targetClass, @Nullable ObjectSE conversionHint) 非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。クラスからコピーされた説明:AbstractMessageConverterメッセージペイロードを直列化された形式からオブジェクトに変換します。- オーバーライド:
- クラス
AbstractMessageConverterのconvertFromInternal - パラメーター:
message- 入力メッセージtargetClass- 変換のターゲットクラスconversionHint-MessageConverterに渡される追加オブジェクト(たとえば、関連するMethodParameter) (nullかもしれない)- 戻り値:
- 変換の結果、またはコンバーターが変換を実行できない場合は
null
convertToInternal
protected @Nullable ObjectSE convertToInternal(ObjectSE payload, @Nullable MessageHeaders headers, @Nullable ObjectSE conversionHint) 非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。クラスからコピーされた説明:AbstractMessageConverterペイロードオブジェクトを直列化された形式に変換します。- オーバーライド:
- クラス
AbstractMessageConverterのconvertToInternal - パラメーター:
payload- 変換するオブジェクトheaders- メッセージのオプションのヘッダー (nullの場合があります)conversionHint-MessageConverterに渡される追加オブジェクト(たとえば、関連するMethodParameter) (nullかもしれない)- 戻り値:
- メッセージの結果のペイロード、またはコンバーターが変換を実行できない場合は
null
getSerializationView
getJsonEncoding
JacksonJsonMessageConverterを推奨