将 Doctrine Entity 转换为数组/JSON/XML 的正确方法是什么？

Question

我正在将 Zend Framework 3 应用程序的 Zend\Db 驱动 DBAL 迁移到 Doctrine。一切正常，但现在我在导出数据时遇到了问题。

在迁移之前，它的工作方式如下：

有一个或多或少复杂的数据结构。 Mapper 执行了一些数据库请求，并根据这些数据构建了一个嵌套的DataObject。因此，导出的起点是一个对象，其中填充了所有数据并具有子对象以及它们的所有数据。所以我简单地将其转换为JSON：

public function exportToJson(AbstractDataObject $dataObject)
{
    return json_encode($dataObject, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES);
}

public function exportToXml(AbstractDataObject $dataObject)
{
    $dataObjectVars = json_decode(json_encode($dataObject->jsonSerialize()), true);
    $xml = new \SimpleXMLElement('<' . self::XML_DEFAULT_ROOT_ELEMENT . ' />');
    $this->arrayToXml($dataObjectVars, $xml);
    $domxml = new \DOMDocument('1.0');
    $domxml->preserveWhiteSpace = false;
    $domxml->formatOutput = true;
    $domxml->loadXML($xml->asXML());
    $xmlString = $domxml->saveXML();
    return $xmlString;
}

protected function arrayToXml($array, &$xml)
{
    foreach ($array as $key => $value) {
        if(is_array($value)){
            if(is_int($key)){
                $key = self::XML_DEFAULT_ELEMENT_NAME;
            }
            $label = $xml->addChild($key);
            $this->arrayToXml($value, $label);
        }
        else {
            $xml->addChild($key, $value);
        }
    }
}

所有DataObjects 都扩展了AbstractDataObject，并提供了一种方法，可以轻松导出到JSON：

class AbstractDataObject implements \JsonSerializable
{

    public function jsonSerialize()
    {
        $reflection = new \ReflectionClass($this);
        $properties = $reflection->getProperties();
        $members = [];
        foreach ($properties as $property) {
            $property->setAccessible(true);
            $members[$property->getName()] = $property->getValue($this);
        }
        $keys = array_keys($members);
        $values = array_values($members);
        $keysUnderscored = preg_replace_callback('/([A-Z])/', function($matches) {
            return '_' . strtolower($matches[1]);
        }, $keys);
        $varsUnderscored = array_combine($keysUnderscored, $values);
        return $varsUnderscored;
    }

}

现在要导出的对象是一个实体，它通常不会加载所有数据。这意味着，上述方法不再有效。

是否有/将嵌套实体（指具有子实体的实体）转换为结构化数据格式（array/JSON/XML）的正确方法？强>

Answer 1

我终于按照 Cerad 的 comment 和 Symfony Serializer Component 的建议让它工作了。

我在编码方面遇到了一些问题：JSON_ERROR_UTF8 用于 JSON，而“Warning: DOMDocument::saveXML(): invalid character value”用于 XML。所以我必须“utf8ize”从Serializer 接收到的数组数据并使用dom_import_simplexml(...) 重新实现exportToXml(...)，如图here 所示。但现在它开始工作了，我们开始吧：

namespace MyNamespace\DataExport;

use MyNamespace\DataObject\AbstractDataObject;
use Symfony\Component\Serializer\NameConverter\CamelCaseToSnakeCaseNameConverter;
use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
use Symfony\Component\Serializer\Serializer;
use Symfony\Component\Serializer\Mapping\Factory\ClassMetadataFactory;
use Doctrine\Common\Annotations\AnnotationReader;
use Symfony\Component\Serializer\Mapping\Loader\AnnotationLoader;

class DataExporter
{

    /** @var string */
    const EXPORT_FORMAT_JSON = 'json';
    /** @var string */
    const EXPORT_FORMAT_XML = 'xml';
    /** @var string */
    const XML_DEFAULT_ROOT_ELEMENT = 'my_root_element_name';
    /** @var string */
    const XML_DEFAULT_ELEMENT_NAME = 'item';

    /** @var Serializer */
    protected $serializer;

    public function __construct()
    {
        $classMetadataFactory = new ClassMetadataFactory(new AnnotationLoader(new AnnotationReader()));
        $normalizer = new ObjectNormalizer($classMetadataFactory, new CamelCaseToSnakeCaseNameConverter());
        $normalizer->setCircularReferenceLimit(1);
        $normalizer->setIgnoredAttributes(['__initializer__', '__cloner__', '__isInitialized__']);
        $normalizer->setCircularReferenceHandler(function ($object) {
            // @todo A cleaner solution need.
            try {
                $return = $object->getId();
            } catch (\Error $exception) {
                $return = null;
            }
            $return = null;
            return $return;
        });
        $normalizers = [$normalizer];
        $this->serializer = new Serializer($normalizers);
    }

    public function exportToJson(AbstractDataObject $dataObject)
    {
        $data = $this->serializer->normalize($dataObject, null, ['groups' => ['export']]);
        $data = $this->utf8ize($data);
        return json_encode($data, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES);
    }

    public function exportToXml(AbstractDataObject $dataObject)
    {
        $data = $this->serializer->normalize($dataObject, null, ['groups' => ['export']]);
        $data = $this->utf8ize($data);
        $xml = new \SimpleXMLElement('<' . self::XML_DEFAULT_ROOT_ELEMENT . ' />');
        $this->arrayToXml($data, $xml);
        $domDocument = dom_import_simplexml($xml)->ownerDocument;
        $domDocument->formatOutput = true;
        $xmlString = $domDocument->saveXML();
        return $xmlString;
    }

    protected function utf8ize($data) {
        if (is_array($data)) {
            foreach ($data as $key => $value) {
                $data[$key] = $this->utf8ize($value);
            }
        } else if (is_string ($data)) {
            return utf8_encode($data);
        }
        return $data;
    }

    /**
     * Converts an $array to XML and
     * saves the result to the $xml argument.
     *
     * @param array $array
     * @param \SimpleXMLElement $xml
     * @return void
     */
    protected function arrayToXml($array, &$xml){
        foreach ($array as $key => $value) {
            if(is_array($value)){
                if(is_int($key)){
                    $key = self::XML_DEFAULT_ELEMENT_NAME;
                }
                $label = $xml->addChild($key);
                $this->arrayToXml($value, $label);
            }
            else {
                $xml->addChild($key, $value);
            }
        }
    }

}