Jak rozjet h4kuna\Exchange – chybí service?

Možná je chyba v

/* @var \h4kuna\Exchange\Exchange @inject */

dokumentační komentář anotace musí začítat /**, tedy

/** @var \h4kuna\Exchange\Exchange @inject */

Editoval Myiyk (2. 12. 2015 21:28)

Tohle není o vytváření servis, ale taková specialitka, jak je rychle předat do presenteru. Služba je již vytvořená v DI kontejneru (to zajistíš zápisem do configu).
Abys ji do presenteru nemusel předávat konstruktorem, jako když ji předáváš kamkoliv jinam. Proto nakonec vznikl akademicky velmi špatný, zato jednoduchý a návykový způsob – anotace @inject. Ale anotace není obyčejný komentář, anotace vychází z PhpDoc syntaxe.
Na tuhle dvě hvězdičky si dávej pozor, na ně občas narazíš a i když je to technicky komentář, prakticky jsou anotace součástí kódu. Dále zajišťují napovídání v IDE, potkáš je v Doctrině apod.

Trocha historie jak se k tomuto řešení došlo a hlavně vysvětlení proč v konstruktorech nepoužívat předávání konstruktorem najdeš tady. Jen pozor – odkazovaný článek je starý a to co on popisuje NENÍ anotace inejct, ale jen její ideový předchůdce. Technicky však on používá magii (zapisuje do private property), zatímco anotace inject je normální property injection – závislost se zapíše do public property a anotace jen řeknou, že se to má provést (@inject) a o jaká služba se má předat (@var).

P.S. Presentery už nejsou opuchlé hromádky kódu, konstruktor nyní mají prázdný a proto se do koncovch presenterů doporučuje předávat povinné závislosti konstruktorem (nikoliv však do abstraktních BasePresenterů jinak vznikne popisovaný konstructor-hell). Takže věta od @FilipProcházka „Ale stále – jediný důvod proč to dělám je, že presentery jsou opuchlé boule kódu.“ je jen alibi, které už neplatí. Ale programátor je tvor líný, tak se dodnes anotace používá i tam, kde to není potřeba :D

Editoval Šaman (2. 12. 2015 20:44)

Netbeans hvězdičkové peklo:

/* @var $item \App\ArticleEntity */
foreach($list as $item)
{
	$item-> //napovídá
}

/** @var $item \App\ArticleEntity */
foreach($list as $item)
{
	$item-> //nenapovídá
}

/** @var \App\ArticleEntity $item */
foreach($list as $item)
{
	$item-> //nenapovídá
}

/**
 * @inject
 * @var \App\ArticleModel
 */
public $Model; //injectuje

/*
 * @inject
 * @var \App\ArticleModel
 */
public $Model; //neinjectuje

Rozšířil jsem ještě o třetí příklad a upravil private `na `public. Anotace ve správném pořadí nenapovídá.

Editoval Pavel Kravčík (3. 12. 2015 12:47)

@Šaman: Máš pravdu, ty private jsou hrozný nesmysl. :) Psal jsem to jen tak na koleni rychle z hlavy. Já se v tom orientuji dobře a nikdy se mi nestalo, že by mi tam chyběla.

Spíš jsem tyhle věci sepsal do nějaké dokumentace a ukázal to dvěma externistům, kteří se zaučují. A pro ně je to hvězdičkové peklo. Plus ještě otočení variableName className za className variableName. Moje pointa spíš byla, že pro začátečníka je tohle strašně neintuitivní.

Ale pěkný komentář!

Ještě k netbeans divočině – to je strašně cool feature, hlavně pro kolekci entit. Takže to používám relativně často a chtěl jsem to předat dále, protože hlavně externisté nemají povědomí o všech 80ti entitách.

Editoval Pavel Kravčík (3. 12. 2015 12:35)

@CZechBoY: Ano, to Šaman psal. Protože je to anotace a ne komentář.

Já potřebuji nějak v dokumentaci říct co je v proměnný za objekt. Jak se k tomu objektu dostanu je na mě. Jestli si ho vytáhnu přes Container. Nebo inject do presenteru nebo přes konstruktor třídy. Prostě je hodně případů které nechci rozepisovat v dokumentaci, proto se vyrojil nápad napsat to komentářem co znám z netbeansu.

phpDoc je definovaný dvěma hvězdičkami a abych mohl použít anotace tak musím zapsat phpDoc. @inject je anotace. Mě to přijde jasný.

Editoval h4kuna (3. 12. 2015 15:15)

@Šaman v PHPStormu funguje napovídání lokálních proměnných stejně. Z funkčního hlediska je to komentář a může se smazat. Ale napovídá a to se počítá. Takže proč to nevyužít? ;-) Může se tomu třeba říkat standardizovaný komentář…