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:  78:  79:  80:  81:  82:  83:  84:  85:  86:  87:  88:  89:  90:  91:  92:  93:  94:  95:  96:  97:  98:  99: 100: 101: 102: 103: 104: 105: 106: 107: 108: 109: 110: 111: 112: 113: 114: 115: 116: 117: 118: 119: 120: 121: 122: 123: 124: 125: 126: 127: 128: 129: 130: 131: 132: 133: 134: 135: 136: 137: 138: 139: 140: 141: 142: 143: 144: 145: 146: 147: 148: 149: 150: 151: 152: 153: 154: 

<?php

/**
 * MvcCore
 *
 * This source file is subject to the BSD 3 License
 * For the full copyright and license information, please view
 * the LICENSE.md file that are distributed with this source code.
 *
 * @copyright   Copyright (c) 2016 Tom Flidr (https://github.com/mvccore)
 * @license  https://mvccore.github.io/docs/mvccore/5.0.0/LICENCE.md
 */

namespace MvcCore\Ext\Models\Db\Readers;

class       Multiple 
extends     \MvcCore\Ext\Models\Db\Reader
implements  \MvcCore\Ext\Models\Db\Readers\IMultiple {

    /**
     * @inheritDocs
     * @param string $fullClassName 
     * @param int $readingFlags 
     * @param string $keyColumnName 
     * @param string $keyType 
     * @return \object[]
     */
    public function ToInstances ($fullClassName, $readingFlags = 0, $keyColumnName = NULL, $keyType = NULL) {
        $this->fetchRawData(FALSE);
        $result = [];
        $retypeKey = $keyType !== NULL;
        $useRawKey = $keyColumnName === NULL;
        $type = new \ReflectionClass($fullClassName);
        if (!$type->hasMethod('SetValues'))
            throw new \InvalidArgumentException(
                "[".get_class()."] Class `{$fullClassName}` has no public method ".
                "`SetValues (\$data = [], \$propsFlags = 0): \MvcCore\Model`."
            );
        foreach ($this->rawData as $rawKey => $rawItem) {
            $itemKey = $useRawKey
                ? $rawKey
                : $rawItem[$keyColumnName];
            if ($retypeKey)
                settype($itemKey, $keyType);
            /** @var $item \MvcCore\Ext\Models\Db\Model */
            $item = $type->newInstanceWithoutConstructor();
            $item->SetValues($rawItem, $readingFlags);
            $result[$itemKey] = $item;
        }
        $this->cleanUpData();
        return $result;
    }

    /**
     * @inheritDocs
     * @param string $keyColumnName 
     * @param string $keyType 
     * @return \array[]
     */
    public function ToArrays ($keyColumnName = NULL, $keyType = NULL) {
        $this->fetchRawData(FALSE);
        $result = [];
        $retypeKey = $keyType !== NULL;
        $useRawKey = $keyColumnName === NULL;
        foreach ($this->rawData as $rawKey => $rawItem) {
            $itemKey = $useRawKey
                ? $rawKey 
                : $rawItem[$keyColumnName];
            if ($retypeKey)
                settype($itemKey, $keyType);
            $result[$itemKey] = $rawItem;
        }
        $this->cleanUpData();
        return $result;
    }

    /**
     * @inheritDocs
     * @param string $keyColumnName 
     * @param string $keyType 
     * @return \stdClass[]
     */
    public function ToObjects ($keyColumnName = NULL, $keyType = NULL) {
        $this->fetchRawData(FALSE);
        $result = [];
        $retypeKey = $keyType !== NULL;
        $useRawKey = $keyColumnName === NULL;
        foreach ($this->rawData as $rawKey => $rawItem) {
            $itemKey = $useRawKey
                ? $rawKey
                : $rawItem[$keyColumnName];
            if ($retypeKey)
                settype($itemKey, $keyType);
            $result[$itemKey] = (object) $rawItem;
        }
        $this->cleanUpData();
        return $result;
    }

    /**
     * @inheritDocs
     * @param string $valueColumnName 
     * @param string $valueType 
     * @param string $keyColumnName 
     * @param string $keyType 
     * @return \int[]|\float[]|\string[]|\bool[]|NULL
     */
    public function ToScalars ($valueColumnName, $valueType = NULL, $keyColumnName = NULL, $keyType = NULL) {
        $this->fetchRawData(FALSE);
        $result = [];
        $retypeKey = $keyType !== NULL;
        $retypeValue = $valueType !== NULL;
        $useRawKey = $keyColumnName === NULL;
        foreach ($this->rawData as $rawKey => $rawItem) {
            $itemKey = $useRawKey
                ? $rawKey
                : $rawItem[$keyColumnName];
            if ($retypeKey)
                settype($itemKey, $keyType);
            $itemValue = array_key_exists($valueColumnName, $rawItem)
                ? $rawItem[$valueColumnName]
                : NULL;
            if ($retypeValue)
                settype($itemValue, $valueType);
            $result[$itemKey] = $itemValue;
        }
        $this->cleanUpData();
        return $result;
    }

    /**
     * @inheritDocs
     * @param callable $valueColumnName Called for each result row, 1. argument is raw result item, 2. argument is raw result key. Completer has to return created result item instance.
     * @param string $keyColumnName 
     * @param string $keyType 
     * @return array
     */
    public function ToAny (callable $valueCompleter, $keyColumnName = NULL, $keyType = NULL) {
        $this->fetchRawData(FALSE);
        $result = [];
        $retypeKey = $keyType !== NULL;
        $useRawKey = $keyColumnName === NULL;
        foreach ($this->rawData as $rawKey => $rawItem) {
            $itemKey = $useRawKey
                ? $rawKey
                : $rawItem[$keyColumnName];
            if ($retypeKey)
                settype($itemKey, $keyType);
            $result[$itemKey] = $valueCompleter($rawItem, $rawKey);
        }
        $this->cleanUpData();
        return $result;
    }
}