Modernización de aplicaciones Java

Editar en línea

Puede modernizar sus aplicaciones Java empresariales, incluidas las aplicaciones tradicionales de WebSphere® Application Server , a Liberty. Para modernizar una aplicación, primero se carga un plan de migración o se crea y analiza la aplicación, y después se solucionan los problemas de la aplicación.

A partir de la versión 1.1, puede utilizar Application Modernization Accelerator Developer Tools con aplicaciones creadas con herramientas que no sean Maven, pero con limitaciones. Para obtener más información, consulte Aplicaciones creadas con herramientas de compilación que no son Maven.

Antes de empezar

  1. Configure su entorno Java empresarial.
  2. Instale el complemento Visual Studio Code ampliación, el Eclipse IDE complemento o el IntelliJ IDEA IDE complemento.
Importante: En Eclipse IDE, para obtener mejores resultados con una aplicación multimódulo Java , asegúrese de importar el módulo agregador y cada submódulo como proyectos independientes dentro del espacio de trabajo Eclipse . Si importa el directorio de nivel superior como un único proyecto, es posible que IBM Application Modernization Accelerator Developer Tools no introspeccione correctamente su proyecto.

Complete los pasos para cargar su plan de migración de aplicaciones o los pasos para analizar su aplicación. Una vez completado un conjunto de pasos, puede solucionar los problemas de la migración. Los pasos para solucionar los problemas son los mismos tanto para los pasos del plan de migración como para el análisis de la aplicación. Una vez solucionados los problemas, dispondrá de una aplicación modernizada.

Si encuentra un problema que utiliza Application Modernization Accelerator Developer Tools, consulte la página Solución de problemas.

Tiempo necesario para analizar su código

El tiempo necesario para analizar su solicitud varía. Los siguientes horarios son típicos.

Tabla 1. Tiempo necesario para el análisis
Hora Detalles de la aplicación
De segundos a unos minutos Menos de 100 clases
de 2 a 10 minutos de 20.000 a 50.000 líneas de código
10 minutos o más 300.000 líneas de código
Importante:

Cuando Application Modernization Accelerator Developer Tools analiza su aplicación, excluye por defecto algunos paquetes de terceros del análisis de código. Para obtener más información, consulte Paquetes de terceros que se excluyen del análisis de aplicaciones.

Utilizar un plan de migración para modernizar su aplicación

Los siguientes pasos asumen que está utilizando IBM Application Modernization Accelerator para generar un plan de migración. El plan de migración contiene una lista de cuestiones de modernización que deben abordarse. También contiene información de configuración generada automáticamente para que la aplicación funcione correctamente en Liberty.

Importante:
  • Si ya ha cargado y analizado un plan de migración para su proyecto, al cargar un nuevo plan de migración se sobrescribe el análisis existente.
  • Antes de modernizar su aplicación, realice una compilación completa de la misma para asegurarse de que parte de una compilación de la aplicación en buen estado. Esta compilación también ayuda a garantizar que los archivos de clase estén actualizados con el código fuente más reciente. Deben estar actualizados antes de ejecutar automatizaciones que añadan cambios para las actualizaciones de versiones de Java .

Si revierte los cambios en su código, deberá hacer clic en Volver a cargar / analizar y realizar un análisis completo si desea modernizar su aplicación de nuevo.

  1. En su IDE, haga clic con el botón derecho en cualquier elemento de la jerarquía en el directorio de la aplicación que desea modernizar, haga clic en Modernize Java Applicationsy, a continuación, haga clic en Modernizar en Liberty.
  2. En la página Modernizar <nombre de su aplicación>, cargue el plan de migración.

    El IDE analiza su carpeta de proyecto, recopila información sobre su aplicación y, a continuación, carga el plan de migración que genera Application Modernization Accelerator .

    1. Haga clic en Cargar plan de migración.
    2. Seleccione en la lista el plan de aplicación para el fichero de archivo y haga clic en Abrir.

      Cuando finaliza el proceso de carga del plan de migración, la página Modernizar <nombre de su aplicación> muestra los siguientes archivos de configuración que se encuentran en el plan:

      • server.xml es el archivo de configuración para Liberty y es necesario para iniciar su aplicación.
      • Containerfile sólo es necesario para crear una imagen de contenedor para su aplicación Liberty .

    3. Seleccione los archivos que desea añadir al proyecto y haga clic en Continuar.

      • (Obligatorio) Seleccione el archivo server.xml .
      • (Opcional) Seleccione el archivo Containerfile sólo si está creando una imagen de contenedor para su aplicación Liberty .

    Cuando finaliza la carga del plan de migración, se muestran las incidencias que hay que corregir o revisar.

  3. Si el análisis detecta servicios JAX-RPC en su aplicación, siga las instrucciones que aparecen en pantalla para migrar los servicios JAX-RPC a servicios JAX-WS .

  4. Solucionar problemas con la aplicación.

    Dependiendo de los problemas que haya que solucionar, la capacidad para solucionarlos puede ser automática o autodirigida. Las incidencias de la pestaña Información adicional no requieren un cambio de código, pero es posible que tenga que verificarlas o probarlas y realizar un cambio de código si lo desea.

Analizar su aplicación para modernizarla

Los siguientes pasos suponen que está analizando su aplicación en lugar de utilizar un plan de migración de Application Modernization Accelerator para modernizarla. El análisis le proporciona una lista de problemas a resolver y una configuración limitada del servidor en el archivo server.xml . El archivo server.xml contiene una lista de las funciones que utiliza tu aplicación, pero no incluye otra información de configuración, como conexiones a bases de datos o configuraciones JMS.

Si revierte los cambios en su código, deberá hacer clic en Volver a cargar / analizar y realizar un análisis completo si desea modernizar su aplicación de nuevo.

  1. En su IDE, haga clic con el botón derecho del ratón en el directorio que desea modernizar, haga clic en Modernize Java Applications y, a continuación, en Modernizar a Liberty.

  2. En la página Modernizar <nombre de su aplicación>, expanda Analizar aplicación y haga clic en Iniciar análisis.

  3. Seleccione los parámetros de análisis, que definen las reglas con las que se analiza el servidor de aplicaciones.

    1. Seleccione el servidor de aplicaciones de origen y el servidor de aplicaciones de destino.

    2. Opcionalmente, cambie la fuente Java SE, que se muestra automáticamente con un valor recomendado.

      El valor recomendado se basa en la versión de Java SE que Application Modernization Accelerator Developer Tools recomienda para el origen del servidor de aplicaciones. Es posible que su servidor de aplicaciones esté utilizando una versión de Java SE distinta de la recomendada. Si es así, cambie la fuente Java SE a la versión que utiliza su servidor de aplicaciones.

      Por ejemplo, Application Modernization Accelerator Developer Tools recomienda Java SE 8 para WebSphere Application Server V8.5.5 aunque su servidor de aplicaciones pueda estar utilizando una versión anterior de Java SE.

      Importante: La versión mínima compatible con Java es Java 5.

    3. Seleccione el objetivo Java SE.

    4. Construya la aplicación y después analícela.

      El análisis de la aplicación se realiza en el binario de la aplicación. La aplicación debe crearse antes de iniciar el análisis.

      • Para las compilaciones de Maven, puede compilar la aplicación manual o automáticamente.

        Haga clic en Analizar después de crear manualmente la aplicación o en Crear y analizar para crear y analizar automáticamente la aplicación.

        Una vez creada y analizada la aplicación, se muestran los problemas que hay que corregir o revisar.

        Al hacer clic en Crear y analizar, la aplicación se crea en su versión de origen actual Java , para que pueda analizarse en busca de problemas de actualización de Java . Asegúrese de configurar el IDE con el kit de desarrollo Java de la versión fuente Java , para que el IDE pueda compilar correctamente la aplicación.

      • Para las compilaciones que no utilizan Maven, compile manualmente la aplicación, seleccione el binario de la aplicación y, a continuación, haga clic en Analizar.

        Una vez creada y analizada la aplicación, se muestran los problemas que hay que corregir o revisar.

  4. Si el análisis detecta servicios JAX-RPC en su aplicación, siga las instrucciones que aparecen en pantalla para migrar los servicios JAX-RPC a servicios JAX-WS .

  5. Solucionar problemas con la aplicación.

    Para las compilaciones de Maven, dependiendo de los problemas a solucionar, la capacidad de solucionarlos puede ser automatizada o autodirigida.

    Dado que IBM Application Modernization Accelerator Developer Tools no puede ejecutar automatizaciones para compilaciones que no utilizan Maven, los problemas a solucionar son autodirigidos.

    Las incidencias de la pestaña Información adicional no requieren un cambio de código, pero es posible que tenga que verificarlas o probarlas y realizar un cambio de código si lo desea.

Migración de los servicios JAX-RPC a los servicios JAX-WS

A partir de la versión IBM Application Modernization Accelerator Developer Tools 1.1, puede modernizar los servicios JAX-RPC detectados a servicios JAX-WS antes de abordar cualquier otra cuestión de modernización.
Importante:
  • Si está migrando a Jakarta EE 9 o a una versión posterior de Jakarta EE, migre primero sus servicios JAX-RPC a servicios JAX-WS . De lo contrario, el asistente de migración de fuentes de JAX-RPC no podrá ayudarle porque los servicios de JAX-RPC no están disponibles a partir de Jakarta EE 9.
  • También debe migrar los servicios de JAX-RPC a JAX-WS antes de realizar cualquier otra corrección de modernización. Si realiza otras correcciones de modernización en primer lugar, la modernización podría actualizar Java EE a una versión que no admita los servicios de JAX-RPC .

Migre manualmente los servicios de JAX-RPC a JAX-WS o haga clic en Continuar. Cuando haga clic en Continuar, el asistente de migración de origen de JAX-RPC a JAX-WS le ayudará con la migración.

En los pasos siguientes se supone que ha hecho clic en Continuar.

  1. Complete todas las correcciones de los archivos .wsdl .

    La migración a JAX-RPC requiere que se completen todas las correcciones de un archivo .wsdl antes de trabajar en otro archivo .wsdl de la lista.

    En la página principal de migración JAX-RPC se muestra la siguiente información. Utilízalo para completar la migración.
    Reiniciar
    Si desea reiniciar la migración, haga clic en Reiniciar.
    Importante:
    • Al hacer clic en Reiniciar, aparece un mensaje que dice que si desea reiniciar la migración, debe revertir todos los cambios de código realizados con correcciones automáticas y correcciones manuales. Si no revierte todos los cambios y reinicia la migración, los archivos de .wsdl para los que previamente ejecutó automatizaciones aparecen en la sección No compatible (migración manual necesaria).
    • Si ha reiniciado la migración a JAX-RPC sin revertir los cambios en el código, haga clic en Reiniciar de nuevo. Vuelva a la versión del código de la aplicación que existía antes de cambiar el flujo JAX-RPC mediante actualizaciones automáticas, manuales o ambas.
    Pendiente
    Si tiene una sección Pendiente con uno o más archivos .wsdl que aparecen en la lista, seleccione la sección.
    Seleccione cada uno de los archivos .wsdl y complete el siguiente trabajo asociado a él.
    1. Ejecutar automatizaciones.
      Cuando se ejecutan automatizaciones, se realizan las siguientes acciones.
      • La aplicación se modifica para migrar los servicios JAX-RPC a los servicios JAX-WS .
      • La sección Actualizaciones manuales contiene instrucciones y enlaces para que pueda actualizar manualmente determinados archivos de Java .
      • La sección Revisar archivos recién generados se llena con nuevos Java partes que las recetas crearon.
    2. Completa las actualizaciones manuales de los archivos Java especificados.
    3. Revise los archivos recién generados.
    4. Compilar manualmente la aplicación.
    Completado
    Seleccione la sección.

    Se muestra una lista de los archivos .wsdl completados y la lista se actualiza automáticamente.

    No compatible (requiere migración manual)
    Seleccione la sección.
    Si los archivos de .wsdl tienen características que el asistente de migración de fuentes de JAX-RPC no admite, los archivos se marcan como no admitidos. También puede marcar los archivos .wsdl como no compatibles si ejecuta las automatizaciones para ellos y fallan.
    • Si el asistente de migración de origen ha añadido un archivo .wsdl a no compatible, migre manualmente los servicios JAX-RPC en el archivo .wsdl .

      El asistente para la migración de fuentes añade un archivo .wsdl a la sección de archivos no compatibles cuando el archivo .wsdl contiene funciones no compatibles

    • Si ha marcado un archivo .wsdl como no compatible, puede migrar manualmente los servicios JAX-RPC en el archivo .wsdl . También puede reiniciar la migración de los servicios JAX-RPC para ejecutar las automatizaciones del archivo .wsdl .
    No utilizado (seguro de eliminar)
    Seleccione la sección para ver sus archivos .wsdl no utilizados.

    Puede eliminar los archivos, ya que no se utilizan en la aplicación.

    Después de completar todas las correcciones para los archivos .wsdl , lo que significa que el indicador Total WSDLs necesita ser corregido es 0, la migración JAX-RPC está completa para las partes en las que el JAX-RPC source migration helper puede ayudarle.

    Recuerde: Antes de hacer clic en el botón Construir y analizar que se muestra, migre manualmente los archivos .wsdl de la sección no compatible para completar la migración a los servicios JAX-WS .
  2. Haga clic en Construir y analizar.

    La aplicación que ha migrado a los servicios JAX-WS se vuelve a analizar para detectar cualquier problema de modernización pendiente.

  3. Solucionar problemas con la aplicación.

    Para las compilaciones de Maven, dependiendo de los problemas a solucionar, la capacidad de solucionarlos puede ser automatizada o autodirigida.

    Para las compilaciones que no utilizan Maven, los problemas a solucionar son autodirigidos.

    Las incidencias de la pestaña Información adicional no requieren un cambio de código, pero es posible que tenga que verificarlas o probarlas y realizar un cambio de código si lo desea.

Solución de problemas y revisión de información adicional para su solicitud

Dependiendo de los problemas que haya que solucionar, la capacidad para solucionarlos puede ser automática o autodirigida. Las incidencias de la pestaña Información adicional no requieren un cambio de código, pero es posible que tenga que verificarlas o probarlas y realizar un cambio de código si lo desea.

La página Modernizar <nombre de su aplicación> muestra la siguiente información:

  • El servidor de aplicaciones de origen y el servidor de aplicaciones de destino
  • El origen de la versión Java SE y el destino de la versión Java SE
  • Enlaces a un informe tecnológico, un informe de inventario y un informe de análisis
  • Pestañas para los problemas que hay que solucionar, que pueden ser correcciones automatizadas o autodirigidas, e información adicional.

El kit de desarrollo de destino Java es necesario cuando se ejecutan correcciones automatizadas y cuando se compila la aplicación después de realizar los cambios de destino de la versión Java . Asegúrese de que el kit de desarrollo Java está configurado para su IDE.

  • Los plug-ins para Eclipse IDE y el IDE IntelliJ intentan encontrar automáticamente el kit de desarrollo Java correcto. El kit de desarrollo Java debe coincidir con el objetivo de la versión Java del conjunto de todos los kits de desarrollo Java configurados en los IDE.
  • En el IDE Visual Studio Code , debe cambiar manualmente la configuración del kit de desarrollo Java .
Finalización de las correcciones automáticas de las compilaciones de Maven

Si tiene una pestaña Correcciones automáticas con una o varias correcciones, seleccione la pestaña.

Dado que Application Modernization Accelerator Developer Tools realiza las correcciones por usted, no necesita realizar ningún cambio en el código.

  1. Amplía las instrucciones y léelas.
  2. Si lo desea, abra la incidencia para revisar su descripción.
  3. Haga clic en Ejecutar correcciones automáticas.
    • Las correcciones automatizadas están arregladas.
    • Las incidencias externas permanecen en la lista hasta que se actualiza la dependencia asociada.
  4. Cuando finalice la ejecución de correcciones automáticas, haga clic en Reconstruir y actualizar para actualizar la lista de incidencias.
Importante: Si las correcciones automáticas no se ejecutan y producen errores de compilación en la salida de la consola, asegúrese de actualizar la versión del complemento maven-compiler a 3.13.0 o una versión más reciente.
Realización de correcciones autodirigidas

Si tiene una pestaña Correcciones autodirigidas con una o varias correcciones, seleccione la pestaña.

Cambia el código y determina cómo arreglarlo.

  1. Amplíe las Instrucciones y siga las instrucciones.
  2. Amplíe cada número.
  3. Haga clic en Leer más para ampliar el tema.
  4. Haga clic en el archivo que aparece en la edición. El archivo se abre en el editor.
  5. A medida que solucione los problemas, haga clic en Reconstruir y actualice hasta que se hayan solucionado todas las correcciones autodirigidas.
Consejo: Para ciertas correcciones autodirigidas, es posible que puedas utilizar las capacidades generativas de IA en watsonx Code Assistant™ for Enterprise Java Applications.
Información adicional

Si tiene una pestaña Información adicional con un número de uno o más en ella, seleccione la pestaña.

Los asuntos que aparecen en la pestaña se determinan del mismo modo que los asuntos de otras pestañas. Aunque los problemas de información adicional no requieren un cambio en su código, revise los problemas para asegurarse de que su aplicación funcione cuando se migre su código.

La información adicional podría indicar problemas, como pequeños cambios de comportamiento en una API, o problemas de conectividad en bases de datos o registros de usuarios, y qué hacer al respecto.

Por ejemplo, tienes una base de datos a la que se conecta tu aplicación. Usted leyó la edición para esta situación. A continuación, asegúrese de que el host y el puerto configurados para la aplicación sean válidos y accesibles cuando se migre la aplicación.

  • Amplía las instrucciones y síguelas.

  • Haga clic en cada número.

    • Haga clic en Leer más para ampliar el tema.
    • Haga clic en el enlace del archivo que aparece en la edición para revisar el código.
Trabajar en cuestiones externas a la aplicación actual

Mientras trabaja en las correcciones, algunas podrían clasificarse como incidencias externas a la aplicación actual. El código fuente de estos problemas se encuentra en archivos específicos que no forman parte de la aplicación fuente actual.

Si el archivo es una biblioteca propiedad de su organización, siga estos pasos.

  1. Abra su código fuente asociado como una aplicación independiente y utilice Application Modernization Accelerator Developer Tools para solucionar los problemas que se produzcan.
  2. Actualice su aplicación actual para utilizar la nueva versión corregida.

Si el archivo es una biblioteca que no pertenece a su organización, complete el siguiente paso.

  • Actualice a una versión que no contenga este problema.

    Si no existe tal versión, es posible que tenga que utilizar una tecnología diferente.