anotace – neanotace, podpora vsech vychytavek ale bez uziti anotaci v komentarich

Chapem, ze vecsina ludi ma voci anotaciam vyhrady – ved su to preboha IBA komentare!

Ale skusme sa zamysliet:

• Komentar je sucast syntaxe a jazyka
• Rozsiruje jeho vyjadrovaciu schopnost
• Ulahcuje programatorovi orientaciu v kode tym, ze na vhodnych miestach popisuje co sa deje
• Je SUCASTOU kodu
• V inych jazykoch (napr: Java) su anotacia brane uplne prirodzene a tiez ovplyvnuju chovanie aplikacie (nie som Javysta, nemam ten jazyk rad kvoli jeho ukecanosti, ale niektore veci ma zariesene a pomerne standardizovanym sposobom)
• Jedina nevyhoda, ktora ma napada je, ze sa v komentaroch nepraktizuje syntax analyza takze ak clovek spravi preklep moze mu chvilku trvat nez objavi chybu (toto ale ide zariesit a dokonca tu na fore bola debata aby to Nette parser parsoval striktnym sposobom)

Co vam teda na pouzivani Anotacii vadi? To, ze je to KOMENTAR a napr eAccelerator apod mozu odstranovat komentare? Ja by som sa skorej bal rozsireni, ktore mi ZASAHUJU a modifikuju mnou uploadovany zdrojovy kod ako toho, ze mam nieco v komentaroch, ak tam tie komentare su, tak asi z nejakeho dovodu a nie na to aby sa mazali.

V neposlednom rade poskytuju Anotacie uzasnu vyjadrovaciu schopnost a nadstavbu nad jazykom priamo v miestach kde by to clovek cakal, bez potreby znovuobjavovat kolo a vymyslat fallbacky ako to zariesit bez anotacii.

Chapem, ze pre vela ludi to je myslienkovy blok pouzivat anotacie (aj pre mna urcitu dobu bol) ale som vyrazne za to aby sa postupne pretlacali do Nette a pouzivali. A vobec – aby sa pouzivali. Mozno autori PHP zvazia ich postavenie a v dalsich verziach PHP by sa mohli anotacie stat urcitou sucastou jazyka.

Já jsem jednoznačně pro anotace i před všechny zmíněné nevýhody. Takotvá antotace kód většinou zpřehlední a uštří ještě k tomu hromadu práce. A pokud bude někdy sktriktní parsování, tak pak to bude úplně nejlepší…

PS: eAccelerator už problémem docela dlouho není.

westrem: o tom, ze je komentar soucasti kodu bych tedy polemizoval. komentar je od toho, aby pomohl programatorovi pochopit o co v kodu je. to by se dalo rict treba i o odsazovani kodu nebo o vynechavani prazdnych radku pro prehlednost kodu, ze „je to jeho soucast“ (plati to v Pythonu :D).

uz jenom proto, ze do komentare clovek muze napsat co chce, jak chce, bez jakychkoliv pravidel, mi prijde zvlastni se komentari ridit a ovlivnovat tak beh aplikace.

navic, kdyz o tom premyslim o par milisekund dele – pri zpracovani skriptu dochazi samozrejme k vyhozeni nepodstatnych casti pro interpretaci (php -w -f foo.php)… a je zcela jasne, ze interpretr pak uz se zadnymi anotacemi nepracuje. to ze to funguje je dano tim, ze si to Nette v prvnim kole prechrousta a nekam si ulozi informace o danem „rozsireni“… repsektive ze se Nette kouka zpatky do zdrojaku a zjistuje, jestli tam anotace je, a jaka.

vrtak-cz: ano, to znam, ale pribude tu par dalsich „vychytanych“ anotaci, v dokumentaci o alternativnim „legalnim“ zapisu nebude ani zminka, novacci se to zacnou ucit jako samozrejmost. neprijde mi to jako koser pristup ke kodu.

westrem, paranoiq: o jakych nativnich anotaci v Jave mluvite? v Jave jsem chvilku delal a nic takoveho jsem nepotkal… (pravda, uz je to par let)

chapu, ze anotace v Nette (a Doctrine) rapidne zjednodusuji psani kodu. ale za cenu pouziti neceho, co neni soucasti jazyka, a co si muze kazdy nadefinovat jak se mu zamane. do interpretru se uz zadne komentare vubec nedostavaji… co kdyz se casem nejak zmeni chovani prekladace? navic se clovek nauci Nette anotace, a kdyz se anotace budou pouzivat jinde, zapocne chaos (zadna pravidla!)

a ano, bylo by fain mit jednu spravnou metodu psani kodu, zrovna u anotaci bych ale uvital, kdyby zde byl i dalsi alternativni (jednoduchy) zpusob…

ad anotace: ah, uz sem si nasel co je tim mysleno (i v .NETu jsou takovehle pomucecky). planuje se nejaky oficialni podpora v PHP? … wiki: https://en.wikipedia.org/…ogramming%29

Editoval wdolek (28. 9. 2010 21:29)

wdolek: Ad PHP anotace – něco takového se chystá (samozřejmě, když všichni implementují java-like anotace, tak PHP musí mít v rfc něco total jiného).

Ad Doctrine2 – nicméně stojí za povšimnutí, že v něm jaksi existuje způsob, jak se anotacím úplně vyhnout (a to samé u Symfony2).

Jinak osobně také doufám, že bude existovat možnost, jak u věcí, u kterých to dává smysl, se anotacím vyhnout a mít je v konfiguraci pohromadě. „Jediná správný způsob“ mě spíš děsí. .o)

Editoval Yrwein (28. 9. 2010 21:48)

redhead napsal

Ehm samozrejme, to som v tom zapale zabudol napisat, ze tam to nie je vramci komentarov

wdolek napsal

Ak sa nemylim, tak v Nette 2.0 uz budu anotacie riesene tak, ze ich musi zastupovat urcita trieda a musia splnat urcite anotacie, takze tolko k tomu, ze si moze pisat kto chce co chce.

Yrwein: na to sem take narazil, ale :( je to snad jen request, kdo vi, jestli to projde a kdy se to pripadne objevi. jinak to vypada pekne

Honza Marek

Jinak fakt nechápu důvod, že někdo nechce používat anotace, protože se mu nelíbí.

ja nechapu duvod, ze nekdo nechce nosit zeleny tricka, protoze se mu zelena nelibi… ne vazne :) proste se mi na tom nelibi, ze aplikace je ovlivnena necim, co je v komentari! (v Jave a .NETu jsou ty anotace/atributy soucasti jazyka a nejsou tedy v komentarich)

wdolek ma pravdu v jedne zasadni veci: anotace jsou proste v komentari a ten muze kdokoliv, kdykoliv z kodu naprosto beztrestne vyjmout a spravne by to nemelo zadnym zpusobem ovlivnit chovani napsaneho programu. Tak byly komentare IMHO od sameho zacatku zamyslene…

Na druhou stranu, stejne do tech komentaru vsichni (haha) piseme ruzne phpDoc veci, a je pravda, ze je to velmi elegantni a asi i trochu navykove. Takze ackoliv jsem v podstate filozoficky proti, tak musim uznat, ze anotace jsou cool a pouzivat je urcite budu. Nicmene budu to delat s vedomim pouceneho programatora, ze si ovlivnuju chovani programu v komentari (a z urciteho uhlu pohledu me to bude porad stvat;-)).

pekelnik napsal(a):

Jestli jsem to spravne pochpil, tak jde spise o filozofickou debatu, nez o nejake nářky ne?

paranoiq napsal(a):
… odpovím – „kdo by je vyjímal, když ví, že ovlivňují chování programu?!“ mohu si namluvit, že lze vyjmout třeba i deklarace tříd (a skutečně, i bez tříd lze programovat, že?), ale platné mi to nic nebude

Tak komentare jsou asi uplne to prvni, co z kodu vyjme jakykoliv kompilator ci interpreter :-) Jinak jasne, jako programator je tam samozrejme necham. Jenom se snazim rict, ze chapu, ze to nekomu neprijde uplne v poradku (vcetne me, jak jsem psal vyse), ze ovlivnuju chovani programu v komentarich:-)

Jinak problem tu asi ani neni s anotacemi jako takovymi, ale z jejich zapisem PHP. Nikdy bysme tady nevedli takovouhle debatu, kdyby se zapisovaly nativne do kodu a ne do komentare. Verim, ze i tohle se v nejake z pristich verzich PHP spravi a do te doby budou anotace dalsi cool vylepsenim Nette (ktere uz tak de-facto rozsiruje moznosti programovani v PHP o nekolik zajimavych veci). Takze asi tak :-)

aaron: Tak komentare jsou asi uplne to prvni, co z kodu vyjme jakykoliv kompilator ci interpreter :-)

pro jazyk PHP existuje jediný jakštakš použitelný interpretr – PHP. a ten dokumentační komentáře nevyjímá a nikdy vyjímat nebude. dokumentační komentáře jsou dostupné přes oficiální reflection API

UPDATE: stěžovat si na zápis anotací mi přijde jako stěžovat si na syntax Latte. to je také rozšíření funkčnosti šablon nad rámec PHP, které musí Nette nějakým způsobem interpretovat. samo o sobě, bez pomoci Nette to fungovat nebude. kupodivu nikomu nevadí, že Latte makra nejsou platný HTML ani PHP kód

Editoval paranoiq (30. 9. 2010 10:11)

@Honza Marek: to zní jako rozumný kompromis=)

paranoiq napsal(a):
začínám si myslet, že anotace jsou náboženství. stačí uvěřit a budete šťastní :]

jo!!