Symfony Serializer 3.3 如何自定义布尔属性XML序列化输出为Y/N
Symfony Serializer 3.3 自定义布尔值序列化为Y/N的实现方案
默认情况下Symfony Serializer处理布尔值时,会将
true转换为1、false转换为0,符合旧版XML Schema对布尔类型的兼容规范,本方案的转换逻辑不会改动底层原有序列化流程,也完全不需要修改实体类的访问器方法。
核心思路
利用Symfony Serializer的正常化器(Normalizer)装饰机制,在对象转结构化中间数据的阶段,拦截布尔值的输出做统一转换,所有转换逻辑都放在序列化层,对业务代码完全无侵入。
实现步骤
- 创建自定义全局正常化器
新建自定义正常化类,对原有默认对象正常化器做装饰,在不改动原序列化逻辑的基础上,递归遍历所有正常化后的属性值,将布尔类型值替换为对应的Y/N;同时补充反序列化的适配逻辑,保证XML结构中的Y/N值可以正确转回实体的布尔类型。
代码示例:namespace App\Serializer\Normalizer; use Symfony\Component\Serializer\Normalizer\NormalizerInterface; use Symfony\Component\Serializer\Normalizer\DenormalizerInterface; use Symfony\Component\Serializer\SerializerAwareInterface; use Symfony\Component\Serializer\SerializerInterface; class BoolToYNNormalizer implements NormalizerInterface, DenormalizerInterface, SerializerAwareInterface { private $decoratedNormalizer; public function __construct(NormalizerInterface $decoratedNormalizer) { $this->decoratedNormalizer = $decoratedNormalizer; } // 透传序列化器实例给被装饰的默认正常化器,避免嵌套对象序列化失效 public function setSerializer(SerializerInterface $serializer) { if ($this->decoratedNormalizer instanceof SerializerAwareInterface) { $this->decoratedNormalizer->setSerializer($serializer); } } public function supportsNormalization($data, $format = null) { return $this->decoratedNormalizer->supportsNormalization($data, $format); } public function normalize($object, $format = null, array $context = []) { // 先执行原有的正常化逻辑拿到结构化数据 $normalizedData = $this->decoratedNormalizer->normalize($object, $format, $context); // 递归遍历所有属性,将布尔值替换为Y/N array_walk_recursive($normalizedData, function(&$value) { if (is_bool($value)) { $value = $value ? 'Y' : 'N'; } }); return $normalizedData; } public function supportsDenormalization($data, $type, $format = null) { return $this->decoratedNormalizer->supportsDenormalization($data, $type, $format); } public function denormalize($data, $type, $format = null, array $context = []) { // 反序列化时把Y/N转回真实布尔值,适配实体类型 if (in_array($type, ['bool', 'boolean'])) { $data = strtoupper((string)$data) === 'Y'; } return $this->decoratedNormalizer->denormalize($data, $type, $format, $context); } } - 注册自定义正常化器到服务容器
在config/services.yaml中配置服务,将自定义正常化器装饰Symfony默认的对象正常化器,保证其在序列化流程中优先执行:App\Serializer\Normalizer\BoolToYNNormalizer: decorates: 'serializer.normalizer.object' arguments: ['@App\Serializer\Normalizer\BoolToYNNormalizer.inner'] tags: ['serializer.normalizer'] - 效果验证
执行原有示例代码的序列化流程时,输出的XML结构中enabled节点的值会自动从默认的1替换为Y,完全不需要修改Person类中isEnabled()、setEnabled()的原有实现。
灵活适配调整
- 如果不需要全局替换所有实体的布尔序列化输出,可以在
supportsNormalization方法中增加判断逻辑,仅当传入的对象是Acme\Person类型时才做Y/N转换,避免影响其他业务模块的序列化行为。 - 递归遍历的实现可以自动适配嵌套对象中的布尔属性,不需要针对单个属性单独编写转换逻辑。
内容的提问来源于stack exchange,提问作者n44s
相关产品推荐
相关产品推荐

