<?php

interface iDb_Select
{
    /** Превращение объекта запроса в строку */
    public function __toString();

    /**
     * Исключение дублирования выборки по первой колонке
     *
     * @return iDb_Select
     */
    public function distinct();

    /**
     * Указание из какой таблицы делается запрос и какие колонки
     *
     * @param array|string $tableName таблица БД
     * @return iDb_Select
     */
    public function from($tableName);

    /**
     * Добавляет условие к запросу
     *
     * @param string $condition условие запроса
     * @param mixed $value значение или массив условий подставляемые в условие
     * @return iDb_Select
     */
    public function where($condition, $value = null);

    /**
     * Добавляет пост-условия к запросу
     *
     * @param string $condition условие запроса
     * @param mixed $value значение или массив условий подставляемые в условие
     * @return iDb_Select
     */
    public function having($condition, $value = null);

    /**
     * Упорядочивание записей по полю
     *
     * @param array|string $field
     * @param string $direction
     * @return iDb_Select
     */
    public function order($field, $direction = null);

    /**
     * Группировка записей по полю или массиву полей
     *
     * @param array|string $value поле(я)
     * @return iDb_Select
     */
    public function group($value);

    /**
     * Ограничение выборки записей
     *
     * @param int $count количество выбираемых записей
     * @param int $offset смещение
     * @return iDb_Select
     */
    public function limit($count, $offset = 0);

    /**
     * Присоединение таблицы к запросу
     *
     * @param string $tableName присоединяемая таблица
     * @param string $condition условие присоединения
     * @return iDb_Select
     */
    public function join($tableName, $condition);

    /**
     * Левостороннее присоединение таблицы к запросу
     *
     * @param string $tableName присоединяемая таблица
     * @param string $condition условие присоединения
     * @return iDb_Select
     */
    public function joinLeft($tableName, $condition);

    /**
     * Добавление выбираемых колонок
     *
     * @param array $columns массив колонок
     * @return iDb_Select
     */
    public function addColumns(array $columns);

    /**
     * Возвращает массив значений первого столбца записей
     *
     * @param string $server сервер БД read|write
     * @return array
     */
    public function fetchCol($server = null);

    /**
     * Возвращает массив объектов записей соответствующие запросу
     *
     * @param string $server сервер БД read|write
     * @return object[]
     */
    public function fetchAll($server = null);

    /**
     * Возвращает массив массивов записей соответствующие запросу
     *
     * @param string $server сервер БД read|write
     * @return array
     */
    public function fetchArray($server = null);

    /**
     * Возвращает массив записей соответствующие запросу, причем ключами являются значения первой колонки записей
     *
     * @param string $server сервер БД read|write
     * @return object[]
     */
    public function fetchAssoc($server = null);

    /**
     * Возвращает значение первой колонки записи соответствующей запросу
     *
     * @param string $server сервер БД read|write
     * @return mixed
     */
    public function fetchOne($server = null);

    /**
     * Возвращает объект записи соответствующей запросу
     *
     * @param string $server сервер БД read|write
     * @return object|null
     */
    public function fetchRow($server = null);

}