如何配置XStream识别nil="true"属性将对应Java字段值设为null

默认配置下XStream不会主动识别XML节点上的nil="true"空值标记，仅需注册一个高优先级的自定义字符串转换器，增加空值属性判断逻辑即可满足需求，无需修改原有Java实体类结构，配置代码如下：

import com.thoughtworks.xstream.XStream;
import com.thoughtworks.xstream.converters.basic.StringConverter;
import com.thoughtworks.xstream.io.HierarchicalStreamReader;
import com.thoughtworks.xstream.converters.UnmarshallingContext;

public class XStreamFactory {
    public static XStream getConfiguredInstance() {
        XStream xstream = new XStream();
        // 注册高优先级转换器，优先执行nil属性判断
        xstream.registerConverter(new StringConverter() {
            @Override
            public Object unmarshal(HierarchicalStreamReader reader, UnmarshallingContext context) {
                String nilFlag = reader.getAttribute("nil");
                if ("true".equals(nilFlag)) {
                    // 消费当前节点内容，避免后续解析位置错位
                    reader.getValue();
                    return null;
                }
                return super.unmarshal(reader, context);
            }
        }, XStream.PRIORITY_VERY_HIGH);

        // 原有XStream配置（类别名、字段映射等）保持不变
        xstream.alias("account", Account.class);
        return xstream;
    }
}

解析结果 #

使用上述配置解析示例XML报文，字段解析结果完全符合预期：

• phone1：节点包含文本内容unknown，解析为字符串"unknown"
• phone2：无nil属性的空自闭合节点，保持默认行为解析为空字符串""
• phone3：携带nil="true"属性，自动解析为null

适配说明 #

• 若第三方报文使用带命名空间的标准空值属性（如xsi:nil="true"），仅需将属性读取逻辑替换为reader.getAttribute("xsi", "nil")即可适配
• 转换器必须设置XStream.PRIORITY_VERY_HIGH优先级，保证空值判断在XStream默认类型转换逻辑前执行，避免被默认逻辑覆盖返回空字符串
• 该配置全局生效，所有实体类中String类型、携带nil="true"属性的节点都会自动转换为null，无需为单个字段添加额外注解

内容的提问来源于stack exchange，提问作者Per Jernström