Docs: added Integrace Lean Mapper do aplikace

Moved from https://github.com/Tharos/LeanMapper/wiki/integrace-lean-mapperu-do-aplikace

Author: janpecha

cs/docs/index.md

@@ -11,5 +11,6 @@ Pět kapitol příručky vás seznámí se všemy aspekty Lean Mapperu a pomohou
 5. [Filtry](filtry/)
 6. [Mapper](mapper/)
 7. [EntityFactory](entity-factory/)
+8. [Integrace LeanMapperu do aplikace](integrace-do-aplikace/)
 
 [Entity »](entity/) |

cs/docs/integrace-do-aplikace.md

@@ -0,0 +1,145 @@
+---
+title: Integrace Lean Mapperu do aplikace
+---
+
+* [Úvod](#page-title)
+* [Vytvoření připojení](#toc-pripojeni)
+* [Mapper](#toc-mapper)
+* [EntityFactory](#toc-entityfactory)
+* [Repositáře](#toc-repositare)
+* [Integrace do Nette](#toc-nette)
+    * [DI rozšíření](#toc-nette-extension)
+    * [Ruční definice](#toc-nette-config)
+    * [Předání repositáře do presenteru](#toc-nette-presenter)
+
+
+## Vytvoření připojení  {#toc-pripojeni}
+
+Vytvoříme si objekt `LeanMapper\Connection` a předáme mu parametry potřebné pro připojení k databázi.
+
+``` php?start_inline=1
+$connection = new LeanMapper\Connection(array(
+    'driver'   => 'mysqli',
+    'host'     => 'localhost',
+    'username' => 'root',
+    'password' => '***',
+    'database' => 'mydatabase',
+));
+```
+
+**Tip:** `LeanMapper\Connection` přebírá stejné parametry jako třída [`DibiConnection`](https://api.dibiphp.com/3.0/Dibi.Connection.html).
+
+
+## Mapper  {#toc-mapper}
+
+Dále potřebujeme objekt implementující [`LeanMapper\IMapper`](/cs/docs/mapper/). Lean Mapper nám poskytuje výchozí implementaci formou třídy `LeanMapper\DefaultMapper`.
+
+``` php?start_inline=1
+$mapper = new LeanMapper\DefaultMapper;
+```
+
+
+## Entity factory  {#toc-entityfactory}
+
+A jako poslední věc vytvoříme objekt, který implementuje rozhraní [`LeanMapper\IEntityFactory`](/cs/docs/entity-factory). Lean Mapper nám opět podává pomocnou ruku prostřednictvím třídy `LeanMapper\DefaultEntityFactory`.
+
+``` php?start_inline=1
+$entityFactory = new LeanMapper\DefaultEntityFactory;
+```
+
+
+## Repositáře  {#toc-repositare}
+
+Abychom mohli pracovat s [entitami](/cs/docs/entity/), potřebujeme k tomu [repositáře](/cs/docs/repositare/). Předpokládejme, že máme repositář napsaný, nyní ho jen vytvoříme a předáme mu potřebné závislosti.
+
+``` php?start_inline=1
+$bookRepository = new Model\BookRepository($connection, $mapper, $entityFactory);
+```
+
+A to je vše.
+
+
+## Integrace do Nette aplikace  {#toc-nette}
+
+Ještě si ukážeme, jak použít Lean Mapper v rámci aplikace napsané v [Nette](https://nette.org).
+
+### DI rozšíření  {#toc-nette-extension}
+
+Doporučenou cestou je použití DI rozšíření. Do konfiguračního souboru aplikace (`config.neon`) si přidáme následující definici:
+
+``` yaml
+extensions:
+    leanmapper: LeanMapper\Bridges\Nette\DI\LeanMapperExtension
+
+leanmapper:
+    db:
+        host: localhost
+        username: ...
+        password: ...
+        database: mydatabase
+
+services:
+    - Model\BookRepository
+```
+
+**Poznámka:** *rozšíření je dostupné od verze **3.0**.*
+
+### Ruční definice  {#toc-nette-config}
+
+Pokud nechceme, nebo nemůžeme použít předpřipravené DI rozšíření, můžeme jednotlivé *služby* definovat ručně. Do konfiguračního souboru aplikace (`config.neon`) si přídáme následující parametry a definice služeb:
+
+``` yaml
+parameters:
+    # údaje pro připojení k DB
+    leanmapper:
+        driver: mysqli
+        host: localhost
+        username: ...
+        password: ...
+        database: mydatabase
+
+services:
+    # registrace Lean Mapperu
+    - LeanMapper\Connection(%leanmapper%)
+    - LeanMapper\DefaultMapper
+    - LeanMapper\DefaultEntityFactory
+
+    # registrace repositářů
+    - Model\AuthorRepository
+    - Model\BookRepository
+```
+
+Repositářům nemusíme ručně předávat závislosti, o to se automaticky postará [auto-wiring](http://doc.nette.org/cs/2.4/configuring#toc-auto-wiring) v Nette.
+
+
+### Předání repositáře do presenteru  {#toc-nette-presenter}
+
+Preferovaným způsobem je předání závislostí přes konstruktor.
+
+``` php?start_inline=1
+class BookPresenter extends BasePresenter {
+    /** @var \Model\BookRepository */
+    private $bookRepository;
+
+    public function __construct(\Model\BookRepository $bookRepository)
+    {
+        $this->bookRepository = $bookRepository;
+    }
+}
+```
+
+
+Alternativně lze pro předání repositáře do presenteru můžeme využít anotaci [`@inject`](https://doc.nette.org/cs/2.4/presenters#toc-pouziti-modelovych-trid).
+
+``` php?start_inline=1
+class BookPresenter extends BasePresenter {
+    /** @var \Model\BookRepository @inject */
+    public $bookRepository;
+
+    ...
+}
+```
+
+V rámci presenteru pak máme repositář přístupný přes `$this->bookRepository`.
+
+[« Mapper](/cs/docs/mapper/) |

cs/index.md

@@ -11,6 +11,7 @@ title: Dokumentace
 	5. [Filtry](/cs/docs/filtry/)
 	6. [Mapper](/cs/docs/mapper/)
 	7. [EntityFactory](/cs/docs/entity-factory/)
+	8. [Integrace LeanMapperu do aplikace](/cs/docs/integrace-do-aplikace/)
 * [Ukázky použití a zajímavá řešení](/cs/tutorials/)
 * [Changelog](/cs/changelog/)
 * [Download](/cs/download/)