Migración de código de VisualAge para Java al editor visual

En este tema se proporciona información sobre la migración de código Java desde VisualAge para Java.

Cuando se realizan cambios en un componente de Java utilizando el editor visual de 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 de Java en la superficie del formulario libre.

Para almacenar esta información de forma que el editor visual de Java pueda volver a abrir el bean de Java en la misma posición, en la línea que declara el bean de Java se coloca un comentario. 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 de Java se asigna una posición por omisión. Esta posición por omisión sólo se aplica a beans de Java de nivel superior, que no están contenidos dentro de otros, y no afecta a la ubicació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 bean de Java de nivel superior (también referidos como partes de formulario libres) no se presenta en el código fuente. Si se migra un archivo escrito utilizando el editor de composición visual (Visual Composition Editor - 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 Área 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.


Patrón 1 de VCE


Patrón 2 de VCE

Como VCE mantiene su propio modelo de beans de 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 bean de 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 de Java no utiliza un modelo de objetos persistente para sus beans de Java y para sus valores de propiedades y relaciones sino que en lugar de esto, 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 de Java ya no sea capaz de reconocer la estructura de los beans de Java, puede que éstos no aparezcan en la vista Diseño o en la vista de Beans Java. No obstante, el fuente no se altera para ajustarse al estilo del editor, y los cambios se conservan.

Tema padre: Editar Java en el editor visual

(C) Copyright IBM Corporation 1999, 2004. Reservados todos los derechos.