Auto-configure XmlMapper.Builder and XmlMapper

Closes gh-47942

Author: wilkinsona

module/spring-boot-jackson/src/main/java/org/springframework/boot/jackson/autoconfigure/JacksonAutoConfiguration.java

@@ -40,6 +40,7 @@
 import tools.jackson.databind.cfg.MapperBuilder;
 import tools.jackson.databind.json.JsonMapper;
 import tools.jackson.dataformat.cbor.CBORMapper;
+import tools.jackson.dataformat.xml.XmlMapper;
 
 import org.springframework.aot.hint.ReflectionHints;
 import org.springframework.aot.hint.RuntimeHints;
@@ -163,7 +164,7 @@ public void customize(JsonMapper.Builder builder) {
 
 	@Configuration(proxyBeanMethods = false)
 	@ConditionalOnClass(ProblemDetail.class)
-	static class ProblemDetailsConfiguration {
+	static class JsonProblemDetailsConfiguration {
 
 		@Bean
 		ProblemDetailJsonMapperBuilderCustomizer problemDetailJsonMapperBuilderCustomizer() {
@@ -236,6 +237,80 @@ public void customize(CBORMapper.Builder builder) {
 
 	}
 
+	@Configuration(proxyBeanMethods = false)
+	@ConditionalOnClass(XmlMapper.class)
+	@EnableConfigurationProperties(JacksonXmlProperties.class)
+	static class XmlConfiguration {
+
+		@Bean
+		@ConditionalOnMissingBean
+		XmlMapper xmlMapper(XmlMapper.Builder builder) {
+			return builder.build();
+		}
+
+		@Bean
+		@Scope(ConfigurableBeanFactory.SCOPE_PROTOTYPE)
+		@ConditionalOnMissingBean
+		XmlMapper.Builder xmlMapperBuilder(List<XmlMapperBuilderCustomizer> customizers) {
+			XmlMapper.Builder builder = XmlMapper.builder();
+			customize(builder, customizers);
+			return builder;
+		}
+
+		private void customize(XmlMapper.Builder builder, List<XmlMapperBuilderCustomizer> customizers) {
+			for (XmlMapperBuilderCustomizer customizer : customizers) {
+				customizer.customize(builder);
+			}
+		}
+
+		@Bean
+		StandardXmlMapperBuilderCustomizer standardXmlMapperBuilderCustomizer(JacksonProperties jacksonProperties,
+				ObjectProvider<JacksonModule> modules, JacksonXmlProperties xmlProperties) {
+			return new StandardXmlMapperBuilderCustomizer(jacksonProperties, modules.stream().toList(), xmlProperties);
+		}
+
+		@Configuration(proxyBeanMethods = false)
+		@ConditionalOnClass(ProblemDetail.class)
+		static class XmlProblemDetailsConfiguration {
+
+			@Bean
+			ProblemDetailXmlMapperBuilderCustomizer problemDetailXmlMapperBuilderCustomizer() {
+				return new ProblemDetailXmlMapperBuilderCustomizer();
+			}
+
+			static final class ProblemDetailXmlMapperBuilderCustomizer implements XmlMapperBuilderCustomizer {
+
+				@Override
+				public void customize(XmlMapper.Builder builder) {
+					builder.addMixIn(ProblemDetail.class, ProblemDetailJacksonMixin.class);
+				}
+
+			}
+
+		}
+
+		static class StandardXmlMapperBuilderCustomizer extends AbstractMapperBuilderCustomizer<XmlMapper.Builder>
+				implements XmlMapperBuilderCustomizer {
+
+			private final JacksonXmlProperties xmlProperties;
+
+			StandardXmlMapperBuilderCustomizer(JacksonProperties jacksonProperties, Collection<JacksonModule> modules,
+					JacksonXmlProperties xmlProperties) {
+				super(jacksonProperties, modules);
+				this.xmlProperties = xmlProperties;
+			}
+
+			@Override
+			public void customize(XmlMapper.Builder builder) {
+				super.customize(builder);
+				configureFeatures(builder, this.xmlProperties.getRead(), builder::configure);
+				configureFeatures(builder, this.xmlProperties.getWrite(), builder::configure);
+			}
+
+		}
+
+	}
+
 	static class JacksonAutoConfigurationRuntimeHints implements RuntimeHintsRegistrar {
 
 		@Override

module/spring-boot-jackson/src/main/java/org/springframework/boot/jackson/autoconfigure/JacksonXmlProperties.java

@@ -0,0 +1,54 @@
+/*
+ * Copyright 2012-present the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.springframework.boot.jackson.autoconfigure;
+
+import java.util.EnumMap;
+import java.util.Map;
+
+import tools.jackson.dataformat.xml.XmlReadFeature;
+import tools.jackson.dataformat.xml.XmlWriteFeature;
+
+import org.springframework.boot.context.properties.ConfigurationProperties;
+
+/**
+ * Configuration properties to configure Jackson's XML support.
+ *
+ * @author Andy Wilkinson
+ * @since 4.0.0
+ */
+@ConfigurationProperties("spring.jackson.xml")
+public class JacksonXmlProperties {
+
+	/**
+	 * Jackson on/off token reader features that are specific to XML.
+	 */
+	private final Map<XmlReadFeature, Boolean> read = new EnumMap<>(XmlReadFeature.class);
+
+	/**
+	 * Jackson on/off token writer features that are specific to XML.
+	 */
+	private final Map<XmlWriteFeature, Boolean> write = new EnumMap<>(XmlWriteFeature.class);
+
+	public Map<XmlReadFeature, Boolean> getRead() {
+		return this.read;
+	}
+
+	public Map<XmlWriteFeature, Boolean> getWrite() {
+		return this.write;
+	}
+
+}

module/spring-boot-jackson/src/main/java/org/springframework/boot/jackson/autoconfigure/XmlMapperBuilderCustomizer.java

@@ -0,0 +1,39 @@
+/*
+ * Copyright 2012-present the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.springframework.boot.jackson.autoconfigure;
+
+import tools.jackson.dataformat.cbor.CBORMapper.Builder;
+import tools.jackson.dataformat.xml.XmlMapper;
+
+/**
+ * Callback interface that can be implemented by beans wishing to further customize the
+ * {@link XmlMapper} through {@link Builder XmlMapper.Builder} to fine-tune its
+ * auto-configuration.
+ *
+ * @author Andy Wilkinson
+ * @since 4.0.0
+ */
+@FunctionalInterface
+public interface XmlMapperBuilderCustomizer {
+
+	/**
+	 * Customize the XmlMapper.Builder.
+	 * @param xmlMapperBuilder the builder to customize
+	 */
+	void customize(XmlMapper.Builder xmlMapperBuilder);
+
+}