diff --git a/_posts/2024-08-07-novinky-ve-verzi-4-1.md b/_posts/2024-08-07-novinky-ve-verzi-4-1.md new file mode 100644 index 0000000..2908c3b --- /dev/null +++ b/_posts/2024-08-07-novinky-ve-verzi-4-1.md @@ -0,0 +1,92 @@ +--- +title: "Novinky ve verzi 4.1" +author: janpecha +--- + +{:.perex} +Chystaná verze 4.1 přinese řadu užitečných novinek. + + +## Použití konstruktoru u entit + +Konstruktor entity je aktuálně používán k vytvoření entity z pole dat či databázového řádku: + +```php +$book = new Book($row); +``` + +To však není optimální, pokud chceme konstruktor použít pro vlastní způsob inicializace entity: + +```php +$book = new Book($name, $author); +``` + +Nová verze přináší řešení v podobě traity `Initialize` a úpravě výchozí [EntityFactory](/cs/docs/entity-factory/), která zajistí, že entita, která tuto traitu používá bude při načítání dat z databáze vytvářena odlišným způsobem bez volání konstruktoru. + +Stačí jen v entitě (či předkovi) traitu použít (a nezapomenout v konstrukturu zavolat `parent::__construct()`): + +```php +/** + * @property int $id + * @property string $name + * @property Author $author m:hasOne + */ +class Book extends \LeanMapper\Entity +{ + use \LeanMapper\Initialize; + + + public function __construct( + string $name, + Author $author + ) + { + parent::__construct(); + + $this->name = $name; + $this->author = $author; + } +} +``` + + +## Podpora pro typ `non-empty-string` + +U položek entity je nově možné kromě typu `string` používat i typ `non-empty-string`. Lean Mapper pak vynucuje, aby předaná hodnota byla skutečně neprázdný řetězec. + +```php +/** + * @property non-empty-string $name + */ +class Author extends \LeanMapper\Entity +{ +} +``` + +Je to první krok k podpoře šiřšího spektra typů v položkách entit. + + +## Označení nullable položek v entitě + +Drobně vylepšen byl parser typů v anotacích, který kromě zápisu `Foo|null` nově u nullable položek rozumí i zápisu `?Foo`. + +```php +/** + * @property ?Author $author m:hasOne + * @property ?int $year + */ +class Book extends \LeanMapper\Entity +{ +} +``` + + +## Vylepšení pro statickou analýzu + +Drobné úpravy doznalo i rozhraní `IEntityFactory`, u kterého byla lépe specifikována návratová hodnota z metody `createCollection()` - původní `Entity[]` bylo nahrazeno za `iterable`, které by mělo lépe odpovídat realitě. + +V souvislosti s tím došlo ke stejné úpravě i u metod `Entity::getHasManyValue()`, `Entity::getBelongsToManyValue()` a `Repository::createEntities()`. + +---- + +**Verze 4.1 je aktuálně v RC fázi - vyzkoušejte ji prosím na svých projektech, pokud se neobjeví žádná komplikace, vyjde cca za týden stabilní verze.** diff --git a/cs/changelog.md b/cs/changelog.md index bc7fd9c..c8f82ba 100644 --- a/cs/changelog.md +++ b/cs/changelog.md @@ -6,6 +6,18 @@ rank: 70 ## [Vývojová verze](https://github.com/Tharos/LeanMapper/tree/develop) +* Entity: přidána traita `Initialize` ([#167](https://github.com/Tharos/LeanMapper/pull/167)) + +* Entity: přidána podpora pro typ `non-empty-string` u položek entity ([#167](https://github.com/Tharos/LeanMapper/pull/167)) + +* Entity: `settype()` nahrazeno vlastní metodou `Helpers::convertType()` ([#167](https://github.com/Tharos/LeanMapper/pull/167)) + +* Entity: opraveno pořadí volání kontroly typu a setter pass ([#167](https://github.com/Tharos/LeanMapper/pull/167)) + +* Entity: přidána podpora pro nullable syntaxi `?Foo` ([#167](https://github.com/Tharos/LeanMapper/pull/167)) + +* IEntityFactory: vylepšena návratová hodnota u metody `createCollection()` ([#167](https://github.com/Tharos/LeanMapper/pull/167)) + ## [4.0.5](https://github.com/Tharos/LeanMapper/tree/v4.0.3) (28. 11. 2023)