重写第三方库XmlAdapter：修正JAXB Calendar时区序列化错误

首先，第三方库的DateConversion.printDate确实有问题——它没给SimpleDateFormat设置时区，导致转换时用了JVM默认时区，生成的日期自然不符合预期。你的思路是对的：重写XmlAdapter来带时区处理，但没生效大概率是Adapter实现不完整或者第三方库的注解优先级覆盖了你的全局设置，咱们逐个解决：

1. 先确认你的自定义XmlAdapter实现是否正确 #

你只贴了注册代码，没贴DateFormatterAdapter的完整实现。它必须正确继承XmlAdapter<String, Calendar>，并且在marshal方法里调用你写的带时区的printDate方法。给你个标准实现参考：

public class DateFormatterAdapter extends XmlAdapter<String, Calendar> {
    private final TimeZone targetTimeZone;

    // 构造器传入目标时区
    public DateFormatterAdapter(TimeZone timeZone) {
        this.targetTimeZone = timeZone;
    }

    @Override
    public String marshal(Calendar value) throws Exception {
        // 调用你自定义的带时区的转换方法
        return DateConversion.printDate(value, targetTimeZone);
    }

    @Override
    public Calendar unmarshal(String value) throws Exception {
        // 如果需要反序列化（从XML转Calendar），也要对应处理时区
        SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd");
        sdf.setTimeZone(targetTimeZone);
        Date date = sdf.parse(value);
        Calendar cal = Calendar.getInstance(targetTimeZone);
        cal.setTime(date);
        return cal;
    }
}

如果你的Adapter没正确继承XmlAdapter，或者marshal方法没调用带时区的逻辑，那肯定不会生效。

2. 解决第三方库注解的优先级问题 #

这是最常见的坑：如果第三方库的实体类已经用@XmlJavaTypeAdapter(ThirdPartyDateAdapter.class)标注了Calendar字段，那你直接用marshaller.setAdapter(dateFormatterAdapter)这种全局设置是没用的——类上的注解绑定优先级高于Marshaller的全局设置。

针对这种情况，有两种解决办法：

方法一：绑定特定Adapter类型覆盖 #

如果你知道第三方库用的Adapter类名（比如叫ThirdPartyDateAdapter），可以用Marshaller.setAdapter的重载方法，把你的自定义Adapter绑定到第三方Adapter的类型上：

// 假设第三方库的Adapter类是ThirdPartyDateAdapter
marshaller.setAdapter(ThirdPartyDateAdapter.class, dateFormatterAdapter);

这样JAXB在处理标注了@XmlJavaTypeAdapter(ThirdPartyDateAdapter.class)的字段时，会优先使用你传入的自定义实例。

方法二：用外部绑定文件覆盖原有配置 #

如果第三方库的实体类是从Schema生成的，你可以写一个binding.xml文件来全局替换Calendar的Adapter：

<jaxb:bindings xmlns:jaxb="http://java.sun.com/xml/ns/jaxb" version="2.1">
    <!-- 替换成第三方库对应的Schema路径 -->
    <jaxb:bindings schemaLocation="third-party-schema.xsd">
        <jaxb:globalBindings>
            <!-- 把xs:date类型映射到java.util.Calendar，并用你的自定义Adapter处理 -->
            <jaxb:javaType 
                name="java.util.Calendar" 
                xmlType="xs:date"
                adapter="com.yourpackage.DateFormatterAdapter"/>
        </jaxb:globalBindings>
    </jaxb:bindings>
</jaxb:bindings>

然后创建JAXBContext时指定这个绑定文件：

JAXBContext jaxbContext = JAXBContext.newInstance(
    "com.thirdparty.package", // 第三方库的包名
    Thread.currentThread().getContextClassLoader(),
    new JAXBContext.Properties().put(JAXBContext.JAXB_BINDING_LOCATION, "binding.xml")
);

这种方式能彻底覆盖第三方库的默认Adapter配置。

3. 额外验证点 #

• 确认PdxmlDateTimeUtil.FXONLINE_DEFAULT_DEAL_TIMEZONE是正确的时区对象（比如TimeZone.getTimeZone("UTC")），不是JVM默认时区；
• 在自定义Adapter的marshal方法里加日志，看看有没有被调用——如果没被调用，说明JAXB根本没用到你的Adapter，那肯定是优先级或者注册方式的问题；
• 打印第三方库实体类的注解信息，确认Calendar字段是否标注了第三方的XmlAdapter。

内容的提问来源于stack exchange，提问作者Shashi Shankar