How does \Magento\Framework\DataObject\Copy::copyFieldsetToTarget() work?

dmitry_fedyuk · August 22, 2016, 5:05am

Context: How does \Magento\Sales\Model\Order\CustomerManagement::create() work?

magento/magento2/blob/2.1.0/lib/internal/Magento/Framework/DataObject/Copy.php#L46-L62


/**
 * Copy data from object|array to object|array containing fields from fieldset matching an aspect.
 *
 * Contents of $aspect are a field name in target object or array.
 * If targetField attribute is not provided - will be used the same name as in the source object or array.
 *
 * @param string $fieldset
 * @param string $aspect
 * @param array|\Magento\Framework\DataObject $source
 * @param array|\Magento\Framework\DataObject $target
 * @param string $root
 * @return array|\Magento\Framework\DataObject|null the value of $target
 * @throws \InvalidArgumentException
 *
 * @api
 */
public function copyFieldsetToTarget($fieldset, $aspect, $source, $target, $root = 'global')

github.com

magento/magento2/blob/2.1.0/lib/internal/Magento/Framework/DataObject/Copy.php#L64-L66


if (!$this->_isFieldsetInputValid($source, $target)) {
    return null;
}

Details: How does \Magento\Framework\DataObject\Copy::_isFieldsetInputValid() work?

github.com

magento/magento2/blob/2.1.0/lib/internal/Magento/Framework/DataObject/Copy.php#L67-L67


$fields = $this->fieldsetConfig->getFieldset($fieldset, $root);

Details: How does \Magento\Framework\DataObject\Copy\Config::getFieldset() work?

github.com

magento/magento2/blob/2.1.0/lib/internal/Magento/Framework/DataObject/Copy.php#L68-L84


if ($fields === null) {
    return $target;
}
$targetIsArray = is_array($target);


foreach ($fields as $code => $node) {
    if (empty($node[$aspect])) {
        continue;
    }


    $value = $this->_getFieldsetFieldValue($source, $code);


    $targetCode = (string)$node[$aspect];
    $targetCode = $targetCode == '*' ? $code : $targetCode;


    $target = $this->_setFieldsetFieldValue($target, $targetCode, $value);
}

Details:

github.com

magento/magento2/blob/2.1.0/lib/internal/Magento/Framework/DataObject/Copy.php#L86-L86


$target = $this->dispatchCopyFieldSetEvent($fieldset, $aspect, $source, $target, $root, $targetIsArray);

Details: How does \Magento\Framework\DataObject\Copy::dispatchCopyFieldSetEvent() work?