How does a shipment item saving work?

dmitrii_fediuk · April 26, 2016, 5:39pm

Context: How does \Magento\Sales\Model\ResourceModel\Order\Shipment\Relation::processRelation() work?

magento/magento2/blob/958164/lib/internal/Magento/Framework/Model/ResourceModel/Db/AbstractDb.php#L371-L380


/**
 * Save object object data
 *
 * @param \Magento\Framework\Model\AbstractModel $object
 * @return $this
 * @SuppressWarnings(PHPMD.CyclomaticComplexity)
 * @throws \Exception
 * @api
 */
public function save(\Magento\Framework\Model\AbstractModel $object)

github.com

magento/magento2/blob/958164/app/code/Magento/Sales/Model/ResourceModel/Order/Shipment/Item.php#L35-L49


/**
 * Perform actions before object save
 *
 * @param \Magento\Framework\Model\AbstractModel|\Magento\Framework\DataObject $object
 * @return $this
 */
protected function _beforeSave(\Magento\Framework\Model\AbstractModel $object)
{
    /** @var \Magento\Sales\Model\Order\Shipment\Item $object */
    if (!$object->getParentId() && $object->getShipment()) {
        $object->setParentId($object->getShipment()->getId());
    }


    return parent::_beforeSave($object);
}

github.com

magento/magento2/blob/958164/app/code/Magento/Sales/Model/ResourceModel/EntityAbstract.php#L113-L133


/**
 * Perform actions before object save
 * Perform actions before object save, calculate next sequence value for increment Id
 *
 * @param \Magento\Framework\Model\AbstractModel|\Magento\Framework\DataObject $object
 * @return $this
 */
protected function _beforeSave(\Magento\Framework\Model\AbstractModel $object)
{
    /** @var \Magento\Sales\Model\AbstractModel $object */
    if ($object instanceof EntityInterface && $object->getIncrementId() == null) {
        $object->setIncrementId(
            $this->sequenceManager->getSequence(
                $object->getEntityType(),
                $object->getStore()->getGroup()->getDefaultStoreId()
            )->getNextValue()
        );
    }
    parent::_beforeSave($object);
    return $this;
}

Details: How does \Magento\Sales\Model\ResourceModel\EntityAbstract::_beforeSave() work?

github.com

magento/magento2/blob/958164/lib/internal/Magento/Framework/Model/ResourceModel/Db/AbstractDb.php#L402-L406


if ($this->isObjectNotNew($object)) {
    $this->updateObject($object);
} else {
    $this->saveNewObject($object);
}

Details: How does \Magento\Sales\Model\ResourceModel\EntityAbstract::saveNewObject() work?

github.com

magento/magento2/blob/958164/lib/internal/Magento/Framework/Model/ResourceModel/Db/AbstractDb.php#L408-L408


$this->processAfterSaves($object);

Details: How does \Magento\Framework\Model\ResourceModel\Db\VersionControl\AbstractDb::processAfterSaves() work for a shipment item?

github.com

magento/magento2/blob/958164/lib/internal/Magento/Framework/Model/ResourceModel/Db/AbstractDb.php#L410-L411


$this->addCommitCallback([$object, 'afterCommitCallback'])->commit();
$object->setHasDataChanges(false);

dmitrii_fediuk · April 26, 2016, 5:40pm