コンストラクターの詳細

• Jackson2ObjectMapperBuilder

  public Jackson2ObjectMapperBuilder()

メソッドの詳細

• createXmlMapper

  public Jackson2ObjectMapperBuilder createXmlMapper(boolean createXmlMapper)

  true に設定すると、デフォルトのコンストラクターを使用して XmlMapper が作成されます。これは、configure(com.fasterxml.jackson.databind.ObjectMapper) コールではなく、build() コールにのみ適用されます。

• factory

  public Jackson2ObjectMapperBuilder factory(JsonFactory factory)

  ObjectMapper インスタンスの作成に使用される JsonFactory を定義します。

  導入:

  5.0

• dateFormat

  public Jackson2ObjectMapperBuilder dateFormat(java.text.DateFormat dateFormat)

  指定された DateFormat で日付 / 時刻の形式を定義します。

  メモ: このプロパティを設定すると、Jackson のスレッドセーフルールに従って、公開された ObjectMapper が非スレッドセーフになります。

  関連事項:

  simpleDateFormat(String)

• simpleDateFormat

  public Jackson2ObjectMapperBuilder simpleDateFormat(java.lang.String format)

  SimpleDateFormat を使用して日付 / 時刻形式を定義します。

  メモ: このプロパティを設定すると、Jackson のスレッドセーフルールに従って、公開された ObjectMapper が非スレッドセーフになります。

  関連事項:

  dateFormat(DateFormat)

• locale

  public Jackson2ObjectMapperBuilder locale(java.util.Locale locale)

  フォーマットに使用するデフォルトの Locale をオーバーライドします。使用されるデフォルト値は Locale.getDefault() です。

  導入:

  4.1.5

• locale

  public Jackson2ObjectMapperBuilder locale(java.lang.String localeString)

  フォーマットに使用するデフォルトの Locale をオーバーライドします。使用されるデフォルト値は Locale.getDefault() です。

  パラメーター:

  localeString - 文字列表現としてのロケール ID

  導入:

  4.1.5

• timeZone

  public Jackson2ObjectMapperBuilder timeZone(java.util.TimeZone timeZone)

  フォーマットに使用するデフォルトの TimeZone をオーバーライドします。使用されるデフォルト値は UTC です（ローカルタイムゾーンではありません）。

  導入:

  4.1.5

• timeZone

  public Jackson2ObjectMapperBuilder timeZone(java.lang.String timeZoneString)

  フォーマットに使用するデフォルトの TimeZone をオーバーライドします。使用されるデフォルト値は UTC です（ローカルタイムゾーンではありません）。

  パラメーター:

  timeZoneString - 文字列表現としてのゾーン ID

  導入:

  4.1.5

• annotationIntrospector

  public Jackson2ObjectMapperBuilder annotationIntrospector(AnnotationIntrospector annotationIntrospector)

  シリアライゼーションとデシリアライゼーションの両方に AnnotationIntrospector を設定します。

• propertyNamingStrategy

  public Jackson2ObjectMapperBuilder propertyNamingStrategy(PropertyNamingStrategy propertyNamingStrategy)

  PropertyNamingStrategy を指定して、ObjectMapper を構成します。

• defaultTyping

  public Jackson2ObjectMapperBuilder defaultTyping(TypeResolverBuilder<?> typeResolverBuilder)

  Jackson のデフォルトの入力に使用する TypeResolverBuilder を指定します。

  導入:

  4.2.2

• serializationInclusion

  public Jackson2ObjectMapperBuilder serializationInclusion(com.fasterxml.jackson.annotation.JsonInclude.Include serializationInclusion)

  直列化のカスタム包含戦略を設定します。

  関連事項:

  JsonInclude.Include

• filters

  public Jackson2ObjectMapperBuilder filters(FilterProvider filters)

  @JsonFilter アノテーション付き POJO をサポートするために使用するグローバルフィルターを設定します。

  導入:

  4.2

  関連事項:

  MappingJacksonValue.setFilters(FilterProvider)

• mixIn

  public Jackson2ObjectMapperBuilder mixIn(java.lang.Class<?> target,
                                           java.lang.Class<?> mixinSource)

  指定されたクラスまたはインターフェースを補強するために使用するミックスインアノテーションを追加します。

  パラメーター:

  target - アノテーションが効果的にオーバーライドされるクラス（またはインターフェース）

  mixinSource - そのアノテーションが値としてターゲットのアノテーションに「追加」されるクラス（またはインターフェース）

  導入:

  4.1.2

  関連事項:

  ObjectMapper.addMixInAnnotations(Class, Class)

• mixIns

  public Jackson2ObjectMapperBuilder mixIns(java.util.Map<java.lang.Class<?>,java.lang.Class<?>> mixIns)

  指定されたクラスまたはインターフェースを補強するために使用するミックスインアノテーションを追加します。

  パラメーター:

  mixIns - アノテーションがキーとして効果的にオーバーライドされるターゲットクラス（またはインターフェース）と、アノテーションが値としてターゲットのアノテーションに「追加」されるミックスインクラス（またはインターフェース）を持つエントリのマップ。

  導入:

  4.1.2

  関連事項:

  ObjectMapper.addMixInAnnotations(Class, Class)

• serializers

  public Jackson2ObjectMapperBuilder serializers(JsonSerializer<?>... serializers)

  カスタムシリアライザーを構成します。各シリアライザーは、JsonSerializer.handledType() によって返される型用に登録されますが、null であってはなりません。

  関連事項:

  serializersByType(Map)

• serializerByType

  public Jackson2ObjectMapperBuilder serializerByType(java.lang.Class<?> type,
                                                      JsonSerializer<?> serializer)

  指定した型のカスタムシリアライザーを構成します。

  導入:

  4.1.2

  関連事項:

  serializers(JsonSerializer...)

• serializersByType

  public Jackson2ObjectMapperBuilder serializersByType(java.util.Map<java.lang.Class<?>,JsonSerializer<?>> serializers)

  指定された型のカスタムシリアライザーを構成します。

  関連事項:

  serializers(JsonSerializer...)

• deserializers

  public Jackson2ObjectMapperBuilder deserializers(JsonDeserializer<?>... deserializers)

  カスタムデシリアライザーを構成します。各デシリアライザは、JsonDeserializer.handledType() によって返される型に対して登録されますが、null であってはなりません。

  導入:

  4.3

  関連事項:

  deserializersByType(Map)

• deserializerByType

  public Jackson2ObjectMapperBuilder deserializerByType(java.lang.Class<?> type,
                                                        JsonDeserializer<?> deserializer)

  指定した型のカスタムデシリアライザーを構成します。

  導入:

  4.1.2

• deserializersByType

  public Jackson2ObjectMapperBuilder deserializersByType(java.util.Map<java.lang.Class<?>,JsonDeserializer<?>> deserializers)

  指定された型のカスタムデシリアライザーを構成します。

• autoDetectFields

  public Jackson2ObjectMapperBuilder autoDetectFields(boolean autoDetectFields)

  MapperFeature.AUTO_DETECT_FIELDS オプションのショートカット。

• autoDetectGetterSetter

  public Jackson2ObjectMapperBuilder autoDetectGettersSetters(boolean autoDetectGettersSetters)

  MapperFeature.AUTO_DETECT_SETTERS/MapperFeature.AUTO_DETECT_GETTERS/MapperFeature.AUTO_DETECT_IS_GETTERS オプションのショートカット。

• defaultViewInclusion

  public Jackson2ObjectMapperBuilder defaultViewInclusion(boolean defaultViewInclusion)

  MapperFeature.DEFAULT_VIEW_INCLUSION オプションのショートカット。

• failOnUnknownProperties

  public Jackson2ObjectMapperBuilder failOnUnknownProperties(boolean failOnUnknownProperties)

  DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES オプションのショートカット。

• failOnEmptyBeans

  public Jackson2ObjectMapperBuilder failOnEmptyBeans(boolean failOnEmptyBeans)

  SerializationFeature.FAIL_ON_EMPTY_BEANS オプションのショートカット。

• indentOutput

  public Jackson2ObjectMapperBuilder indentOutput(boolean indentOutput)

  SerializationFeature.INDENT_OUTPUT オプションのショートカット。

• defaultUseWrapper

  public Jackson2ObjectMapperBuilder defaultUseWrapper(boolean defaultUseWrapper)

  ラッパーがインデックス付き（リスト、配列）プロパティに使用されるかどうかを定義します（既定では使用されません（XmlMapper のみに適用されます））。

  導入:

  4.3

• visibility

  public Jackson2ObjectMapperBuilder visibility(com.fasterxml.jackson.annotation.PropertyAccessor accessor,
                                                com.fasterxml.jackson.annotation.JsonAutoDetect.Visibility visibility)

  自動検出されるプロパティの種類を制限するには、可視性を指定します。

  導入:

  5.1

  関連事項:

  PropertyAccessor, JsonAutoDetect.Visibility

• featuresToEnable

  public Jackson2ObjectMapperBuilder featuresToEnable(java.lang.Object... featuresToEnable)

  有効にする機能を指定します。

  関連事項:

  JsonParser.Feature, JsonGenerator.Feature, SerializationFeature, DeserializationFeature, MapperFeature

• featuresToDisable

  public Jackson2ObjectMapperBuilder featuresToDisable(java.lang.Object... featuresToDisable)

  無効にする機能を指定します。

  関連事項:

  JsonParser.Feature, JsonGenerator.Feature, SerializationFeature, DeserializationFeature, MapperFeature

• modules

  public Jackson2ObjectMapperBuilder modules(Module... modules)

  ObjectMapper に登録する 1 つ以上のモジュールを指定します。

  メモ: これが設定されている場合、モジュールの検出は行われません -Jackson でも Spring でもありません（findModulesViaServiceLoader を参照）。結果として、ここで空のリストを指定すると、あらゆる種類のモジュール検出が抑制されます。

  これまたは modulesToInstall(com.fasterxml.jackson.databind.Module...) の両方ではなく、いずれかを指定します。

  導入:

  4.1.5

  関連事項:

  modules(List), Module

• modules

  public Jackson2ObjectMapperBuilder modules(java.util.List<Module> modules)

  ObjectMapper に登録するモジュールの完全なリストを設定します。

  メモ: これが設定されている場合、モジュールの検出は行われません -Jackson でも Spring でもありません（findModulesViaServiceLoader を参照）。結果として、ここで空のリストを指定すると、あらゆる種類のモジュール検出が抑制されます。

  これまたは modulesToInstall(com.fasterxml.jackson.databind.Module...) の両方ではなく、いずれかを指定します。

  関連事項:

  modules(Module...), Module

• modulesToInstall

  public Jackson2ObjectMapperBuilder modulesToInstall(Module... modules)

  ObjectMapper に登録する 1 つ以上のモジュールを指定します。

  ここで指定されたモジュールは、Spring による JSR-310 および Joda-Time の自動検出、または Jackson によるモジュールの検出（findModulesViaServiceLoader を参照）後に登録され、最終的にそれらの構成をオーバーライドできます。

  これまたは modules の両方ではなく、いずれかを指定します。

  導入:

  4.1.5

  関連事項:

  Module

• modulesToInstall

  public Jackson2ObjectMapperBuilder modulesToInstall(java.lang.Class<? extends Module>... modules)

  ObjectMapper に登録する 1 つ以上のモジュールをクラスごとに指定します。

  ここで指定されたモジュールは、Spring による JSR-310 および Joda-Time の自動検出、または Jackson によるモジュールの検出（findModulesViaServiceLoader を参照）後に登録され、最終的にそれらの構成をオーバーライドできます。

  これまたは modules の両方ではなく、いずれかを指定します。

  関連事項:

  modulesToInstall(Module...), Module

• findModulesViaServiceLoader

  public Jackson2ObjectMapperBuilder findModulesViaServiceLoader(boolean findModules)

  クラスパス内の META-INF メタデータに基づいて、Jackson が JDK ServiceLoader を介して使用可能なモジュールを検索するかどうかを設定します。

  このモードが設定されていない場合、Spring の Jackson2ObjectMapperBuilder 自体は、クラスパス上で JSR-310 および Joda-Time サポートモジュールを見つけようとします。Java 8 および Joda-Time 自体がそれぞれ利用可能である場合。

  関連事項:

  ObjectMapper.findModules()

• moduleClassLoader

  public Jackson2ObjectMapperBuilder moduleClassLoader(java.lang.ClassLoader moduleClassLoader)

  Jackson 拡張モジュールのロードに使用する ClassLoader を設定します。

• handlerInstantiator

  public Jackson2ObjectMapperBuilder handlerInstantiator(HandlerInstantiator handlerInstantiator)

  Jackson ハンドラー（JsonSerializer、JsonDeserializer、KeyDeserializer、TypeResolverBuilder および TypeIdResolver）の構成をカスタマイズします。

  導入:

  4.1.3

  関連事項:

  applicationContext(ApplicationContext)

• applicationContext

  public Jackson2ObjectMapperBuilder applicationContext(ApplicationContext applicationContext)

  Jackson ハンドラー（JsonSerializer、JsonDeserializer、KeyDeserializer、TypeResolverBuilder および TypeIdResolver）をオートワイヤーするために、Spring ApplicationContext を設定します。

  導入:

  4.1.3

  関連事項:

  SpringHandlerInstantiator

• build

  public <T extends ObjectMapper> T build()

  新しい ObjectMapper インスタンスを作成します。

  ビルド操作ごとに、独立した ObjectMapper インスタンスが生成されます。ビルダーの設定を変更して、その後のビルド操作で最新の設定に基づいて新しい ObjectMapper を作成できます。

  戻り値:

  新しく構築された ObjectMapper

• configure

  public void configure(ObjectMapper objectMapper)

  このビルダーの設定を使用して、既存の ObjectMapper インスタンスを構成します。これは、任意の数の ObjectMappers に適用できます。

  パラメーター:

  objectMapper - 設定する ObjectMapper

• json

  public static Jackson2ObjectMapperBuilder json()

  通常の JSON ObjectMapper インスタンスを構築するには、Jackson2ObjectMapperBuilder インスタンスを取得します。

• xml

  public static Jackson2ObjectMapperBuilder xml()

  XmlMapper インスタンスを構築するには、Jackson2ObjectMapperBuilder インスタンスを取得します。

• smile

  public static Jackson2ObjectMapperBuilder smile()

  Smile データ形式 ObjectMapper インスタンスを構築するために、Jackson2ObjectMapperBuilder インスタンスを取得してください。

  導入:

  5.0

• cbor

  public static Jackson2ObjectMapperBuilder cbor()

  Jackson2ObjectMapperBuilder インスタンスを取得して、CBOR データ形式の ObjectMapper インスタンスを構築します。

  導入:

  5.0