Návrhový vzor pre vlastnú triedu

Myslím, že hledáš nějaké ORM. To už je prověřené, nastavené a plné best-practise.

Skvělé je toto: https://github.com/uestla/YetORM a nebo třeba LeanMapper, Doctrine

To čemu říkáš $data je nejlepší mít v obálce (entitě).
Metody save(), getById(), update() budou v repository.
A celé to bude v modelu, který může mít více repository.

Budeš mít např.

ArticleModel extends BaseModel
{
	protected $ArticleRepository;
	protected $TagsRepository;

	//construct DI načteš jak máš výše 2 repository

	public function articleSave(\Nette\Utils\ArrayHash $values) //data z formuláře
    {
		$articleEntity = new ArticleEntity();
		$articleEntity ->title = $values->title;
		$articleEntity ->text = $values->text;

		$id = $this->ArticleRepository->save($articleEntity);

		foreach($values->tags as $tag)
		{
			$tagEntity = new TagEntity();
			$tagEntity ->article_id = $id;
			$tagEntity ->title= $tag->title;

			$this->TagRepository->save($tagEntity);
		}
	}
}

Editoval Pavel Kravčík (24. 11. 2015 12:55)

Save() umí obojí. :) V tom je ta krása.

Já vlastně volám jen ->save($entity). To jestli to vložení nebo update už řeší repositář sám. Tj. žádné psaní. Tohle řeší entita a hrozně jednoduše:

namespace Dochazka\Entity;

/**
 * @property-read int $id
 * @property string $jmeno
 * @property string $prijmeni
 * @property int $skupina_id
 * @property int $pritomen
 * @property int $aktivni
 */
class ClovekEntity extends \App\Entity\BaseEntity
{
    const STAV_NEPRITOMEN = 0;
    const STAV_PRITOMEN = 1;
    const STAV_SLUZEBNI = 2;
}

Update vypadá následovně:

	$entity = $this->ClovekRepository->getById($id); //základní funkce repositáře getBy, findBy, save, delete, fetchPairs
	$entity->pritomen = 0; //lepší by volat tady tu konstantu - ale jsem línej to psát, tak radši napíšu dlouhej komentář :)
	$entity->setPritomen(0); //alternativa

	$this->ClovekRepository->save($entity);

Nemusíš nikam nic dopisovat, pokud entita reprezentuje tabulku.

Ako napríklad konkrétne by ste riešili úpravu už existujúceho articlu v kompomente? Predávali by ste mu vytvorené entitu article, alebo iba data?

Předávají se data z formuláře, jinak entita mezi funkcemi nebo ID.
Typický příklad je editační formulář. Ten Ti vrátí ArrayHash, to narveš do entity (mám funkci fillFromArray() nebo ručně viz výše) a pak už pracuješ s entitou, která hlídá co se kam dá napsat (string, int).

Editoval Pavel Kravčík (24. 11. 2015 13:27)

Felix napsal(a):

Hezke priklady. Ale ta cestina… Ta me trochu taha oci. :-)

Člověk si zvykne. Pracuji v jedné firmě v oboru pojišťovnictví. Jsou tu perly jako dobropis, prolongace, škodní průběh, vratka a další takové zavedené termíny. A prostě se to nedalo nějak rozumně přepsat do angličtiny → pak byla půlka česky a půlka anglicky. Je to dobrý i pro export do CSV co se tady hodně používá. Takže prostě jména objektů a sloupců jsou česky. Je to o zvyk. Tj. existují věci jako fakturaSave(), fakturaExport(), FakturaEdit().

Lepší systém mi nenapadá.

Dakujem velmi pekne za infosky a pomoc, skusim zajtra nabombit nieco a ked tak mi date vediet ci je to ok a spravny postup …

Len napr ak entita reprezentuje jednu tabulku, ako potom pracovat so selectami s joinnutymi tabulkami napriklad ak mam article a k nemu komentare? Bude to nova entita reprezentujuca ten join tabuliek? To mi pride ako hodne pisania

Ok, vytvoril som teda exemplárny príklad a ak sa vám dá, pozrite to prosím :)

Je to príklad na ukladanie multimédií a položil som ho na Kdyby\Doctrine2. Troška som to pochopil po svojom :)

Multimedia

<?php

namespace App\Entities;

use Doctrine\ORM\Mapping as ORM;

/**
 * @ORM\Entity
 */
class Multimedia
{

    use \Kdyby\Doctrine\Entities\MagicAccessors;

    /**
     * @ORM\Id
     * @ORM\Column(type="integer")
     * @ORM\GeneratedValue
     */
    protected $id_mul;

    /**
     * @ORM\Column(type="string")
     */
    protected $name;

    /**
     * @ORM\Column(type="string")
     */
    protected $path;

    /**
     * @ORM\Column(type="string")
     */
    protected $type;

    /**
     * @ORM\Column(type="string")
     */
    protected $id_mul_fol;

    /**
     * @ORM\Column(type="datetime")
     */
    protected $datein;

    public function getId_mul() {
	return $this->id_mul;
    }

    public function getName() {
	return $this->name;
    }

    public function getPath() {
	return $this->path;
    }

    public function getType() {
	return $this->type;
    }

    public function getId_mul_fol() {
	return $this->id_mul_fol;
    }

    public function getDatein() {
	return $this->datein;
    }

    public function setId_mul($id_mul) {
	$this->id_mul = $id_mul;
    }

    public function setName($name) {
	$this->name = $name;
    }

    public function setPath($path) {
	$this->path = $path;
    }

    public function setType($type) {
	$this->type = $type;
    }

    public function setId_mul_fol($id_mul_fol) {
	$this->id_mul_fol = $id_mul_fol;
    }

    public function setDatein($datein) {
	$this->datein = $datein;
    }



}
?>

MultimediaService

<?php

/*
 * To change this license header, choose License Headers in Project Properties.
 * To change this template file, choose Tools | Templates
 * and open the template in the editor.
 */

namespace App\Services;

/**
 * Description of Multimedias
 *
 * @author Vladino
 */
class MultimediaService extends \Nette\Object
{
    private $em;

    public function __construct(\Kdyby\Doctrine\EntityManager $em)
    {
        $this->em = $em;
    }

    public function insert(\App\Entities\Multimedia $multimedia) {

	$this->em->persist($multimedia);
	$this->done();

    }

    public function update(\App\Entities\Multimedia $multimedia) {

	$this->em->persist($multimedia);
	$this->done();

    }

    public function delete(\App\Entities\Multimedia $multimedia) {

	$this->em->remove($multimedia);
	$this->done();
    }



    protected function done() {
	$this->em->flush();
    }

}
?>

MultimediaSaver

<?php

namespace App\Services;

use Nette\Utils\Image;
use Nette\Utils\Strings;

/**
 * Description of MultimediaSaver
 *
 * @author Vladino
 */
class MultimediaSaver {

    public $fileUpload;

    public $request;

    public $multimediaRepository;

    public function __construct(\Nette\Http\FileUpload $fileUpload, \Nette\Http\Request $request, \App\Repositories\MultimediaRepository $multimediaRepository) {

	$this->fileUpload = $fileUpload;
	$this->request = $request;
	$this->multimediaRepository = $multimediaRepository;

    }

    /**
     * Save fileUpload as image and returns Multimedia entity
     * @param type $path
     * @param type $x
     * @param type $y
     * @param type $newName
     * @param type $params
     * @return \App\Entities\Multimedia
     */
    public function saveAsImage($path, $x = "100%", $y = "100%", $newName = NULL, $params = NULL) {

	$image = Image::fromFile($this->fileUpload);

	$image->resize($x, $y, $params);

	if ($newName === NULL) {
	    $newName = $this->checkOriginalityOfName();
	}

	$imageWithPath = $path . $newName;

	$image->save($imageWithPath, 90);

	$multimedia = new \App\Entities\Multimedia;
	$multimedia->setName($newName);
	$multimedia->setType($this->fileUpload->getContentType());
	$multimedia->setPath($this->request->getUrl()->getBaseUrl() . $imageWithPath);
	$multimedia->setDatein(new \DateTime);

	return $multimedia;

    }

    /**
     * Checks if name of image is original, if not it will make it original
     * @return string $name
     */
    public function checkOriginalityOfName() {

	$multimediaNames = $this->multimediaRepository->getFetchPairedNames();
	$i = 1;

	$name = $this->fileUpload->getSanitizedName();

	while (in_array($name, $multimediaNames)) {
	    $name = $i.$name;
	    $i++;
	}

	return $name;

    }

   /**
    * Is image type GIF, PNG or JPEG?
    * @return bool
    */
    public function isImage() {
         return in_array($this->fileUpload->getContentType(), array('image/gif', 'image/png', 'image/jpeg'), TRUE);
    }

}

/**
 *
 * @author Vladino
 */
interface IMultimediaSaver {

    /**
    * @return \App\Services\MultimediaSaver
    */
    public function create(\Nette\Http\FileUpload $fileUpload);

}

?>

MultimediaRepository

<?php
namespace App\Repositories;

/**
 * Description of MultimediaRepository2
 *
 * @author Vladino
 */
class MultimediaRepository extends \Nette\Object {

    private $multimediaEntity;

    public function __construct(\Kdyby\Doctrine\EntityManager $em)
    {
	$this->multimediaEntity = $em->getRepository(\App\Entities\Multimedia::getClassName());
    }

    public function findById($id) {
	return $this->multimediaEntity->findOneBy(array("id_mul" => $id));
    }

    public function getFetchPairedNames() {
	return $this->multimediaEntity->findPairs(array(), "name");
    }

}
?>

No a konkrétny príklad ako to celé funguje je napríklad ked odošlem z formulára

1. Cez interface vytvorím MultimediaSaver a predám u fileUpload
2. Cez metodu saveAsImage vložím obrázok do defaultného adresára + táto metoda mi vráti entitu Multimedia
3. Túto entitu vložím do DB cez MultimediaService
4. Ked ju budem chcieť vytiahnuť použijem MultimediaRepository

<?php
$multimediaSaver = $this->iMultimediaSaver->create($v["file"]);
	$multimedia = $multimediaSaver->saveAsImage("multimedia/multimedias/");

	$this->multimediaService->insert($multimedia);
?>

Dobre som tomu pochopil?:) Dakujem za pomoc