1  2  3  4  5  6  7  8  9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 
<?php
/* --------------------------------------------------------------
   SharedShoppingCartRepositoryInterface.inc.php 2016-04-08 gm
   Gambio GmbH
   http://www.gambio.de
   Copyright (c) 2016 Gambio GmbH
   Released under the GNU General Public License (Version 2)
   [http://www.gnu.org/licenses/gpl-2.0.html]
   --------------------------------------------------------------
*/

/**
 * Interface SharedShoppingCartRepositoryInterface
 *
 * @category   System
 * @package    SharedShoppingCart
 * @subpackage Interfaces
 */
interface SharedShoppingCartRepositoryInterface
{
    /**
     * Stores the cart and returns the hash
     *
     * @param StringType  $jsonShoppingCart JSON representation of the cart
     * @param IdType|null $userId           The user ID of the user who is sharing the cart
     *
     * @return string The hash of the cart
     * @throws \InvalidArgumentException
     */
    public function storeShoppingCart(StringType $jsonShoppingCart, IdType $userId);


    /**
     * Gets the content in JSON format of the shopping cart corresponding to the hash
     *
     * @param StringType $shoppingCartHash Hash of the shopping cart
     *
     * @return string JSON representation of the shopping cart
     */
    public function getShoppingCart(StringType $shoppingCartHash);


    /**
     * Deletes all shared shopping carts that are expired
     *
     * @param DateTime $expirationDate All shared shopping carts older than that date are expired
     */
    public function deleteShoppingCartsOlderThan(DateTime $expirationDate);
    
    /**
     * Deletes all shared shopping carts by a given customer ID.
     *
     * @param \IdType $customerId
     */
    public function deleteShoppingCartsByCustomerId(IdType $customerId);
    
    
    /**
     * Gets a collection of all shared shopping carts by a given customer ID.
     *
     * @param \IdType $customerId
     *
     * @return \SharedShoppingCartCollection
     */
    public function getShoppingCartsByCustomerId(IdType $customerId);
}