I det här avsnittet finns information om migrering av Java-kod från VisualAge for Java.
När du gör ändringar i en Java-komponent med hjälp av den visuella redigeraren för Java uppdateras källkoden på motsvarande sätt. Källkodsändringarna återspeglas i de set-metoder som ändrar egenskapsvärden. Viss information som används av den visuella redigeraren för Java lagras dock inte i egenskaperna eftersom den endast behövs i designläget. Exempel på sådan information är placeringen av en Java-böna på friformsytan.
Om du vill lagra den informationen så att det går att öppna den visuella redigeraren för Java med Java-bönan på samma plats placerar du informationen i en kommentar på den rad där Java-bönan deklareras. I följande sats visas en JFrame-komponent som är placerad vid 16,17:
private javax.swing.JFrame ivjJFrame = null; // @jve:visual-info decl-index=0 visual-constraint="16,17"
Kommentaren som representerar placeringen för en komponent är inte obligatorisk och om det inte finns någon kommentar tilldelas en standardplacering när den visuella redigeraren för Java öppnas. Den här standardplaceringen gäller endast Java-bönor på den översta nivån som inte ingår i en annan Java-böna och inte påverkar placeringen av komponenter inom en behållare. Placeringen av komponenter i en behållare bestäms av layouthanteraren för behållaren och gränserna eller reglerna för komponenten.
I VisualAge for Java ingår inte placeringen av Java-bönor på den översta nivån (även kallade friformselement) i källkoden. Om du migrerar en fil som skrevs med hjälp av VCE-redigeraren (Visual Composition Editor) i VisualAge for Java Visual används standardplacering. Om du vill behålla placeringsinformationen kan du hämta ett migreringsverktyg som ingår i VisualAge for Java. I migreringsverktyget återskapas klasserna med placeringen lagrad i ett kommentarsformat. Om du vill använda verktyget hämtar du det senaste konverteringsverktyget för VisualAge for Java Visual Composition Editor-tillämpningar från www.ibm.com/support/us/
Det här migreringsverktyget är tillgängligt som en temporär korrigering som kan installeras med hjälp av FixManager i VisualAge for Java (från Arbetsyta > Verktyg > FixManager). Verktyget används till att migrera och exportera klasser som har utvecklats med hjälp av VCE i VisualAge for Java till ett format som kan användas i den visuella redigeraren. När du har installerat det här verktyget kan du välja VCE Code Generation/Export... (VCE-kodgenerering/-export) i snabbmenyn för projekt, paket eller klasser. När du väljer det här alternativet öppnas en guide där kod för klasser som tidigare sparats med VCE kan återskapas. Friformsplaceringarna sparas i det kommentarsformat som används i den visuella redigeraren.
Om du har anslutningar kan du först återskapa koden genom att välja alternativet för VCE-kodgenerering, Use an inner class for each event (Använd en inre klass för varje händelse) innan du kör verktyget. Det går dock inte att konvertera vissa klasser till det här formatet på grund av ett fel i VisualAge for Java. I sådana fall bör du använda alternativet för VCE-kodgenerering Use one inner class for all events (Använd en inre klass för varje händelse). I guiden kan du även välja att exportera klasserna till en katalog när kodgenereringen är klar. VCE-kodgenereringsformatet Do not use any inner classes (Använd inga inre klasser) tolkas inte av funktionerna för den visuella redigeraren för Java-händelser.
Eftersom VCE behöll sin egen modell för Java-bönorna och deras egenskapsvärden och relationer återskapades källan uppifrån och ned från den modellen. Ändringar av källan som gjordes av en användare var begränsade till fördefinierade användarkodpunkter i källan avgränsade med kommentarerna //user code begin {1} och //user code end. I syfte att visa att metoderna för Java-bönorna återskapades varje gång kodgenerering utfördes lades raden /* WARNING: THIS METHOD WILL BE REGENERATED. */ till i metodkommentaren. I migreringsverktyget finns ett alternativ för att ta bort de här VCE-genererade kommentarerna från den exporterade koden (inte källkoden i VisualAge for Java), eftersom de inte längre kan tillämpas utanför VCE. När kommentarerna till användarkodpunkterna har tagits bort från källan går det dock inte att använda användarkoden i VisualAge for Java. Anledningen är att de här kommentarerna skyddar användarkoden från att skrivas över.
I den visuella redigeraren för Java används inte en permanent objektmodell för Java-bönorna och deras egenskapsvärden och relationer. I stället tolkas källan varje gång. Av den anledningen gäller kommentarerna till användarkodpunkter och till att ange metodåterskapande inte längre och ändringar av källkoden kan göras fritt. Om ändringarna påverkar källkodsstrukturen så att den visuella redigeraren för Java inte längre känner igen strukturen för Java-bönorna kan det hända att de inte visas i designvyn eller vyn Java-bönor. Källkoden ändras dock inte för att passa redigerarens format och ändringarna sparas.