3.2. Parametry a Latte SQL

<?php

declare(strict_types=1);

namespace App\Components\Docs\Data\SqlParamsGridControl;

use Xart\Grid\Button\ButtonManager;
use Xart\Grid\Column\ColumnManager;
use Xart\Grid\Control\GridControl;
use Xart\Grid\DataOutput\Row;
use Xart\Grid\DataSource\DataSource;
use Xart\Grid\DataSource\SQL\SQLDataSource;

/**
 * Dokumentace, kapitola 3.2 – Parametry a Latte SQL.
 *
 * Dotaz je Latte šablona: dostane parametry a podle nich se poskládá. Hodnoty se do SQL nevkládají
 * ručně – escapuje je LatteSQL, takže je jedno, co v nich přijde.
 *
 * Parametry si nastavuje presenter (viz setCategory()) ještě před vykreslením. Že se to stihne,
 * není náhoda: createDataSource() se volá líně, až když si grid o data řekne.
 */
class SqlParamsGridControl extends GridControl
{
    private ?string $category = null;

    private int $minQuantity = 0;


    public function setCategory(?string $category): static
    {
        $this->category = $category;
        return $this;
    }


    public function setMinQuantity(int $minQuantity): static
    {
        $this->minQuantity = $minQuantity;
        return $this;
    }


    public function createDataSource(): DataSource
    {
        return new SQLDataSource(__DIR__ . '/SqlParamsGridControl.sql', [
            'category' => $this->category,
            'minQuantity' => $this->minQuantity,
        ]);
    }


    public function columns(ColumnManager $cm): void
    {
        $cm->add('name', 'Název');
        $cm->add('category', 'Kategorie');
        $cm->addNumber('price', 'Cena', 2, 'Kč');
        $cm->addNumber('quantity', 'Skladem', 0);
    }


    public function buttons(ButtonManager $bm): void
    {
    }


    public function rows(Row $row): void
    {
    }


    public function render(): void
    {
        $this->template->render(__DIR__ . '/SqlParamsGridControl.latte');
    }
}

SELECT
    id,
    name,
    category,
    price / 100 AS price,
    quantity
FROM `product`
WHERE quantity >= {$minQuantity}
{if $category !== null}
    AND category = {$category}
{/if}