/**
* Saves a modified code object to the storage.
*
* @param \Aimeos\MShop\Coupon\Item\Code\Iface $item Coupon code object
* @param boolean $fetch True if the new ID should be returned in the item
* @throws \Aimeos\MShop\Coupon\Exception If coupon couldn't be saved
*/
public function saveItem(\Aimeos\MShop\Common\Item\Iface $item, $fetch = true)
{
$iface = '\\Aimeos\\MShop\\Coupon\\Item\\Code\\Iface';
if (!$item instanceof $iface) {
throw new \Aimeos\MShop\Coupon\Exception(sprintf('Object is not of required type "%1$s"', $iface));
}
if (!$item->isModified()) {
return;
}
$context = $this->getContext();
$dbm = $context->getDatabaseManager();
$dbname = $this->getResourceName();
$conn = $dbm->acquire($dbname);
try {
$id = $item->getId();
$date = date('Y-m-d H:i:s');
if ($id === null) {
/** mshop/coupon/manager/code/standard/insert
* Inserts a new coupon code record into the database table
*
* Items with no ID yet (i.e. the ID is NULL) will be created in
* the database and the newly created ID retrieved afterwards
* using the "newid" SQL statement.
*
* The SQL statement must be a string suitable for being used as
* prepared statement. It must include question marks for binding
* the values from the coupon item to the statement before they are
* sent to the database server. The number of question marks must
* be the same as the number of columns listed in the INSERT
* statement. The order of the columns must correspond to the
* order in the saveItems() method, so the correct values are
* bound to the columns.
*
* The SQL statement should conform to the ANSI standard to be
* compatible with most relational database systems. This also
* includes using double quotes for table and column names.
*
* @param string SQL statement for inserting records
* @since 2014.03
* @category Developer
* @see mshop/coupon/manager/code/standard/update
* @see mshop/coupon/manager/code/standard/newid
* @see mshop/coupon/manager/code/standard/delete
* @see mshop/coupon/manager/code/standard/search
* @see mshop/coupon/manager/code/standard/count
* @see mshop/coupon/manager/code/standard/counter
*/
$path = 'mshop/coupon/manager/code/standard/insert';
} else {
/** mshop/coupon/manager/code/standard/update
* Updates an existing coupon code record in the database
*
* Items which already have an ID (i.e. the ID is not NULL) will
* be updated in the database.
*
* The SQL statement must be a string suitable for being used as
* prepared statement. It must include question marks for binding
* the values from the coupon item to the statement before they are
* sent to the database server. The order of the columns must
* correspond to the order in the saveItems() method, so the
* correct values are bound to the columns.
*
* The SQL statement should conform to the ANSI standard to be
* compatible with most relational database systems. This also
* includes using double quotes for table and column names.
*
* @param string SQL statement for updating records
* @since 2014.03
* @category Developer
* @see mshop/coupon/manager/code/standard/insert
* @see mshop/coupon/manager/code/standard/newid
* @see mshop/coupon/manager/code/standard/delete
* @see mshop/coupon/manager/code/standard/search
* @see mshop/coupon/manager/code/standard/count
* @see mshop/coupon/manager/code/standard/counter
*/
$path = 'mshop/coupon/manager/code/standard/update';
}
$stmt = $this->getCachedStatement($conn, $path);
$stmt->bind(1, $context->getLocale()->getSiteId(), \Aimeos\MW\DB\Statement\Base::PARAM_INT);
$stmt->bind(2, $item->getCouponId(), \Aimeos\MW\DB\Statement\Base::PARAM_INT);
$stmt->bind(3, $item->getCode());
$stmt->bind(4, $item->getCount(), \Aimeos\MW\DB\Statement\Base::PARAM_INT);
$stmt->bind(5, $item->getDateStart());
$stmt->bind(6, $item->getDateEnd());
$stmt->bind(7, $date);
// mtime
$stmt->bind(8, $context->getEditor());
if ($id !== null) {
$stmt->bind(9, $id, \Aimeos\MW\DB\Statement\Base::PARAM_INT);
$item->setId($id);
} else {
$stmt->bind(9, $date);
// ctime
}
$stmt->execute()->finish();
if ($id === null && $fetch === true) {
/** mshop/coupon/manager/code/standard/newid
* Retrieves the ID generated by the database when inserting a new record
*
* As soon as a new record is inserted into the database table,
* the database server generates a new and unique identifier for
* that record. This ID can be used for retrieving, updating and
* deleting that specific record from the table again.
*
* For MySQL:
* SELECT LAST_INSERT_ID()
* For PostgreSQL:
* SELECT currval('seq_mcouco_id')
* For SQL Server:
* SELECT SCOPE_IDENTITY()
* For Oracle:
* SELECT "seq_mcouco_id".CURRVAL FROM DUAL
*
* There's no way to retrive the new ID by a SQL statements that
* fits for most database servers as they implement their own
* specific way.
*
* @param string SQL statement for retrieving the last inserted record ID
* @since 2014.03
* @category Developer
* @see mshop/coupon/manager/code/standard/insert
* @see mshop/coupon/manager/code/standard/update
* @see mshop/coupon/manager/code/standard/delete
* @see mshop/coupon/manager/code/standard/search
* @see mshop/coupon/manager/code/standard/count
* @see mshop/coupon/manager/code/standard/counter
*/
$path = 'mshop/coupon/manager/code/standard/newid';
$item->setId($this->newId($conn, $path));
}
$dbm->release($conn, $dbname);
} catch (\Exception $e) {
$dbm->release($conn, $dbname);
throw $e;
}
}
