From 85bdea6f47ed3654b12d696b6936671d7e6b5a2d Mon Sep 17 00:00:00 2001 From: Sam Brannen Date: Tue, 28 Sep 2021 13:41:25 +0200 Subject: [PATCH] Fix code formatting in Javadoc See gh-27480 --- .../json/Jackson2ObjectMapperFactoryBean.java | 82 +++++++++---------- 1 file changed, 38 insertions(+), 44 deletions(-) diff --git a/spring-web/src/main/java/org/springframework/http/converter/json/Jackson2ObjectMapperFactoryBean.java b/spring-web/src/main/java/org/springframework/http/converter/json/Jackson2ObjectMapperFactoryBean.java index 376e6b27737..adc81d96b16 100644 --- a/spring-web/src/main/java/org/springframework/http/converter/json/Jackson2ObjectMapperFactoryBean.java +++ b/spring-web/src/main/java/org/springframework/http/converter/json/Jackson2ObjectMapperFactoryBean.java @@ -62,54 +62,51 @@ import org.springframework.lang.Nullable; *

Example usage with * {@link MappingJackson2HttpMessageConverter}: * - * 

{@code
- * 
- *   
- *     
+ * <bean class="org.springframework.http.converter.json.MappingJackson2HttpMessageConverter">
+ *   <property name="objectMapper">
+ *     <bean class="org.springframework.http.converter.json.Jackson2ObjectMapperFactoryBean"
  *       p:autoDetectFields="false"
  *       p:autoDetectGettersSetters="false"
- *       p:annotationIntrospector-ref="jaxbAnnotationIntrospector" />
- *   
- * 
- * }
+ * p:annotationIntrospector-ref="jaxbAnnotationIntrospector" /> + * </property> + * </bean> * *

Example usage with MappingJackson2JsonView: * - * 

{@code
- * 
- *   
- *     
+ * <bean class="org.springframework.web.servlet.view.json.MappingJackson2JsonView">
+ *   <property name="objectMapper">
+ *     <bean class="org.springframework.http.converter.json.Jackson2ObjectMapperFactoryBean"
  *       p:failOnEmptyBeans="false"
- *       p:indentOutput="true">
- *       
- *         
- *           
- *         
- *       
- *     
- *   
- * 
- * }
+ * p:indentOutput="true"> + * <property name="serializers"> + * <array> + * <bean class="org.mycompany.MyCustomSerializer" /> + * </array> + * </property> + * </bean> + * </property> + * </bean> * *

In case there are no specific setters provided (for some rarely used options), * you can still use the more general methods {@link #setFeaturesToEnable} and * {@link #setFeaturesToDisable}. * - * 

{@code
- * 
- *   
- *     
- *       
- *       
- *     
- *   
- *   
- *     
- *       
- *     
- *   
- * 
- * }
+ * 
+ * <bean class="org.springframework.http.converter.json.Jackson2ObjectMapperFactoryBean">
+ *   <property name="featuresToEnable">
+ *     <array>
+ *       <util:constant static-field="com.fasterxml.jackson.databind.SerializationFeature.WRAP_ROOT_VALUE"/>
+ *       <util:constant static-field="com.fasterxml.jackson.databind.SerializationFeature.CLOSE_CLOSEABLE"/>
+ *     </array>
+ *   </property>
+ *   <property name="featuresToDisable">
+ *     <array>
+ *       <util:constant static-field="com.fasterxml.jackson.databind.MapperFeature.USE_ANNOTATIONS"/>
+ *     </array>
+ *   </property>
+ * </bean>
* *

It also automatically registers the following well-known modules if they are * detected on the classpath: @@ -120,8 +117,6 @@ import org.springframework.lang.Nullable; * support for other Java 8 types like {@link java.util.Optional} *

  • jackson-datatype-jsr310: * support for Java 8 Date & Time API types
    • - *
  • jackson-datatype-joda: - * support for Joda-Time types
    • *
  • jackson-module-kotlin: * support for Kotlin classes and data classes
    • * @@ -129,11 +124,10 @@ import org.springframework.lang.Nullable; *

    In case you want to configure Jackson's {@link ObjectMapper} with a custom {@link Module}, * you can register one or more such Modules by class name via {@link #setModulesToInstall}: * - * 

    {@code
- * 
- *   
- * 
+ * 
    + * <bean class="org.springframework.http.converter.json.Jackson2ObjectMapperFactoryBean">
+ *   <property name="modulesToInstall" value="myapp.jackson.MySampleModule,myapp.jackson.MyOtherModule"/>
+ * </bean>
    
  *
  * 
    Compatible with Jackson 2.9 to 2.12, as of Spring 5.3.
  *