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 67 68 69 70 71 72 73 74 75 76 77 
<?php
/* --------------------------------------------------------------
   CustomerReadServiceInterface.inc.php 2017-03-03
   Gambio GmbH
   http://www.gambio.de
   Copyright (c) 2017 Gambio GmbH
   Released under the GNU General Public License (Version 2)
   [http://www.gnu.org/licenses/gpl-2.0.html]
   --------------------------------------------------------------
*/

/**
 * Interface CustomerReadServiceInterface
 *
 * @category   System
 * @package    Customer
 * @subpackage Interfaces
 */
interface CustomerReadServiceInterface
{
    /**
     * Finds a customer by an entered ID.
     *
     * @param IdType $customerId Customer ID.
     *
     * @return Customer Customer.
     */
    public function getCustomerById(IdType $customerId);
    
    
    /**
     * Checks if the email address of the registree already exists.
     *
     * @param CustomerEmailInterface $email Customer's E-Mail address.
     *
     * @return bool Does the E-Mail address already exist?
     */
    public function registreeEmailExists(CustomerEmailInterface $email);
    
    
    /**
     * Checks if address is the default address of the customer.
     *
     * @param CustomerAddressInterface $customerAddress Customer's address.
     *
     * @return bool Is provided address the customer's default address?
     */
    public function addressIsDefaultCustomerAddress(CustomerAddressInterface $customerAddress);
    
    
    /**
     * Filters customer records and returns an array with results.
     *
     * Example:
     *        $service->filterCustomers('customers_id' => 1);
     *
     * @param array $conditions Associative array containing the desired field and value.
     * @param int   $limit      MySQL limit applied to the records.
     * @param int   $offset     MySQL offset applied to the records.
     *
     * @return array Returns an array that contains customer objects.
     */
    public function filterCustomers(array $conditions, $limit, $offset);
    
    
    /**
     * Filters customer records and returns the total count.
     *
     * Example:
     *        $service->filterCustomers('customers_id' => 1);
     *
     * @param array $conditions Associative array containing the desired field and value.
     *
     * @return int
     */
    public function getFilterCustomersCount(array $conditions = []);
}