Micronaut 介绍
1. Micronaut 升级到 Micronaut 3.x
Micronaut 快速开始
1. Micronaut 安装CLI
2. Micronaut 创建服务器应用程序
3. Micronaut 设置IDE
4. Micronaut 创建客户端
5. Micronaut 部署应用程序
Micronaut 控制反转
1. Micronaut 定义 Beans
2. Micronaut 是如何工作的
3. Micronaut BeanContext
4. Micronaut 可注射容器类型
5. Micronaut Bean 限定符
6. Micronaut 限制注射类型
7. Micronaut Scopes
8. Micronaut Bean Factories
9. Micronaut 条件 Beans
10. Micronaut Bean 替换
11. Micronaut Bean 配置
12. Micronaut 生命周期方法
13. Micronaut Context Events
14. Micronaut Bean Events
15. Micronaut Bean 自省
16. Micronaut Bean 验证
17. Micronaut Bean 注释元数据
18. Micronaut 从库中导入 Bean
19. Micronaut 可忽略性注解
20. Micronaut Beans 和 Spring
21. Micronaut 安卓支持
Micronaut 应用配置
1. Micronaut 环境
2. Micronaut 使用 PropertySources 的外部化配置
3. Micronaut 配置注入
4. Micronaut 配置属性
5. Micronaut 自定义类型转换器
6. Micronaut 使用@EachProperty 驱动配置
7. Micronaut 使用@EachBean 驱动配置
8. Micronaut 不可变配置
9. Micronaut Bootstrap 配置
10. Micronaut JMX 支持
Micronaut 面向切面编程
1. Micronaut Around Advice
2. Micronaut 介绍 Advice
3. Micronaut Method Adapter Advice
4. Micronaut Bean 生命周期 Advice
5. Micronaut 验证 Advice
6. Micronaut 缓存 Advice
7. Micronaut 重试 Advice
8. Micronaut 计划任务
9. Micronaut 桥接 Spring AOP
Micronaut HTTP 服务器
1. Micronaut 运行嵌入式服务器
2. Micronaut 在特定端口上运行服务器
3. Micronaut HTTP路由
4. Micronaut 简单请求绑定
5. Micronaut 自定义参数绑定
6. Micronaut 主机解析
7. Micronaut 地域解析
8. Micronaut 客户端IP地址
9. Micronaut HttpRequest 和 HttpResponse
10. Micronaut 响应状态
11. Micronaut 响应 Content-Type
12. Micronaut 接收请求的 Content-Type
13. Micronaut 响应式 HTTP 请求处理
14. Micronaut 用 Jackson 进行 JSON 绑定
15. Micronaut 数据验证
16. Micronaut 服务静态资源
17. Micronaut 错误处理
18. Micronaut API 版本控制
19. Micronaut 处理表单数据
20. Micronaut 写入响应数据
21. Micronaut 文件上传
22. Micronaut 文件传输
23. Micronaut HTTP 过滤器
24. Micronaut HTTP Sessions
25. Micronaut 服务器发送事件
26. Micronaut WebSocket 支持
27. Micronaut HTTP/2 支持
28. Micronaut 服务器事件
29. Micronaut 配置 HTTP 服务器
30. Micronaut 服务器端视图渲染
31. Micronaut OpenAPI / Swagger 支持
32. Micronaut GraphQL 支持
Micronaut HTTP 客户端
1. Micronaut 使用低级 HTTP 客户端
2. Micronaut 使用 ProxyHttpClient 代理请求
3. Micronaut 使用 @Client 的声明式 HTTP 客户端
4. Micronaut HTTP 客户端过滤器
5. Micronaut HTTP/2 支持
6. Micronaut HTTP 客户端示例
Micronaut 云原生特性
1. Micronaut 云配置
2. Micronaut 服务发现
3. Micronaut 客户端负载均衡
4. Micronaut 分布式追踪
Micronaut 无服务器函数
1. Micronaut AWS Lambda
2. Micronaut Google Cloud Function
3. Micronaut Google Cloud Run
4. Micronaut Azure Function
Micronaut 消息驱动的微服务
1. Micronaut Kafka 支持
2. Micronaut RabbitMQ 支持
3. Micronaut Nats.io 支持
Micronaut 独立命令行应用程序
1. Micronaut Picocli 支持
Micronaut 配置
1. Micronaut 响应式编程的配置
2. Micronaut 数据访问配置
Micronaut 日志
1. Micronaut 记录日志
2. Micronaut 配置
3. Micronaut Logback
4. Micronaut 日志系统
Micronaut 语言支持
1. Micronaut Java 支持
2. Micronaut Groovy 支持
3. Micronaut Kotlin 支持
4. Micronaut GraalVM 支持
Micronaut 管理与监控
1. Micronaut 创建 Endpoints
2. Micronaut 内置 Endpoints
Micronaut 安全
Micronaut 多租户
Micronaut CLI
1. Micronaut 创建项目
2. Micronaut 特性
3. Micronaut 命令
4. Micronaut 重载
5. Micronaut 代理配置
Micronaut 国际化
1. Micronaut 资源包
2. Micronaut 本地化消息源
Micronaut 附录
1. Micronaut 架构
2. Micronaut FAQ
3. Micronaut 使用快照
4. Micronaut 常见问题

阅读(751) 书签赞(0) 我要纠错

Micronaut 用 Jackson 进行 JSON 绑定

2023-03-06 14:46 更新

现在最常见的数据交换格式是 JSON。

实际上，Controller 注解中的默认值指定 Micronaut 中的控制器默认使用和生成 JSON。

为了以非阻塞方式执行此操作，Micronaut 构建在 Jackson 异步 JSON 解析 API 和 Netty 之上，以便以非阻塞方式读取传入的 JSON。

使用 Reactive Frameworks 绑定

然而，从开发人员的角度来看，您通常可以只使用普通旧式 Java 对象 (POJO)，并且可以选择使用 Reactive 框架，例如 RxJava 或 Project Reactor。下面是一个控制器的例子，它以非阻塞的方式从 JSON 中读取并保存传入的 POJO：

使用 Reactive Streams 读取 JSON

Java Groovy Kotlin

@Controller("/people")
public class PersonController {

    Map<String, Person> inMemoryDatastore = new ConcurrentHashMap<>();

@Post("/saveReactive")
@SingleResult
public Publisher<HttpResponse<Person>> save(@Body Publisher<Person> person) { // (1)
    return Mono.from(person).map(p -> {
                inMemoryDatastore.put(p.getFirstName(), p); // (2)
                return HttpResponse.created(p); // (3)
            }
    );
}

}

@Controller("/people")
class PersonController {

    Map<String, Person> inMemoryDatastore = new ConcurrentHashMap<>()

@Post("/saveReactive")
@SingleResult
Publisher<HttpResponse<Person>> save(@Body Publisher<Person> person) { // (1)
    Mono.from(person).map({ p ->
        inMemoryDatastore.put(p.getFirstName(), p) // (2)
        HttpResponse.created(p) // (3)
    })
}

}

@Controller("/people")
class PersonController {

    internal var inMemoryDatastore: MutableMap<String, Person> = ConcurrentHashMap()

@Post("/saveReactive")
@SingleResult
fun save(@Body person: Publisher<Person>): Publisher<HttpResponse<Person>> { // (1)
    return Mono.from(person).map { p ->
        inMemoryDatastore[p.firstName] = p // (2)
        HttpResponse.created(p) // (3)
    }
}

}

该方法接收一个发布者，一旦读取 JSON，该发布者就会发出 POJO
map 方法将实例存储在 Map 中
返回一个 HttpResponse

从命令行使用 cURL，您可以将 JSON POST 到 /people URI：

使用 cURL POST JSON

$ curl -X POST localhost:8080/people -d '{"firstName":"Fred","lastName":"Flintstone","age":45}'

使用 CompletableFuture 绑定

与前面示例相同的方法也可以改用 CompletableFuture API 编写：

使用 CompletableFuture 读取 JSON

Java Groovy Kotlin

@Controller("/people")
public class PersonController {

    Map<String, Person> inMemoryDatastore = new ConcurrentHashMap<>();

@Post("/saveFuture")
public CompletableFuture<HttpResponse<Person>> save(@Body CompletableFuture<Person> person) {
    return person.thenApply(p -> {
                inMemoryDatastore.put(p.getFirstName(), p);
                return HttpResponse.created(p);
            }
    );
}

}

@Controller("/people")
class PersonController {

    Map<String, Person> inMemoryDatastore = new ConcurrentHashMap<>()

@Post("/saveFuture")
CompletableFuture<HttpResponse<Person>> save(@Body CompletableFuture<Person> person) {
    person.thenApply({ p ->
        inMemoryDatastore.put(p.getFirstName(), p)
        HttpResponse.created(p)
    })
}

}

@Controller("/people")
class PersonController {

    internal var inMemoryDatastore: MutableMap<String, Person> = ConcurrentHashMap()

@Post("/saveFuture")
fun save(@Body person: CompletableFuture<Person>): CompletableFuture<HttpResponse<Person>> {
    return person.thenApply { p ->
        inMemoryDatastore[p.firstName] = p
        HttpResponse.created(p)
    }
}

}

上面的例子使用thenApply方法实现的和前面的例子一样。

使用 POJO 进行绑定

但是请注意，您可以轻松地编写：

绑定 JSON POJO

Java Groovy Kotlin

@Controller("/people")
public class PersonController {

    Map<String, Person> inMemoryDatastore = new ConcurrentHashMap<>();

@Post
public HttpResponse<Person> save(@Body Person person) {
    inMemoryDatastore.put(person.getFirstName(), person);
    return HttpResponse.created(person);
}

}

@Controller("/people")
class PersonController {

    Map<String, Person> inMemoryDatastore = new ConcurrentHashMap<>()

@Post
HttpResponse<Person> save(@Body Person person) {
    inMemoryDatastore.put(person.getFirstName(), person)
    HttpResponse.created(person)
}

}

@Controller("/people")
class PersonController {

    internal var inMemoryDatastore: MutableMap<String, Person> = ConcurrentHashMap()

@Post
fun save(@Body person: Person): HttpResponse<Person> {
    inMemoryDatastore[person.firstName] = person
    return HttpResponse.created(person)
}

}

只有在以非阻塞方式读取数据后，Micronaut 才会执行您的方法。

Jackson 产生的输出可以通过多种方式定制，从定义 Jackson 模块到使用 Jackson 注释

Jackson 配置

可以通过使用 JacksonConfiguration 类进行配置来配置 Jackson ObjectMapper。

所有 Jackson 配置键都以 jackson 开头。

dateFormat	String	日期格式
locale	String	使用 Locale.forLanguageTag。例子: `en-US`
timeZone	String	使用 TimeZone.getTimeZone。例子: `PST`
serializationInclusion	String	JsonInclude.Include 之一。例子: `ALWAYS`
propertyNamingStrategy	String	PropertyNamingStrategy 实例的名称。例子: `SNAKE_CASE`
defaultTyping	String	用于枚举 ObjectMapper.DefaultTyping 的多态类型处理的全局 defaultTyping。例子: `NON_FINAL`

示例:

Properties Yaml Toml Groovy Hocon JSON

jackson.serializationInclusion=ALWAYS

jackson:
  serializationInclusion: ALWAYS

[jackson]
  serializationInclusion="ALWAYS"

jackson {
  serializationInclusion = "ALWAYS"
}

{
  jackson {
    serializationInclusion = "ALWAYS"
  }
}

{
  "jackson": {
    "serializationInclusion": "ALWAYS"
  }
}

特性

所有功能都可以配置为它们的名称作为键和一个布尔值来指示启用或禁用。

serialization	Map	SerializationFeature
deserialization	Map	DeserializationFeature
mapper	Map	MapperFeature
parser	Map	JsonParser.Feature
generator	Map	JsonGenerator.Feature
factory	Map	JsonFactory.Feature

示例:

Properties Yaml Toml Groovy Hocon JSON

jackson.serialization.indentOutput=true
jackson.serialization.writeDatesAsTimestamps=false
jackson.deserialization.useBigIntegerForInts=true
jackson.deserialization.failOnUnknownProperties=false

jackson:
  serialization:
    indentOutput: true
    writeDatesAsTimestamps: false
  deserialization:
    useBigIntegerForInts: true
    failOnUnknownProperties: false

[jackson]
  [jackson.serialization]
    indentOutput=true
    writeDatesAsTimestamps=false
  [jackson.deserialization]
    useBigIntegerForInts=true
    failOnUnknownProperties=false

jackson {
  serialization {
    indentOutput = true
    writeDatesAsTimestamps = false
  }
  deserialization {
    useBigIntegerForInts = true
    failOnUnknownProperties = false
  }
}

{
  jackson {
    serialization {
      indentOutput = true
      writeDatesAsTimestamps = false
    }
    deserialization {
      useBigIntegerForInts = true
      failOnUnknownProperties = false
    }
  }
}

{
  "jackson": {
    "serialization": {
      "indentOutput": true,
      "writeDatesAsTimestamps": false
    },
    "deserialization": {
      "useBigIntegerForInts": true,
      "failOnUnknownProperties": false
    }
  }
}

进一步自定义 JsonFactory

在某些情况下，您可能希望在功能配置之外自定义 ObjectMapper 使用的 JsonFactory（例如，允许自定义字符转义）。这可以通过提供您自己的 JsonFactory bean 或通过提供在启动时配置默认 bean 的 BeanCreatedEventListener<JsonFactory> 来实现。

支持@JsonView

如果在配置文件（例如 application.yml）中将 jackson.json-view.enabled 设置为 true，则可以在控制器方法上使用 @JsonView 注释。

Jackson 的 @JsonView 注释允许您控制在每个响应的基础上公开哪些属性。

Beans

除了配置之外，还可以注册 bean 来自定义 Jackson。扩展以下任何类的所有 bean 都在对象映射器中注册：

服务加载器

通过服务加载器注册的任何模块也将添加到默认对象映射器。

数字精度

在 JSON 解析期间，框架可能会将任何传入数据转换为中间对象模型。默认情况下，此模型使用 BigInteger、long 和 double 作为数值。这意味着可能会丢失一些可以由 BigDecimal 表示的信息。例如，即使反序列化的目标类型使用 BigDecimal，也可能会截断不能用 double 表示的具有许多小数位的数字。关于尾随零数的元数据 (BigDecimal.precision())，例如0.12 和 0.120 之间的差异也被丢弃。

如果您需要数字类型的完全准确性，请使用以下配置：

Properties Yaml Toml Groovy Hocon JSON

jackson.deserialization.useBigIntegerForInts=true
jackson.deserialization.useBigDecimalForFloats=true

jackson:
  deserialization:
    useBigIntegerForInts: true
    useBigDecimalForFloats: true

[jackson]
  [jackson.deserialization]
    useBigIntegerForInts=true
    useBigDecimalForFloats=true

jackson {
  deserialization {
    useBigIntegerForInts = true
    useBigDecimalForFloats = true
  }
}

{
  jackson {
    deserialization {
      useBigIntegerForInts = true
      useBigDecimalForFloats = true
    }
  }
}

{
  "jackson": {
    "deserialization": {
      "useBigIntegerForInts": true,
      "useBigDecimalForFloats": true
    }
  }
}

以上内容是否对您有帮助：

← Micronaut 响应式 HTTP 请求处理

Micronaut 数据验证 →

写笔记

我要补充