Afsnittet indeholder oplysninger om konvertering af Java-kode fra VisualAge til Java.
Når du foretager ændringer til en Java-komponent vha. den visuelle editor til Java, opdateres kildekoden for at afspejle ændringerne. Kildekodeændringerne afspejles i set-metoder, som ændrer egenskabsværdier. Men nogle af oplysningerne, der bruges af den visuelle editor til Java, gemmes ikke i egenskaberne, fordi der kun er brug for dem på designtidspunktet. Disse oplysninger omfatter bl.a. placeringen af en Java-bean på free form-overfladen.
For at gemme disse oplysninger, så den visuelle editor til Java kan genåbnes med Java-bean'en på samme sted, placeres de i en kommentar på den linje, der erklærer Java-bean'en. Følgende sætning viser en JFrame-komponent, hvis placering er 16,17:
private javax.swing.JFrame ivjJFrame = null; // @jve:visual-info decl-index=0 visual-constraint="16,17"
Den kommentar, der repræsenterer placeringen af en komponent, er ikke nødvendig, og hvis ingen kommentar er til stede, tildeles en standardplacering, når den visuelle editor til Java åbnes. Denne standardplacering gælder kun for de Java-beans på øverste niveau, som ikke er indeholdt i en anden, og som ikke påvirker placeringen af komponenter i et opbevaringssted. Placeringen af komponenter i et opbevaringssted bestemmes af opbevaringsstedets layoutstyring og komponentens grænser eller betingelser.
I VisualAge til Java findes placeringen af Java-beans på øverste niveau (kaldes også free form-dele) ikke i kildekoden. Hvis du overfører en fil, der er skrevet vha. VisualAge til Java's Visual Composition Editor (VCE), benyttes standardplaceringer. Hvis du vil bevare oplysningerne om placering, kan du hente en overførselsfunktioner, der indlæses i VisualAge til Java. Overførselsfunktionen genererer klasserne igen med placeringen gemt i et kommentarformat. Du henter funktionen ved at overføre det seneste Conversion tool for VisualAge til Java Visual Composition Editor applications fra www.ibm.com/support/us/
Denne overførselsfunktion er tilgængelig som en midlertidig programrettelse, som kan installeres vha. VisualAge til Java's FixManager (fra Arbejdsområde > Værktøjer > FixManager). Funktionen overfører og eksporterer klasser, der er udviklet vha. VisualAge til Java's VCE til et format, der er velegnet til den visuelle editor. Når du har installeret denne programrettelse, kan du vælge VCE Code Generation/Export... på pop op-menuen for projekter, pakker eller klasser. Når du vælger dette element, startes en guide, der kan generere koden for de klasser, der tidligere er gemt vha. VCE, igen. Free form-placeringerne gemmes i det kommentarformat, som benyttes af den visuelle editor.
Hvis du har forbindelser, kan du først generere denne kode igen ved at vælge VCE-indstillingen for kodegenerering Use an inner class for each event, inden du udfører denne funktion. Men visse klasser kan ikke konverteres til denne typografi pga. en fejl i VisualAge til Java. I det tilfælde skal du bruge VCE-indstillingen for kodegenerering Use one inner class for all events. Denne guide giver dig også mulighed for at eksportere klasserne til et bibliotek, når kodegenereringen er udført. Understøttelsen til den visuelle editor til Java-aktiviteter analyser ikke VCE-typografien for kodegenerering Do not use any inner classes.
Da VCE vedligeholder sin egen model af Java-beans og deres egenskabsværdier og relationer, regenererer den altid kilden ovenfra og nedefter fra denne model. Eventuelle ændringer, som bruger foretager til kilden, er begrænset til foruddefinerede brugerkodepunkter i kilden, som er begrænset af kommentarer //user code begin {1} og //user code end. For at angive, at metoderne for Java-beans er regenereret, hver gang kodegenerering udføres, føjes linjen /* WARNING: THIS METHOD WILL BE REGENERATED. */ til metodekommentaren. Overførselsfunktionen indeholder en indstilling, der kan fjerne disse VCE-genererede kommentarer fra den eksporterede kode (ikke kildekoden i VisualAge til Java), da de ikke længere kan bruges uden for VCE. Men når først kommentarerne for brugerkodepunkterne er fjernet fra kilden, kan brugerkoden ikke bruges i VisualAge til Java. Det skyldes, at tilstedeværelsen af disse kommentarer beskytter brugerkoden i at blive overskrevet.
Den visuelle editor til Java bruger ikke en vedvarende objektmodel til Java-beans og deres egenskabsværdier og relationer, men analyserer kilden hver gang. Derfor anvendes kommentarerne til brugerkodepunkter og til angivelse af metoderegenerering ikke længere, og ændringerne kan foretages frit til kildekoden. Hvis ændringerne ændrer strukturen på kildekoden, så den visuelle editor til Java ikke længere kan genkende strukturen af Java-beans, vises de muligvis ikke i oversigten Design eller Java-beans. Men kilden ændres ikke til at passe til editorens typografi, og dine ændringer bevares.