Micronaut声明式客户端如何将text/html响应绑定为JSON并转为Pharmacy对象列表
Micronaut声明式HTTP客户端响应绑定为指定POJO列表的实现方案
问题核心原因:Micronaut的响应绑定逻辑是基于响应头的
Content-Type自动匹配对应的HttpMessageReader实现。默认仅对application/json等标准MIME类型注册了支持POJO直接绑定的Jackson解析器,对text/html没有内置POJO绑定能力,因此会将JSON结构的响应内容降级解析为通用的LinkedHashMap,即便你声明了返回类型为List<Pharmacy>也不会生效。
方案一:强制指定使用JSON解析器(适用于响应MIME为text/html但实际内容为JSON的场景)
绝大多数出现该问题的场景都是服务端错误将JSON响应的Content-Type头设为了text/html,只需在声明式客户端的请求方法上手动指定期望处理的媒体类型,即可让Micronaut跳过自动MIME匹配,直接用Jackson解析器绑定POJO。
修改后的客户端代码:
@Client("${services.url}") public interface PharmacyClient { @Get( value = "${services.path}?${services.param}=${services.value}", produces = MediaType.APPLICATION_JSON ) Flowable<List<Pharmacy>> retrieve(); }
- 需引入
io.micronaut.http.MediaType依赖 - 修改后响应内容会直接被反序列化为
Pharmacy实例,原有StoreService中的调用逻辑无需改动,即可正常调用pharmacy.getBoroughFk()方法。
方案二:自定义HTML响应解析器(适用于响应为标准HTML文档的场景)
如果服务返回的text/html是真实的HTML内容而非JSON结构,就需要自定义实现针对HTML的HttpMessageReader,通过Jsoup等工具解析HTML字段并绑定到Pharmacy对象,将该解析器注册为Micronaut Bean后,即可自动处理对应类型的响应绑定。
注意事项
- 确保
Pharmacy类符合Jackson反序列化规范:默认需要无参构造器、字段提供对应的getter/setter,若字段名和响应JSON的key不一致,可使用@JsonProperty注解标记映射关系。
内容的提问来源于stack exchange,提问作者jics
相关产品推荐
相关产品推荐

