En este tema se proporciona información sobre la migración de código Java desde VisualAge para Java.
Cuando realiza cambios en un componente Java utilizando el editor visual para Java, el código fuente se actualiza para reflejar dichos cambios. Los cambios en el código fuente se reflejan en los métodos set que cambian los valores de propiedad. No obstante, parte de la información que utiliza el editor visual para Java no se almacena en propiedades, ya que sólo es necesaria en tiempo de diseño. Esta información incluye la posición de un bean Java en la superficie de formato libre.
Para almacenar esta información de forma que el editor visual para Java pueda volver a abrir el bean Java en la misma posición, la información se coloca en un comentario en la línea que declara el bean Java. La sentencia siguiente muestra un componente JFrame situado en 16,17:
private javax.swing.JFrame ivjJFrame = null; // @jve:visual-info decl-index=0 visual-constraint="16,17"
El comentario que representa la posición de un componente no es necesario y, si no está presente, al abrir el editor visual para Java se asigna una posición por omisión. Esta posición por omisión solo se aplica a beans Java de nivel superior, que no están contenidos dentro de otros, y no afecta a la posición de los componentes dentro del contenedor. La ubicación de los componentes dentro del contenedor viene determinada por el gestor de diseño del contenedor y los límites o restricciones del componente.
En VisualAge para Java, la posición de los beans Java de nivel superior (que también se llaman componentes de formato libre) no está presente en el código fuente. Si se migra un archivo escrito mediante el editor de composición visual (VCE) de VisualAge para Java, se utilizan las posiciones por omisión. Si desea mantener la información posicional, puede obtener un programa de utilidad de migración que está cargado en VisualAge para Java. El programa de utilidad de migración regenera las clases con la posición almacenada en un formato de comentario. Para obtener el programa de utilidad, descargue la última Herramienta de conversión para las aplicaciones del Editor de composición visual de VisualAge para Java en www.ibm.com/support/us/
Este programa de utilidad de migración está disponible como un arreglo temporal que se puede instalar utilizando el gestor de arreglos (FixManager) de VisualAge para Java (en Espacio de trabajo > Herramientas > FixManager). El programa de utilidad migra y exporta clases que hayan sido desarrolladas utilizando el VCE de VisualAge para Java en un formato apropiado para el editor visual. Después de instalar este parche, puede seleccionar Generación/exportación de código VCE... en el menú emergente para proyectos, paquetes o clases. Al seleccionar este elemento se lanza un asistente que puede volver a generar el código para las clases que han sido previamente guardadas con el VCE. Las posiciones de formato libre se guardan en formato de comentario, utilizado por el editor visual.
Si tiene conexiones, primero puede volver a generar este código seleccionando la opción de generación de código de VCE Utilizar una clase interna para cada evento antes de ejecutar este programa de utilidad. No obstante, algunas clases no se podrán convertir a este estilo, debido a una pequeña anomalía en VisualAge para Java. En este caso, puede utilizar la opción de generación de código de VCE Utilizar una clase interna para todos los eventos. El asistente también proporciona la opción para exportar las clases a un directorio una vez completada la generación del código. El soporte de eventos del editor visual para Java no analizará el estilo de generación de código de VCE No utilizar clases internas.
Como el VCE mantiene su propio modelo de beans Java y sus valores de propiedades y relaciones, siempre regenerará el código fuente en la forma de arriba abajo (descendente) a partir de este modelo. Las modificaciones que el usuario realice al fuente se limitan a puntos de código de usuario predefinidos en el fuente por los comentarios //user code begin {1} y //user code end. Además, para indicar que los métodos de los beans Java se volvían a generar cada vez que se llevara a cabo la generación de código, se añadía la línea /* WARNING: THIS METHOD WILL BE REGENERATED. */ al comentario del método. El programa de utilidad de migración tiene una opción que elimina estos comentarios generados por VCE del código exportado (no del código fuente en VisualAge para Java), ya que no se aplican fuera de VCE. No obstante, una vez que los comentarios para los puntos de código de usuario se han eliminado del fuente, el código de usuario no se puede utilizar en VisualAge para Java. El motivo es que la presencia de estos comentarios es lo que protege el código de usuario contra sobrescritura.
El editor visual para Java no utiliza un modelo de objetos persistente para sus beans Java y para sus valores de propiedades y relaciones, sino que analiza el fuente cada vez. Por este motivo, los comentarios para los puntos del código de usuario y para la especificación de la regeneración de métodos ya no se aplican, y se pueden hacer modificaciones con libertad en el código fuente. Si estas modificaciones alteran la estructura del código fuente de forma que el editor visual para Java ya no sea capaz de reconocer la estructura de los beans Java, puede que estos no aparezcan en la vista Diseño o en la vista Beans Java. No obstante, el fuente no se altera para ajustarse al estilo del editor, y los cambios se conservan.