0

0

Java JAXB Unmarshaller.Listener 监听反序列化过程

煙雲

煙雲

发布时间:2026-03-09 11:27:35

|

417人浏览过

|

来源于php中文网

原创

unmarshaller.listener 是 jaxb 的对象生命周期回调机制,仅在对象创建前后触发 beforeunmarshal 和 afterunmarshal,不拦截字段赋值过程,无法访问 @xmltransient 字段原始 xml 值,且 listener 单次绑定、不可复用。

java jaxb unmarshaller.listener 监听反序列化过程

Unmarshaller.Listener 是什么,它真能拦截反序列化字段赋值?

Unmarshaller.Listener 是 JAXB 提供的轻量级回调机制,但它不监听字段赋值本身,只在对象实例创建前后触发——即 beforeUnmarshalafterUnmarshal。很多人误以为它能像 Spring AOP 那样拦截每个字段设值,结果发现 setXXX 方法调用完全不可见。

  • 它监听的是「对象生命周期」,不是「属性绑定过程」
  • beforeUnmarshal 在 new 实例后、任何字段填充前执行;此时对象字段全是默认值(null0false
  • afterUnmarshal 在所有字段赋值完成、所有 @XmlIDREF 解析完毕后才调用
  • 不支持中断反序列化流程,也不能修改即将写入的值
public class MyListener extends Unmarshaller.Listener {
    @Override
    public void beforeUnmarshal(Object target, Object parent) {
        // target 已 new 出来,但所有字段仍是 null/0/false
        System.out.println("created: " + target); // 可安全 cast 到具体类型
    }
    @Override
    public void afterUnmarshal(Object target, Object parent) {
        // 此时 target 所有字段已按 XML 填好,包括嵌套对象
        if (target instanceof User) {
            ((User) target).postProcess(); // 这里做校验或补全逻辑较安全
        }
    }
}

怎么注册 Listener?别漏掉 setListener() 调用时机

Listener 必须在调用 unmarshal() 之前设置,且仅对当次反序列化生效。常见错误是:先调用 unmarshal() 再 set,或在 Unmarshaller 复用时覆盖了前一次的监听。

  • Unmarshaller 不是线程安全的,每次反序列化建议新取一个实例

  • 不能通过 JAXBContext.createUnmarshaller() 后长期缓存并复用 listener —— listener 是单次绑定的

    立即学习Java免费学习笔记(深入)”;

  • 如果用 Spring 的 Jaxb2Marshaller,需通过 setUnmarshallerListener() 设置,而非直接调 setListener()

  • 使用原生 API 时:

    • 获取 Unmarshaller 实例后立即调用 unmarshaller.setListener(new MyListener())
    • 不要在 try-with-resources 块外提前释放或复用该实例

为什么 afterUnmarshal 里拿不到 @XmlTransient 字段的原始 XML 值?

afterUnmarshal 触发时,JAXB 已完成全部标准绑定逻辑,但不会保留原始 XML 片段。如果你需要访问某个字段对应的原始文本(比如跳过类型转换、处理格式异常),Unmarshaller.Listener 无能为力。

  • @XmlTransient 字段本就不会被反序列化,listener 更不可能“看到”它

    墨鱼aigc
    墨鱼aigc

    一款超好用的Ai写作工具,为用户提供一键生成营销广告、原创文案、写作辅助等文字生成服务。

    下载
  • 想获取原始内容,必须改用 SAXParserStAX 手动解析,或在 DTO 中保留 String 类型字段 + 自定义 XmlAdapter

  • 常见误操作:在 afterUnmarshal 里试图从 target 反查 XML 属性名或位置信息 —— JAXB 不提供这类上下文

  • 替代方案示例(需配合 XmlAdapter):

    public class RawXmlAdapter extends XmlAdapter<String, String> {
        @Override
        public String unmarshal(String v) { return v; } // 原样返回,不解析
        @Override
        public String marshal(String v) { return v; }
    }
    
    然后在字段上加 @XmlJavaTypeAdapter(RawXmlAdapter.class)

Listener 在继承体系中怎么传递?父类监听器会被子类覆盖吗?

JAXB 对 listener 的调用是「按实际反序列化类型触发」,不是按声明类型。如果子类没有重写 afterUnmarshal,父类的实现仍会执行;但如果子类也定义了 listener,则以最后一次 setListener() 绑定的对象为准,不存在自动继承或合并。

  • listener 是单个对象引用,不是策略栈,无法叠加多个

  • 若需统一处理基类逻辑,推荐让所有 listener 继承同一个基类,并在 afterUnmarshal 中判断 instanceof 分支处理

  • 注意:JAXB 反序列化时可能创建代理对象(如 com.sun.org.apache.xerces.internal.dom.ElementNSImpl),target 类型未必是你写的 POJO

  • 安全做法:

    • listener 中避免强转未确认类型的 target,先用 getClass().getName() 日志调试
    • 若需处理多类型,用 Map<class>, Consumer<object>></object></class> 做分发,而不是靠继承链
    • 不要依赖 listener 执行顺序——JAXB 不保证嵌套对象的回调先后

Listener 看似简单,但它的触发时机和作用域边界非常窄。最容易忽略的是:它完全不介入属性级绑定,也不暴露 XML 解析上下文。真要干预字段级行为,得换 XmlAdapter 或底层解析器。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
spring框架介绍
spring框架介绍

本专题整合了spring框架相关内容,想了解更多详细内容,请阅读专题下面的文章。

154

2025.08.06

Java Spring Security 与认证授权
Java Spring Security 与认证授权

本专题系统讲解 Java Spring Security 框架在认证与授权中的应用,涵盖用户身份验证、权限控制、JWT与OAuth2实现、跨站请求伪造(CSRF)防护、会话管理与安全漏洞防范。通过实际项目案例,帮助学习者掌握如何 使用 Spring Security 实现高安全性认证与授权机制,提升 Web 应用的安全性与用户数据保护。

88

2026.01.26

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

990

2023.08.02

c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

253

2023.09.22

java中null的用法
java中null的用法

在Java中,null表示一个引用类型的变量不指向任何对象。可以将null赋值给任何引用类型的变量,包括类、接口、数组、字符串等。想了解更多null的相关内容,可以阅读本专题下面的文章。

1069

2024.03.01

c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

253

2023.09.22

java中null的用法
java中null的用法

在Java中,null表示一个引用类型的变量不指向任何对象。可以将null赋值给任何引用类型的变量,包括类、接口、数组、字符串等。想了解更多null的相关内容,可以阅读本专题下面的文章。

1069

2024.03.01

c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

253

2023.09.22

JavaScript浏览器渲染机制与前端性能优化实践
JavaScript浏览器渲染机制与前端性能优化实践

本专题围绕 JavaScript 在浏览器中的执行与渲染机制展开,系统讲解 DOM 构建、CSSOM 解析、重排与重绘原理,以及关键渲染路径优化方法。内容涵盖事件循环机制、异步任务调度、资源加载优化、代码拆分与懒加载等性能优化策略。通过真实前端项目案例,帮助开发者理解浏览器底层工作原理,并掌握提升网页加载速度与交互体验的实用技巧。

59

2026.03.06

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Kotlin 教程
Kotlin 教程

共23课时 | 4.2万人学习

C# 教程
C# 教程

共94课时 | 11万人学习

Java 教程
Java 教程

共578课时 | 79.3万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号