diff options
Diffstat (limited to 'tde-i18n-sk/docs/kdesdk/umbrello/code_import_and_generation.docbook')
| -rw-r--r-- | tde-i18n-sk/docs/kdesdk/umbrello/code_import_and_generation.docbook | 265 |
1 files changed, 265 insertions, 0 deletions
diff --git a/tde-i18n-sk/docs/kdesdk/umbrello/code_import_and_generation.docbook b/tde-i18n-sk/docs/kdesdk/umbrello/code_import_and_generation.docbook new file mode 100644 index 00000000000..29585463c7f --- /dev/null +++ b/tde-i18n-sk/docs/kdesdk/umbrello/code_import_and_generation.docbook @@ -0,0 +1,265 @@ +<chapter id="code-import-generation"> + +<title>Import a generovanie zdrojového kódu</title> + +<para> +Umbrello modelovací nástroj UML a jeho použitie tkvie v <emphasis>analýze +a návrhu </emphasis> systémov. Pre zjednodušenie prechodu od návrhu k +<emphasis>implementácii</emphasis> dokáže Umbrello vygenerovať zdrojový text pre +mnoho programovacích jazykov. Ak však chcete UML nasadiť v už existujúcom +projekte, podporuje Umbrello vytvorenie modelu už existujúceho modelu tým, že +načíta zdrojový text a vytvorí nájdené triedy. +</para> + +<sect1 id="code-generation"> + +<title>Generovanie zdrojového kódu</title> + +<para> +Umbrello dokáže vygenerovať zdrojový text v mnohých programovacích jazykoch a +pomáha pritom pri začiatkoch implementácie. Vygenerovaný zdrojový text pozostáva +z deklarácií tried, metód a atribútov. Tieto oddiely musí programátor +<quote>správne vyplniť</quote>, aby pridal funkcionalitu do operácií tried. +</para> + +<para> +Umbrello 1.1 dokáže vygenerovať zdrojový kód pre jazyky C++, Java a PHP. Iné +jazyky je možné jednoducho pridať ako zásuvné moduly aj neskôr. +</para> + +<sect2 id="add-languages"> + +<title>Pridanie jazyka</title> + +<para> +Umbrello 1.1 sa dodáva s podporou pre generovanie zdrojového kódu pre jazyky +C++, Java a PHP. Tieto jazyky sa pri prvom štarte Umbrello pridajú do zoznamu +dostupných jazykov. Neskôr je možné si stiahnuť a prostredníctvom mechanizmu +zásuvných modulov do programu pridať. +</para> +<para> +Pri každom štarte Umbrello testuje, či existujú nové zásuvné moduly. Potom +vyžaduje súhlas s pridaním jazykov, ktoré majú byť zavedené ako nové +(Jeden zásuvný modul môže obsahovať generátor zdrojového kódu pre viaceré +jazyky). Jazyky môžeme pridať alebo odobrať pomocou položky +<guimenuitem>Pridať/odobrať jazyky pre generovanie kódu</guimenuitem> z menu +Kód. +</para> +<para> + <screenshot> + <screeninfo>Pridať/odobrať jazyky</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="pics/add-remove-languages.png" + format="PNG"/> + </imageobject> + <textobject> + <phrase> + Odstrániť alebo pridať jazyk pre generovanie zdrojového kódu + v Umbrello + </phrase> + </textobject> + <caption> + <para> + Odstrániť alebo pridať jazyk pre generovanie zdrojového kódu + v Umbrello + </para> + </caption> + </mediaobject> + </screenshot> +</para> +</sect2> + +<!--add-languages--> +<sect2 id="generate-code"> +<title>Generovanie zdrojového kódu</title> + +<para> +Aby sme mohli vygenerovať zdrojový kód pomocou programu Umbrello, musíme prv +načítať model, ktorý obsahuje aspoň jednu triedu. Ak chceme vygenerovať zdrojový +kód, musíme spustiť <guimenuitem>Asistenta pre generovanie zdrojového +kódu...</guimenuitem> z menu <guimenuitem>Kód</guimenuitem>. Tým sa spustí +asistent, ktorý nás prevedie procesom vytvorenia zdrojového kódu. +</para> + +<para> +V prvom kroku treba vybrať triedy, pre ktoré chceme vygenerovať kód. Na začiatku +sú všetky triedy modelu vybrané a je možné ich odstrániť len po jednom. Ak to +chceme dosiahnuť, musíme ich premiestniť z pravého zoznamu do ľavého +zoznamu. +</para> + +<para> +Ako ďalší krok asistenta môžeme zmeniť parametre generátora zdrojového kódu. Sú +dostupné tieto parametre: +</para> + +<para> + <screenshot> + <screeninfo>Parametre zdrojového kódu</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="pics/generation-options.png" format="PNG"/> + </imageobject> + <textobject> + <phrase>Parametre pre generovanie zdrojového kódu pomocou Umbrello + </phrase> + </textobject> + <caption> + <para> + Parametre pre generovanie zdrojového kódu pomocou Umbrello + </para> + </caption> + </mediaobject> + </screenshot> +</para> + +<sect3 id="generation-options"> + +<title>Nastavenia generovania</title> + +<sect4> + <title>Dokumentácia zdrojového kódu</title> + + <para> + Parameter <guilabel>Zapísať dokumentačné komentáre, aj keď sú prázdne + </guilabel> hovorí generátoru zdrojového kódu, aby vložil komentáre v tvare + <emphasis>/** bla-bla */</emphasis> aj vtedy, ak sú prázdne. Ak triedy, metódy a + atribúty boli v modeli dokumentované, vloží generátor zdrojového kódu tieto + komentáre vo formáte Doxygen, nezávisle od toho, čo bolo v tomto kroku vybrané. + Ak tento parameter je zapnutý, bude pre všetky triedy, metódy a atribúty + vložené miesta pre dokumentáciu, aj keď v modeli neboli tieto prvky + zdokumentované. Dokumentáciu by mal potom programátor zapísať priamo v + zdrojovom kóde na tieto miesta. + </para> + + <para> + <guilabel>Zapísať komentáre pre sekcie, aj keď sú prázdne</guilabel>: Umbrello + zapíše komentáre do zdrojového kódu pre oddelenie jednotlivých sekcií triedy. + Tým sa oddelia napr. <quote>metódy typu <emphasis>public</emphasis></quote> alebo + <quote>atribúty</quote> a vkladajú sa pred príslušné sekcie. Ak bol tento + parameter aktivovaný, bude pre každú sekciu vložený takýto komentár, aj keď je + sekcia prázdna. Takto by sa vložil komentár <quote>metódy typu <emphasis>protected + </emphasis></quote>, aj keď žiadne také metódy v triede neexistujú. + </para> +</sect4> + +<sect4> + <title>Priečinky</title> + + <para> + <guilabel>Zapísať všetky generované hlavičky do priečinku</guilabel>: tu si + môžeme vybrať priečinok, kam sa budú ukladať hlavičkové súbory zdrojového kódu. + </para> + + <para> + Parameter <guilabel>Vložiť hlavičkové súbory z priečinku</guilabel> umožňuje + vložiť hlavičku na začiatok každého vygenerovaného súboru. Tieto hlavičky + súborov môžu obsahovať informácie o vlastníctve alebo informácie o licencii, + ako aj premenných, ktoré budú počas generovania zdrojového kódu. + Odporúčame, aby ste sa pozreli prv na vzorovú hlavičku pre súbory, ktorá je + dodávaná s programom Umbrello. V nej môžete vidieť, ako je možné pomocou + premenných vložiť aktuálny dátum alebo meno. + </para> +</sect4> + +<sect4> + <title>Pravidlá pre prepísanie</title> + + <para> + Tieto parametre určujú, čo má Umbrello 1.1 robiť, ak chce zapísať súbory počas + generovania zdrojového kódu a cieľový priečinok už existuje. Dokáže súbory + <emphasis>nezmeniť</emphasis>. Môžeme si vybrať medzi možnosťami + <quote>Prepísať</quote>, <quote>Opýtať sa</quote> a <quote>Použiť iný názov + súboru</quote>. Ak prikážeme, aby Umbrello našiel iný názov súboru, priloží + Umbrello príponu k existujúcemu názvu súboru. + </para> +</sect4> + +<sect4> + <title>Jazyk</title> + + <para> Umbrello použije pre generovanie zdrojového kódu práve aktívny jazyk. V + každom prípade si môžeme v Asistentovi pre generovanie zdrojového kódu vybrať + iný jazyk. + </para> +</sect4> + +</sect3><!--generation-options--> + +<sect3 id="generation-wizard-generation"> + +<title>Generovanie zdrojového kódu</title> + +<para> +Tretí a posledný krok asistenta zobrazí status samotného generovania zdrojového +kódu. Teraz stlačíme tlačidlo Generovať, aby sa príslušné súbory pre +jednotlivé triedy vytvorili. +</para> + +<para> +Musíme si uvedomiť, že nastavené parametre platia len pre aktuálne generovanie +zdrojového kódu. Pri ďalšom vyvolaní asistenta musíme všetky parametre, ako aj +priečinok pre hlavičkové súbory a nastavenie o prepísaní nastaviť znova. Dlhodobé +nastavenie parametrov môžeme vykonať prostredníctvom sekcie +<guilabel>Generovanie zdrojového kódu</guilabel> v nastaveniach Umbrello +v menu <menuchoice><guimenu>Nastavenia</guimenu><guimenuitem>Nastaviť +Umbrello... </guimenuitem></menuchoice>. +</para> + +<para> +Ak sú štandardné nastavenia pre generovanie zdrojového kódu správne, môžeme +generovanie spustiť priamo bez asistenta. Robí sa to pomocou položky +<guimenuitem>Generovať všetok zdrojový kód</guimenuitem> z menu Kód. Tým sa +vygeneruje zdrojový kód pre všetky triedy modelu pomocou aktuálnych nastavení, +ako sú výstupný priečinok a nastavenia pre prepísanie. Preto treba túto voľbu +používať opatrne. +</para> + +</sect3> + +</sect2><!--generate-code--> +</sect1> <!--code-generation--> + +<sect1 id="code-import"> + +<title>Import zdrojového kódu</title> + +<para> +Umbrello dokáže načítať zdrojový text už existujúceho projektu pre vytvorenie +systémového modelu. Umbrello 1.1 dokáže načítavať zdrojový kód v jazyku C++, +ďalšie jazyky budú nasledovať v neskorších verziách. +</para> + +<para> +Aby bolo možné triedy importovať do aktuálneho modelu, musíme zvoliť položku +<guimenuitem>Importovať triedy...</guimenuitem> z menu +<guimenu>Kód</guimenu>. +V dialógu, ktorý sa objaví, si musíme vybrať súbory, ktoré obsahujú deklarácie +tried jazyka C++ a potvrdiť stlačením OK. Triedy sa importujú a budú vložené do +stromu modelu. Pripomíname, že Umbrello pri načítavaní nevytvára diagramy, len +načíta triedy. Tieto môžeme potom použiť pri už existujúcich diagramoch. +</para> + +<para> +<screenshot> + <screeninfo>Import zdrojového kódu</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="pics/code-import.png" format="PNG"/> + </imageobject> + <textobject> + <phrase>Dialóg pre import zdrojového kódu v + Umbrello</phrase> + </textobject> + <caption> + <para>Dialóg pre import zdrojového kódu v + Umbrello</para> + </caption> + </mediaobject> +</screenshot> +</para> + +</sect1> +</chapter> +<!--code-import-generation--> |