Toto téma nabízí informace o migraci kódu Java z VisualAge for Java.
Pokud provedete změny v komponentě Java pomocí vizuálního editoru jazyka Java, zdrojový kód je v závislosti na těchto změnách aktualizován. Změny ve zdrojovém kódu se projeví v metodách set, které změní hodnoty vlastností. Některé informace používané vizuálním editorem jazyka Java však nejsou uloženy ve vlastnostech, neboť jsou potřebné pouze v době návrhu. To zahrnuje i informaci o pozici objektu Java bean na povrchu volného formuláře.
Tato informace musí být uložena, aby mohl být vizuální editor jazyka Java znovu otevřen s objektem Java bean ve stejné pozici, takže je vložena do poznámky na řádku, ve kterém je objekt Java bean deklarován. Následující příkaz ukazuje komponentu JFrame která je umístěna na pozici 16,17:
private javax.swing.JFrame ivjJFrame = null; // @jve:visual-info decl-index=0 visual-constraint="16,17"
Poznámka představující pozici komponenty není povinná a neexistuje-li, je při otevření vizuálního editoru jazyka Java použita výchozí pozice. Toto výchozí umístění je aplikováno pouze u objektů Java Bean nejvyšší úrovně, které nejsou součástí jiných objektů, a neovlivňuje umístění komponent v pořadači. Umístění komponent v pořadači je určováno správcem rozvržení daného pořadače a pravidly a omezeními jednotlivých komponent.
V aplikaci VisualAge pro jazyk Java není umístění objektů Java Bean (taktéž nazývány jako části volného formuláře) součástí zdrojového kódu. Pokud provádíte migraci souboru napsaného pomocí VCE (Visual Composition Editor) aplikace VisualAge pro jazyk Java, budou použity výchozí pozice. Pokud chcete informace o pozicích zachovat, můžete si opatřit utilitu pro migraci, kterou nahrajete do VisualAge pro jazyk Java. Utilita pro migraci obnoví třídy pomocí informací o pozicích, jež jsou uložené ve formátu poznámek. Utilitu získáte stažením nejnovějšího balíčku Nástroj pro konverzi aplikací VisualAge pro jazyk Java VCE na adrese www.ibm.com/support/us/
Utilita pro migraci je k dispozici jakožto tempfix, který může být instalován pomocí FixManageru aplikace VisualAge pro jazyk Java (ve volbách Pracovní prostor> Nástroje> FixManager). Pomocí této utility lze třídy vyvinuté pomocí VCE aplikace VisualAge pro jazyk Java migrovat a exportovat do formátu vhodného pro vizuální editor. Po instalaci této opravy je možné zvolit Generování kódu VCE/Export... v rozevírací nabídce u projektů, balíčků či tříd. Vybráním položky spustíte průvodce, který pak znovu vygeneruje kódy tříd, které byly předtím uloženy pomocí VCE. Pozice volného formuláře budou uloženy ve formátu poznámek, které používá vizuální editor.
V případě připojení lze před spuštěním utility kód nejprve znovu vygenerovat použitím volby pro generování VCE kódu Použít vnitřní třídu pro každou událost. Některé třídy však takto nebude možné tímto stylem konvertovat vinou chyby v aplikaci VisualAge pro jazyk Java. V takovém případě použijte volbu pro generování VCE kódu Použít jednu vnitřní třídu pro všechny události. V průvodci také budete mít možnost exportovat třídy do adresáře poté, co bylo generování kódu dokončeno. Vizuální editor pro prostředí Java nedokáže provést analýzu na způsob generování kódu VCE s možností Nepoužívat vnitřní třídy.
Jelikož VCE používalo svůj vlastní model objektů Java Bean a jejich vlastností a vztahů, kód byl vždy znovu generován z tohoto modelu způsobem shora dolů. Jakékoli zásahy uživatele do zdrojového kódu byly omezeny na předem definované uživatelské kódové pozice ve zdrojovém kódu vymezené poznámkami //začátek uživatelského kódu {1} a //konec uživatelského kódu. Aby bylo jasné, že metody pro objekty Java bean byly nově generovány při každém generování kódu, byl k metodě ve formě poznámky přidán řádek /* UPOZORNĚNÍ: TATO METODA BUDE ZNOVU GENEROVÁNA. */. Utilita pro migraci poskytuje možnost tyto poznámky generované VCE odstranit z exportovaného kódu (nikoli zdrojového kódu VisualAge pro jazyk Java), neboť mimo VCE již nejsou použitelné. Jakmile však byly poznámky v uživatelských kódových pozicích jednou odstraněny ze zdrojového kódu, není již možné uživatelský kód použít v aplikaci VisualAge pro jazyk Java. Přítomnost těchto poznámek totiž chrání uživatelský kód před přepsáním.
Vizuální editor jazyka Java nepoužívá pro své objekty Java bean, jejich vlastnosti a vztahy stálý model a obvykle provádí analýzu zdrojového kódu pokaždé znovu. Z tohoto důvodu již nejsou poznámky pro uživatelské kódové pozice a pro regenerování metody platné a zdrojový kód může být volně upravován. Pokud zásahy do zdrojového kódu změní jeho strukturu tak, že vizuální editor jazyka Java již nedokáže rozlišit strukturu objektů Java Bean, je možné, že nebudou v pohledech Design a Java Beans zobrazeny. Nicméně zdrojový kód nebude změněn dle stylu editoru a vámi provedené změny budou zachovány.