电子书 – Spring Cloud 指南 – NPI EA (分类=Spring Cloud)
announcement - icon

让我们开始使用 Spring Cloud 的微服务架构

>> 加入 Pro 并下载电子书

电子书 – Mockito – NPI EA (标签 = Mockito)
announcement - icon

模拟是单元测试的重要组成部分,Mockito 库使编写 清晰直观的单元测试 变得容易,用于您的 Java 代码。

通过我们的 Mockito 指南 开始模拟,并改进您的应用程序测试

下载电子书

电子书 – Java 并发 – NPI EA (分类=Java 并发)
announcement - icon

在应用程序中处理并发可能是一个棘手的过程,其中包含许多 潜在的陷阱。 扎实的掌握基本知识将有助于最大程度地减少这些问题。

通过我们的 Java 并发 指南开始了解多线程应用程序

>> 下载电子书

电子书 – 响应式 – NPI EA (分类=响应式)
announcement - icon

Spring 5 增加了对使用 Spring WebFlux 模块进行响应式编程的支持,此支持自那时起不断改进。 开始使用 Reactor 项目基础知识和 Spring Boot 中的响应式编程

>> 加入 Pro 并下载电子书

电子书 – Java Streams – NPI EA (分类=Java Streams)
announcement - icon

自从 Java 8 引入以来,Stream API 已成为 Java 开发的基础。 基本操作,例如迭代、过滤、映射元素序列,使用起来看似很简单。

但这些也可能被过度使用并陷入一些常见陷阱。

更好地了解 Stream 的工作方式 以及如何将其与其他语言功能结合使用,请查看我们关于 Java Streams 的指南

>> 加入 Pro 并下载电子书

电子书 – Jackson – NPI EA (分类=Jackson)
announcement - icon

用 Jackson 正确处理 JSON

下载电子书

电子书 – HTTP 客户端 – NPI EA (分类=Http 客户端)
announcement - icon

充分利用 Apache HTTP 客户端

下载电子书

电子书 – Maven – NPI EA (分类 = Maven)
announcement - icon

开始使用 Apache Maven

下载电子书

电子书 – 持久化 – NPI EA (分类=持久化)
announcement - icon

您在努力实现正确的持久化层 Spring 吗?

探索电子书

电子书 – RwS – NPI EA (分类=Spring MVC)
announcement - icon

使用 Spring 构建 REST API 吗?

下载电子书

课程 – LS – NPI EA (分类=Jackson)
announcement - icon

通过 Learn Spring 课程开始学习 Spring 和 Spring Boot

>> 学习 SPRING
课程 – RWSB – NPI EA (分类=REST)
announcement - icon

通过构建一个完整的 REST API,深入了解 Spring Boot 3 和 Spring 6,使用该框架

>> 全新的“REST With Spring Boot”

课程 – LSS – NPI EA (分类=Spring Security)
announcement - icon

是的,Spring Security 可能很复杂,从核心内的更高级功能到框架中深入的 OAuth 支持。

我将安全材料构建为 两个完整的课程 - 核心和 OAuth,以针对这些更复杂的场景进行实践。 我们探索何时以及如何使用每个功能,并 在后台项目中对其进行编码

您可以在这里探索该课程

>> 学习 Spring Security

课程 – LSD – NPI EA (标签=Spring Data JPA)
announcement - icon

Spring Data JPA 是处理 JPA 复杂性的绝佳方式,它具有 Spring Boot 的强大简洁性

通过引导式参考课程开始使用 Spring Data JPA

>> 查看课程

合作伙伴 – Moderne – NPI EA (类别=Spring Boot)
announcement - icon

使用 OpenRewrite 安全且自动地重构 Java 代码。

手动重构大型代码库既缓慢、有风险,又容易拖延。OpenRewrite 应运而生。这个用于大规模、自动化代码转换的开源框架可以帮助团队安全、一致地进行现代化改造。

每个月,OpenRewrite 的创建者和维护者 Moderne 都会举办现场、实践培训课程——一个面向初学者,一个面向经验丰富的用户。您将了解配方的运作方式、如何将其应用于项目,以及如何自信地进行代码现代化改造。

参加下一次课程,带来您的问题,并学习如何自动化通常会占用您 sprint 时间的工作。

合作伙伴 – LambdaTest – NPI EA (类别=测试)
announcement - icon

回归测试是发布流程中的重要步骤,以确保新代码不会破坏现有功能。随着代码库的不断发展,我们希望频繁运行这些测试,以便尽早发现任何问题。

确保这些测试以自动化的方式频繁运行的最佳方法当然是将其包含在 CI/CD 管道中。 这样,每次向仓库提交代码时,回归测试将自动执行。

在本教程中,我们将学习如何使用 Selenium 创建回归测试,然后使用 GitHub Actions 将它们包含在我们的管道中,在 LambdaTest 云网格上运行

>> 如何使用 GitHub Actions 运行 Selenium 回归测试

课程 – LJB – NPI EA (类别 = Core Java)
announcement - icon

通过编码方式构建 Java 的坚实、实用的基础

>> 学习 Java 基础

电子书 – Jackson – NPI (分类=Jackson)
announcement - icon

Jackson 和 JSON 在 Java 中,最终通过实践学习的方式掌握

>> 下载电子书

1. 概述

在使用 JSON 格式时,Spring Boot 将使用一个 ObjectMapper 实例来序列化响应和反序列化请求。

在本教程中,我们将了解配置序列化和反序列化选项的最常见方法。

要了解更多关于 Jackson 的信息,请务必查看我们的 Jackson 教程

更多阅读

Spring JSON-P 与 Jackson

本文重点介绍如何在 Spring 4.1 中使用新的 JSON-P 支持。

如何在 Spring MVC 中设置 JSON 内容类型

了解在 Spring MVC 中设置内容类型的不同选项。

Jackson ObjectMapper 入门

文章讨论了 Jackson 的核心 ObjectMapper 类、基本的序列化和反序列化,以及配置这两个过程。

2. 默认配置

默认情况下,Spring Boot 配置将禁用以下设置

  • MapperFeature.DEFAULT_VIEW_INCLUSION
  • DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES
  • SerializationFeature.WRITE_DATES_AS_TIMESTAMPS

让我们从一个简单的示例开始

  • 客户端将发送一个 GET 请求到我们的 /coffee?name=Lavazza
  • 控制器将返回一个新的 Coffee 对象。
  • Spring 将使用 ObjectMapper 将我们的 POJO 序列化为 JSON。

我们将通过使用 StringLocalDateTime 对象来举例说明自定义选项

public class Coffee {

    private String name;
    private String brand;
    private LocalDateTime date;

   //getters and setters
}

我们还将定义一个简单的 REST 控制器来演示序列化:

@GetMapping("/coffee")
public Coffee getCoffee(@RequestParam(name = "brand", required = false) String brand,
    @RequestParam(name = "name", required = false) String name) {
    return new Coffee()
      .setBrand(brand)
      .setDate(FIXED_DATE)
      .setName(name);
}

默认情况下,调用 GET http://lolcahost:8080/coffee?brand=Lavazza 时,这将是响应

{
  "name": null,
  "brand": "Lavazza",
  "date": "2020-11-16T10:21:35.974"
}

我们希望排除 null 值并拥有自定义日期格式(dd-MM-yyyy HH:mm)。这是我们的最终响应

{
  "brand": "Lavazza",
  "date": "04-11-2020 10:34"
}

在使用 Spring Boot 时,我们有选择自定义默认 ObjectMapper 或覆盖它的选项。我们将在下一节中介绍这两种选项。

3. 自定义默认 ObjectMapper

在本节中,我们将了解如何自定义 Spring Boot 使用的默认 ObjectMapper

3.1. 应用程序属性和自定义 Jackson 模块

配置 mapper 最简单的方法是通过应用程序属性。

这是配置的一般结构

spring.jackson.<category_name>.<feature_name>=true,false

例如,以下是我们添加以禁用 SerializationFeature.WRITE_DATES_AS_TIMESTAMPS 的内容

spring.jackson.serialization.write-dates-as-timestamps=false

除了提到的特性类别,我们还可以配置属性包含

spring.jackson.default-property-inclusion=always, non_null, non_absent, non_default, non_empty

配置环境变量是最简单的方法。 这种方法的缺点是,我们无法自定义高级选项,例如为 LocalDateTime 设置自定义日期格式。

此时,我们将获得此结果

{
  "brand": "Lavazza",
  "date": "2020-11-16T10:35:34.593"
}

为了实现我们的目标,我们将使用自定义日期格式注册一个新的 JavaTimeModule 

@Configuration
@PropertySource("classpath:coffee.properties")
public class CoffeeRegisterModuleConfig {

    @Bean
    public Module javaTimeModule() {
        JavaTimeModule module = new JavaTimeModule();
        module.addSerializer(LOCAL_DATETIME_SERIALIZER);
        return module;
    }
}

此外,配置文件 coffee.properties 将包含以下内容

spring.jackson.default-property-inclusion=non_null

Spring Boot 将自动注册任何类型为 com.fasterxml.jackson.databind.Module 的 bean。这是我们的最终结果

{
  "brand": "Lavazza",
  "date": "16-11-2020 10:43"
}

3.2. Jackson2ObjectMapperBuilderCustomizer

此功能接口的目的是允许我们创建配置 bean。

它们将应用于通过 Jackson2ObjectMapperBuilder 创建的默认 ObjectMapper

@Bean
public Jackson2ObjectMapperBuilderCustomizer jsonCustomizer() {
    return builder -> builder.serializationInclusion(JsonInclude.Include.NON_NULL)
      .serializers(LOCAL_DATETIME_SERIALIZER);
}

配置 bean 的应用顺序是特定的,我们可以使用 @Order  注解来控制它。 如果我们想从不同的配置或模块配置 ObjectMapper,这种优雅的方法是合适的。

4. 覆盖默认配置

如果我们想要完全控制配置,有几种方法可以禁用自动配置,并仅应用我们的自定义配置。

让我们仔细看看这些选项。

4.1. ObjectMapper

覆盖默认配置最简单的方法是定义一个ObjectMapper bean,并将其标记为@Primary

@Bean
@Primary
public ObjectMapper objectMapper() {
    JavaTimeModule module = new JavaTimeModule();
    module.addSerializer(LOCAL_DATETIME_SERIALIZER);
    return new ObjectMapper()
      .setSerializationInclusion(JsonInclude.Include.NON_NULL)
      .registerModule(module);
}

当我们想要完全控制序列化过程,并且不希望允许外部配置时,应该使用这种方法。

4.2. Jackson2ObjectMapperBuilder

另一种简洁的方法是定义一个Jackson2ObjectMapperBuilder bean

Spring Boot 在构建ObjectMapper时实际上默认使用这个 builder,并且会自动选择定义的 builder

@Bean
public Jackson2ObjectMapperBuilder jackson2ObjectMapperBuilder() {
    return new Jackson2ObjectMapperBuilder().serializers(LOCAL_DATETIME_SERIALIZER)
      .serializationInclusion(JsonInclude.Include.NON_NULL);
}

它默认会配置两个选项

  • 禁用MapperFeature.DEFAULT_VIEW_INCLUSION
  • 禁用DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES

根据Jackson2ObjectMapperBuilder文档,如果类路径上存在,它还会注册一些模块

  • jackson-datatype-jdk8:支持其他 Java 8 类型,如Optional
  • jackson-datatype-jsr310:支持 Java 8 日期和时间 API 类型
  • jackson-datatype-joda:支持 Joda-Time 类型
  • jackson-module-kotlin:支持 Kotlin 类和数据类

这种方法的优势在于Jackson2ObjectMapperBuilder提供了一种简单直观的方式来构建ObjectMapper

4.3. MappingJackson2HttpMessageConverter

我们可以定义一个类型为MappingJackson2HttpMessageConverter的 bean,Spring Boot 会自动使用它

@Bean
public MappingJackson2HttpMessageConverter mappingJackson2HttpMessageConverter() {
    Jackson2ObjectMapperBuilder builder = new Jackson2ObjectMapperBuilder().serializers(LOCAL_DATETIME_SERIALIZER)
      .serializationInclusion(JsonInclude.Include.NON_NULL);
    return new MappingJackson2HttpMessageConverter(builder.build());
}

请务必查看我们的 Spring Http Message Converters 文章以了解更多信息。

5. 测试配置

为了测试我们的配置,我们将使用TestRestTemplate并将对象序列化为String

这样,我们可以验证我们的Coffee对象是否在没有null值的情况下,并使用自定义日期格式进行序列化

@Test
public void whenGetCoffee_thenSerializedWithDateAndNonNull() {
    String formattedDate = DateTimeFormatter.ofPattern(CoffeeConstants.dateTimeFormat).format(FIXED_DATE);
    String brand = "Lavazza";
    String url = "/coffee?brand=" + brand;
    
    String response = restTemplate.getForObject(url, String.class);
    
    assertThat(response).isEqualTo("{\"brand\":\"" + brand + "\",\"date\":\"" + formattedDate + "\"}");
}

6. 结论

在本文中,我们研究了几种在使用 Spring Boot 时配置 JSON 序列化选项的方法。

我们看到了两种不同的方法:配置默认选项或覆盖默认配置。

支持本文的代码可在 GitHub 上获取。 一旦你Baeldung Pro 会员 身份登录,就开始学习并在项目上进行编码。
Baeldung Pro – NPI EA (类别 = Baeldung)
announcement - icon

Baeldung Pro 具有完全无广告以及最终具有深色模式,提供干净的学习体验

>> 探索干净的 Baeldung

一旦早期采用者的席位全部用完,价格将上涨并保持在每年 33 美元。

电子书 – HTTP 客户端 – NPI EA (类别=HTTP 客户端)
announcement - icon

Apache HTTP Client 是一个非常强大的库,适用于简单和高级用例,在测试 HTTP 端点时尤其适用。 查看我们的指南,涵盖基本请求和响应处理,以及安全性、Cookie、超时等。

>> 下载电子书

电子书 – Java 并发 – NPI EA (分类=Java 并发)
announcement - icon

在应用程序中处理并发可能是一个棘手的过程,其中包含许多 潜在的陷阱。 扎实的掌握基本知识将有助于最大程度地减少这些问题。

通过我们的 Java 并发 指南开始了解多线程应用程序

>> 下载电子书

电子书 – Java Streams – NPI EA (分类=Java Streams)
announcement - icon

自从 Java 8 引入以来,Stream API 已成为 Java 开发的基础。 基本操作,例如迭代、过滤、映射元素序列,使用起来看似很简单。

但这些也可能被过度使用并陷入一些常见陷阱。

更好地了解 Stream 的工作方式 以及如何将其与其他语言功能结合使用,请查看我们关于 Java Streams 的指南

>> 加入 Pro 并下载电子书

电子书 – 持久化 – NPI EA (分类=持久化)
announcement - icon

您在努力实现正确的持久化层 Spring 吗?

探索电子书

课程 – LS – NPI EA (类别=REST)

announcement - icon

从 Spring Boot 开始,通过 Learn Spring 课程了解核心 Spring。

>> 查看课程

合作伙伴 – Moderne – NPI EA (标签=重构)
announcement - icon

现代 Java 团队行动迅速——但代码库并不总是跟上。 框架会发生变化,依赖关系会漂移,技术债务会累积,直到它开始拖慢交付速度。 OpenRewrite 就是为此而构建的:一个开源重构引擎,可在保持开发人员意图不变的同时自动化重复的代码更改。

由 Moderne 的 OpenRewrite 创建者和维护者领导的每月培训系列,将介绍实际的迁移和现代化模式。 无论您是重构配方的新手,还是准备编写自己的配方,您都将学习以安全且可扩展的方式进行重构的实用方法。

如果您曾经希望重构感觉像编写代码一样自然——并且一样快速——这是一个很好的起点

电子书 Jackson – NPI EA – 3 (类别 = Jackson)
电子书 Jackson – NPI (cat = Jackson)
© .